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

riyad

未分类​readTextFromClipboard​

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

1. import { readTextFromClipboard } from '@telegram-apps/sdk';
   6 g/ b& \) Y: m0 q  w
2. 
   
3. if (readTextFromClipboard.isSupported()) {
   
4.   const contents = await readTextFromClipboard(); // string | null
   
5. }

复制代码

shareStory​

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

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

1. import { shareStory } from '@telegram-apps/sdk';
   
2. 
   ( w# ], ^& y6 f& _
3. if (shareStory.isSupported()) {
   2 m* n* `& Z2 b2 @" N* G' r: Z/ s! `6 y
4.   shareStory('https://my.media/background.png');
   
5. }

复制代码

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

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

5 m8 g2 F& S0 {+ \# h1 B

1. shareStory('https://my.media/background.png', {
   
2.   text: 'Today was a good day. Love it! Thanks to this public!',
   
3.   widgetLink: {
   " r1 z2 B% e2 N0 s% F) L0 Q
4.     url: 'https://t.me/heyqbnk',
   : |# v+ |, T5 Q3 c! m9 O
5.     name: 'heyqbnk public group',
   
6.   },
   
7. });

复制代码

sendData​

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

1. import { sendData } from '@telegram-apps/sdk';
   
2. 
   
3. sendData('my-data-goes-here');

复制代码

TIP

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

WARNING

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

switchInlineQuery​

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

1. import { switchInlineQuery } from '@telegram-apps/sdk';
   
2. 
   & B% ^8 w* }0 X& O% j
3. if (switchInlineQuery.isSupported()) {
   ! X1 [1 M4 [/ r  k! y
4.   await switchInlineQuery('Check this bot!', [
   
5.     'users',
   
6.     'bots',
   
7.     'groups',
   
8.     'channels',
   / L! u/ J3 l5 X% R: Q
9.   ]);
   
10. }

复制代码