# 桌面快捷方式
# 能力介绍
平台推荐开发者接入「添加至桌面」功能，引导用户将游戏添加至桌面，便于用户后续可直接从桌面快捷方式快速访问小游戏，简化复访路径，提升用户留存率。
适配宿主： 快手、快手极速版
适配操作系统： iOS、安卓均可
适配宿主版本： iOS无限制；安卓 >= 12.2.20为桌面快捷方式，< 12.2.20为apk形式
# 产品形态
游戏主页设计并显示「添加桌面」ICON---用户点击ICON后，发起添加桌面请求
● 若用户未开启允许在app内添加桌面权限，提示尝试添加弹窗并支持一键跳转至设置模块开启权限；
● 若用户已开启创建快捷方式权限，提示确定添加面板，点击添加创建成功
# 接口说明
- 将小游戏快捷方式添加到手机桌面 ks.addShortcut
- 检查小游戏快捷方式是否已添加到手机桌面上 ks.checkShortcut
- 判断小游戏是否从桌面快捷方式启动 ks.isLaunchFromShortcut
- 桌面快捷方式定制化悬浮窗接入 接入指南
- 桌面快捷方式定制化下载弹窗接入 接入指南
# 技术方案流程
方案一：仅针对未将游戏添加至桌面的用户展示「添加桌面」按钮引导
步骤一：调用 ks.checkShortcut判断当前用户是否已将小游戏添加至桌面来决定是否展示「添加桌面」ICON
步骤二：针对未将游戏添加桌面的用户展示「添加桌面」ICON，用户点击按钮调用ks.addShortcut，添加桌面成功。
步骤三：回调成功即可隐藏「添加桌面」ICON。
方案二：针对所有用户均展示「添加桌面」按钮引导
步骤一：针对所有用户展示「添加桌面」ICON，用户点击按钮调用ks.addShortcut，添加桌面成功。
步骤二：回调成功即可隐藏「添加桌面」ICON。
tips：开发者可自主选择方案一或者方案二，为保证用户体验，减少对用户的打扰，建议开发者使用方案一 在用户每次进入游戏时增加判断用户是否已添加至桌面，若用户已添加，则不再在游戏内展示添加桌面引导按钮。
# 设计建议
游戏需要根据本游戏整体风格及定位，设计相关图片素材，包括不限于按钮icon、文案、以及点击按钮后是否配置相关奖励发放用户。
● 按钮文案建议： 文案需直观，方便用户理解，建议「添加桌面」「添加桌面有奖」
● 按钮设计样式建议：
1）建议设计成动态图标，吸引用户点击；
2）建议放置于小游戏主页面显眼位置
3）点击按钮建议配置相关礼包奖励，提升用户点击率
● 礼包下发频次建议： 可以按用户维度（每人仅限领取一次）或者时间维度（1天/次）控制