Telegram 小程序 | TypeScript @telegram-apps/sdk @2.x | 工具 | 未分类

riyad

未分类​readTextFromClipboard​

要从剪贴板读取文本，请使用readTextFromClipboard函数。

1. import { readTextFromClipboard } from '@telegram-apps/sdk';
   
2. 
   
3. if (readTextFromClipboard.isSupported()) {
   , }' f$ u; h; F+ S' Q% E3 w
4.   const contents = await readTextFromClipboard(); // string | null
   2 {. G( l* G. y0 }0 P7 g- C
5. }

复制代码

shareStory​

shareStory 方法会打开本地故事编辑器。

它有一个必填参数：将用作故事背景的媒体 URL。

1. import { shareStory } from '@telegram-apps/sdk';
   
2. 
   3 s* t/ N6 ^7 r) Q" ~3 d; u: l
3. if (shareStory.isSupported()) {
   0 ~; t' }' b0 r5 e2 t
4.   shareStory('https://my.media/background.png');
   
5. }

复制代码

该函数可选择接受一个包含附加选项的对象：

• text?: string - 要添加到媒体中的标题，普通 用户的限制为 0-200 个字符，高级用户 的限制为 0-2048 个字符 。
• widgetLink?: object - 用于在故事中加入 widget 链接的对象。 只有 高级用户 才能发布带有链接的故事 。
  / k" g9 l3 y0 T' P, k, \! K. F
  • url: string - 要包含在故事中的 URL。
  • name?: string - widget 链接的显示名称（0-48 个字符）。
    

1. shareStory('https://my.media/background.png', {
   
2.   text: 'Today was a good day. Love it! Thanks to this public!',
   / d( F5 L& b: Y/ F
3.   widgetLink: {
   * F; ?! E9 y0 a+ I# n
4.     url: 'https://t.me/heyqbnk',
   
5.     name: 'heyqbnk public group',
   
6.   },
   
7. });

复制代码

sendData​

要向机器人发送数据，请使用 sendData 函数。 此功能将向 机器人发送服务消息，并关闭 Mini App。

1. import { sendData } from '@telegram-apps/sdk';
   % z: s* u' K" b( K  C2 Y
2. 
   
3. sendData('my-data-goes-here');

复制代码

TIP

该功能可向机器人发送多达 4096 字节的数据，适用于通过 键盘按钮启动的迷你应用程序。

WARNING

此功能仅适用于通过键盘按钮启动的迷你应用程序。 更多详情，请参阅 Message 类中的 web_app_data 字段 。

switchInlineQuery​

要创建以机器人用户名和特定文本为前缀的消息，并在另一个 聊天工具中共享，请使用 switchInlineQuery 方法。 您可以使用第二个可选参数来指定可以选择哪些 聊天类型来发送信息。

1. import { switchInlineQuery } from '@telegram-apps/sdk';
   
2. 
   
3. if (switchInlineQuery.isSupported()) {
   0 i, |" b# X- C. [- k! `- s, x4 ~3 d
4.   await switchInlineQuery('Check this bot!', [
   . X$ a# _3 Q) I, a3 T9 F
5.     'users',
   
6.     'bots',
   
7.     'groups',
   
8.     'channels',
   ( L& q7 }) e- Z/ ]" U# m0 o
9.   ]);
   3 q: g, q# V4 `6 X$ M& G! \0 c
10. }

复制代码

0 F: \. T( K6 w& k, C7 C: ~
. w8 U' R: V2 ?* @0 k" E