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

riyad

未分类​readTextFromClipboard​

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

1. import { readTextFromClipboard } from '@telegram-apps/sdk';
   
2. 
   
3. if (readTextFromClipboard.isSupported()) {
   2 ~" o3 u" [- a9 u0 Z' R( j! p
4.   const contents = await readTextFromClipboard(); // string | null
   
5. }

复制代码

shareStory​

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

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

1. import { shareStory } from '@telegram-apps/sdk';
   7 [; X7 {5 o2 @3 U
2. 
   
3. if (shareStory.isSupported()) {
   
4.   shareStory('https://my.media/background.png');
   % s, W! I: g& t0 r' J- L% G% R
5. }

复制代码

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

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

: S  m/ b7 o. m; d: h

1. shareStory('https://my.media/background.png', {
   4 _- D+ {' d, E
2.   text: 'Today was a good day. Love it! Thanks to this public!',
   / _: d4 M8 h( |) u6 L
3.   widgetLink: {
   
4.     url: 'https://t.me/heyqbnk',
   
5.     name: 'heyqbnk public group',
     V$ ?3 q2 Z/ h4 T  S2 w
6.   },
     @( I6 N& p$ _- X
7. });

复制代码

sendData​

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

1. import { sendData } from '@telegram-apps/sdk';
   , n8 \8 o) J  s" u% b% A
2. 
   " U3 |  a- S" q; R9 Q' o
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()) {
   
4.   await switchInlineQuery('Check this bot!', [
   
5.     'users',
   
6.     'bots',
   
7.     'groups',
   
8.     'channels',
   
9.   ]);
   8 A2 U4 K$ [5 Y( h
10. }

复制代码

) N, u8 G) l4 l. T; y* b; L

! X% A' D- I5 _% Q3 ]