快手游戏

# 定制化桌面快捷方式引导浮窗

# 介绍

快手小游戏支持平台级别的手机桌面快捷方式引导浮窗。开发者无需调用 ks.addShortcut 等接口触发添加快捷方式到桌面的逻辑，简化了开发者接入流程。添加到桌面引导浮窗是由 Native 原生组件实现，在屏幕上显示层级最高，可以拖拽，也可以吸附到屏幕边缘，并且具有呼吸灯的效果。

开发者需联系小游戏官方运营人员@胡绵伟 @于航 开通添加桌面引导浮窗功能。

# 支持版本

仅 Android 客户端支持，客户端最低版本为 10.1.10 ，低版本配置不会展示浮窗。开发者可以在低版本调用相关 API 实现添加桌面快捷方式功能。

# 默认样式

添加到桌面引导浮窗默认显示样式如下所示，包含 “添加到桌面” 文案及游戏的 icon 。采用默认样式无需开发者做任何配置，联系官方运营人员@胡绵伟 @于航 开通该功能即可。

# 自定义样式

自定义浮窗开发者只需往游戏包里面导入一张图片即可，图片尺寸为 144x144 像素。开发者可以自己设计炫酷的 UI 吸引玩家的注意。具体制作流程如下所示：

  1. 将游戏包导入到快手开发者工具后，在根目录创建名为 "ks-apk-floating-config.json" 的配置文件

  2. ks-apk-floating-config.json 文件中包含名为 "backgroundImg" 的 key ， value 为图片在当前包里面的路径。（注意：下面示例中路径仅供参考，自定义时请使用实际所在路径）

{
	"backgroundImg": "/assets/ksresources/ks_float_widget.png"
}

# 自定义图片素材建议

具有诱惑力的奖励刺激，并且采用炫酷的 UI 吸引注意，参考样式如下所示：

参考样式一：

参考样式二：