添加到桌面快捷方式

更新时间：2025/05/29 访问次数：67

一、能力介绍

旨在通过系统及厂商能力，允许用户将淘宝小游戏以1x1桌面快捷方式的形式，在手机系统桌面添加小游戏图标。用户点击桌面图标即可直接进入游戏，无需通过原平台启动，体验接近原生应用。

快捷方式在iOS端的添加链路更短，widget可展示内容量更多。开发者可根据自身情况，选择适合游戏内容的桌面触达方式。

场景	桌面组件Widget	桌面快捷方式
添加链路	安卓：一键添加 iOS：添加链路略长。在桌面手动添加淘宝2x2组件、点击组件选择场景【淘宝小游戏】	安卓：一键添加 iOS：添加链路更短。点击即唤起浏览器，选择添加到主屏幕
展示样式	2x2大小，支持透出权益、活动等拉高点击率的内容，支持透出具体行动点	1x1大小，透出游戏icon，不展示更多信息
高性能模式	普通模式支持，高性能模式下不支持	仅支持高性能模式，普通模式不支持

注意：如游戏接入了高性能模式，则只能接入桌面快捷方式，高性能模式下不支持添加widget。

第一步

第二步

第三步（仅iOS）

第四步（仅iOS）

第五步

主页设计回访活动ICON、或中新增回访任务

用户点击icon或任务后，教育用户添加桌面快捷入口

用户点击去添加，根据对应提示添加桌面快捷方式

添加成功，点击快捷方式，通过中间页自动跳换游戏

判断用户访问渠道，渠道为桌面快捷方式，发放奖励

具体接入链路请参考高性能模式，如果没有接入高性能模式，则无法接入桌面快捷方式。

可设计游戏主页回访icon、或在任务列表新增一条回访任务，通过奖励引导用户添加桌面快捷方式。用户点击icon或接取任务后，建议做初步的添加路径指引（分端）。

注意：活动透出前先判断用户环境是否支持桌面快捷方式，以免出现用户无法完成任务的舆情。

参考以下接口列表，具体接入参考接口文档内容

名称	类型	描述
checkShortcut	互动插件	检查当前环境是否支持添加桌面快捷方式、小游戏快捷方式是否已添加到手机桌面上
addShortcut	互动插件	将小游戏快捷方式添加到手机桌面上

const sdk = my.tb.getInteractiveSDK();
const tagInfo = sdk.getChannelTag();

const isFromShortcut = tagInfo?.extra?.raw === 'desktop_widget';

游戏上线前可通过 https://自己的预发地址?hdkf_from=widget ，由自己的预发地址拼接上?hdkf_from=widget 来mock widget回访链路，测试发奖。

关于此文档暂时还没有FAQ

有用(0) 我要提问