Telegram 小程序 | TypeScript @telegram-apps/sdk @1.x | 组件 | 实用工具

riyad

实用工具​

执行不需要状态且无法分类的功能。

初始化​

要初始化组件，请使用 initUtils 函数：

1. import { initUtils } from '@telegram-apps/sdk';
   . W& Q. f6 v, j
2. 
   ; ]- q( T1 T  g3 N0 o4 @
3. const utils = initUtils();

复制代码

链接​openLink​

MiniApp 类能够打开不同类型的链接。 例如，它可以使用 openLink 方法在不关闭当前 Mini App 的情况下在外部浏览器中打开链接 ：

1. utils.openLink('https://google.com');

复制代码

在可能的情况下，此方法还允许使用 Telegram 的 Instant View 打开链接：

1. utils.openLink('https://google.com', { tryInstantView: true });

复制代码

要尝试使用用户首选浏览器打开链接，请使用 tryBrowser 选项：

1. utils.openLink('https://google.com', { tryBrowser: true });

复制代码

openTelegramLink​

如果开发人员想打开与 Telegram 相关的链接（以 https://t.me 开头） ，可使用 openTelegramLink 方法。使用这种方法，Telegram 应用程序将自行处理此类链接：

1. utils.openTelegramLink('https://t.me/heyqbnk');

复制代码

shareURL​

共享 URL 是迷你应用程序中的一项常见功能。 要实现这一点，开发人员可以使用 shareURL 方法，该方法接受要共享的 URL 和可选文本，以附加到 URL 之后的消息 。

调用时，它会打开聊天选择器以共享 URL。

1. utils.shareURL('https://t.me/mybot/myapp', 'Look! Some cool app here!');

复制代码

WARNING

目前，还没有直接共享任何内容的本地方法。 因此，该方法利用了 openTelegramLink 方法，该方法在被调用后会关闭应用程序。 这种 方法在引擎盖下使用 Share links。

剪贴板​

开发人员可以使用 readTextFromClipboard 方法从剪贴板读取文本。

该方法从剪贴板读取文本，并返回字符串或空值。 情况下返回空值：

• 剪贴板中的值不是文本。
• 不允许访问剪贴板。
  / ]. O+ X2 N  M2 m( ^0 t: s5 L0 R

- o$ r! z3 \4 i) H- W( P( t8 g: g

1. utils.readTextFromClipboard().then((data) => {
   
2.   console.log('Clipboard data:', data);
   
3.   // Output: string or null
   6 M; t+ `" b( ]' H+ X; m
4. });

复制代码

方法支持​

方法和参数列表，可用于 支持检查：readTextFromClipboard 和 openLink.tryInstantView