Bot API 8.0 更新概述
Bot API 8.0 为 Mini Apps 引入了十个强大的新功能,包括全屏模式、从主屏幕快捷方式启动、提供订阅计划等等。有关详细信息,请查看 Mini App 文档。
Stars 订阅
现在,Bots 支持由 Telegram Stars 提供的付费订阅,允许通过多级内容和功能进行创收。
在 createInvoiceLink
方法中添加了 subscription_period
参数,以支持定期计费链接的创建。
在 createInvoiceLink
方法中添加了 business_connection_id
参数,以支持代表商业账户创建发票链接。
在 SuccessfulPayment
类中添加了 subscription_expiration_date
、is_recurring
和 is_first_recurring
字段。
添加了 editUserStarSubscription
方法。
在 TransactionPartnerUser
类中添加了 subscription_period
字段。
全屏模式
Mini Apps 现在可以在横屏和竖屏模式下全屏显示,支持更多游戏、宽屏媒体和沉浸式用户体验。
在 WebApp
类中添加了 requestFullscreen
和 exitFullscreen
方法,以切换全屏模式。
在 WebApp
类中添加了 safeAreaInset
和 contentSafeAreaInset
字段,以确保 Mini Apps 的内容正确尊重设备的安全区域边距。
进一步添加了 isActive
和 isFullscreen
字段。
为 Mini Apps 添加了事件 activated
、deactivated
、safeAreaChanged
、contentSafeAreaChanged
、fullscreenChanged
和 fullscreenFailed
。
主屏幕快捷方式
Mini Apps 现在可以通过直接快捷方式访问,用户可将其添加到移动设备的主屏幕。
在 WebApp
类中添加了 addToHomeScreen
方法,以便用户创建快捷方式。
在 WebApp
类中添加了 checkHomeScreenStatus
方法,以确定当前设备对 Mini App 主屏幕快捷方式的支持状态。
为 Mini Apps 添加了事件 homeScreenAdded
和 homeScreenChecked
。
表情符号状态
Mini Apps 现在可以提示用户设置表情符号状态,或请求访问以便稍后自动同步到游戏徽章、第三方 API 等。
在 WebApp
类中添加了 setUserEmojiStatus
方法,用户必须允许机器人管理他们的表情符号状态。
在 WebApp
类中添加了 setEmojiStatus
方法,允许用户通过本地对话框手动确认自定义表情符号作为新状态。
在 WebApp
类中添加了 requestEmojiStatusAccess
方法,以获取权限,以便稍后通过 Bot API 方法 setUserEmojiStatus
更新用户的表情符号状态。
为 Mini Apps 添加了事件 emojiStatusSet
、emojiStatusFailed
和 emojiStatusAccessRequested
。
媒体共享与文件下载
用户现在可以直接从 Mini Apps 分享媒体,发送推荐码、自定义表情包、艺术作品等到任何聊天或作为故事发布。
添加了类 PreparedInlineMessage
和方法 savePreparedInlineMessage
,允许机器人建议用户通过 shareMessage
方法发送特定消息。
在 WebApp
类中添加了 shareMessage
方法,以从 Mini Apps 分享媒体到 Telegram 聊天。
在 WebApp
类中添加了 downloadFile
方法,引入了一个原生弹出窗口,提示用户从 Mini App 下载文件。
为 Mini Apps 添加了事件 shareMessageSent
、shareMessageFailed
和 fileDownloadRequested
。
地理位置访问
Mini Apps 现在可以请求用户的地理位置访问,允许它们构建几乎任何基于位置的服务,从动态兴趣点的游戏到事件的互动地图。
在 WebApp
类中添加了 LocationManager
字段。
为 Mini Apps 添加了事件 locationManagerUpdated
和 locationRequested
。
设备运动追踪
Mini Apps 现在可以跟踪详细的设备运动数据,允许它们实现更好的生产力工具、沉浸式 VR 体验等。
在 WebApp
类中添加了 isOrientationLocked
、Accelerometer
、DeviceOrientation
和 Gyroscope
字段。
在 WebApp
类中添加了 lockOrientation
和 unlockOrientation
方法,以控制屏幕方向。
为 Mini Apps 添加了事件 accelerometerStarted
、accelerometerStopped
、accelerometerChanged
、accelerometerFailed
、deviceOrientationStarted
、deviceOrientationStopped
、deviceOrientationChanged
、deviceOrientationFailed
、gyroscopeStarted
、gyroscopeStopped
、gyroscopeChanged
和 gyroscopeFailed
。
礼物
机器人现在可以向用户发送付费礼物以兑换 Telegram Stars。
添加了类 Gift
和 Gifts
以及方法 getAvailableGifts
,允许机器人获取所有可发送的礼物。
添加了方法 sendGift
,允许机器人向用户发送礼物。
在 TransactionPartnerUser
类中添加了 gift
字段。
加载屏幕自定义
硬件特定优化
一般信息
在 WebAppUser
类中添加了 photo_url
字段,允许 Mini Apps 在用户的隐私设置允许的情况下访问用户的头像。
接收或处理 Mini Apps 数据的第三方(如 Mini App 构建者)现在可以在不知晓应用程序的机器人令牌的情况下验证数据。
调试选项已扩展,以全面支持 iOS 设备。您可以使用这些工具发现 Mini App 中的特定应用问题。
⚠️ 注意! ⚠️
自 2024 年 12 月 1 日起,发送、复制或转发到具有足够大受众的群组和频道的视频消息可能会被服务器自动调度,直到相应的视频重新编码。这些消息的消息标识符将为 0,且在实际发送之前无法使用。