一、能力介绍

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

添加桌面快捷方式的核心优势是什么？

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

场景

桌面组件Widget

桌面快捷方式

添加链路

安卓：一键添加

iOS：添加链路略长。在桌面手动添加淘宝2x2组件、点击组件选择场景【淘宝小游戏】

安卓：一键添加

iOS：添加链路更短。点击即唤起浏览器，选择添加到主屏幕

展示样式

2x2大小，支持透出权益、活动等拉高点击率的内容，支持透出具体行动点

1x1大小，透出游戏icon，不展示更多信息

高性能模式

普通模式支持，高性能模式下不支持

仅支持高性能模式，普通模式不支持

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

二、应用实例

第一步

第二步

第三步（仅iOS）

第四步（仅iOS）

第五步

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

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

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

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

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

二、接入步骤

步骤1: 确认接入高性能模式

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

步骤2: 设计游戏内回访活动

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

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

步骤3: 完成技术接入

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

名称

类型

描述

checkShortcut

互动插件

检查当前环境是否支持添加桌面快捷方式、小游戏快捷方式是否已添加到手机桌面上

addShortcut

互动插件

将小游戏快捷方式添加到手机桌面上

步骤4: 判断访问渠道进行发奖

小游戏用户从快捷方式访问时，开发者可通过getChannelTag 获取用户访问渠道识别

const sdk = my.tb.getInteractiveSDK();

const tagInfo = sdk.getChannelTag();

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

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