【必接】桌面快捷方式能力

本指引旨在帮助小游戏开发者接入 B站小游戏平台的 桌面快捷方式功能，实现用户添加快捷方式并通过该方式进入游戏后领取奖励的能力。

接入目标

• 引导用户将小游戏添加到手机桌面
• 监听是否通过桌面快捷方式进入游戏
• 发放对应签到礼包（每日可领）

接入流程示意图

✨ 一、添加桌面快捷方式

✅ 使用 bl.addShortcut 接口

bl.addShortcut({
  success() {
    console.log("添加桌面成功");
    // 可提示用户：添加成功，明天从桌面进入可领取礼包哦~
  },
  fail(err) {
    console.log("添加桌面失败", err.errMsg);
  }
});

✅ 成功回调说明：

❌ 失败回调说明：

🔍 二、监听是否通过桌面快捷方式进入

✅ 使用 bl.onShow 获取场景值判断是否来源于桌面

bl.onShow((res) => {
  console.log("小游戏回到前台", res);

  if (res.scene === '10002') {
    console.log("通过桌面快捷方式进入");

    // 发放奖励逻辑
    giveDesktopGift();
  }
});

✅ 常见场景值说明：

三、发放奖励示例

function giveDesktopGift() {
  // 示例奖励逻辑，可调用后端接口或发放道具
  console.log("发放桌面进入奖励");

  bl.showToast({
    title: "欢迎回来，签到奖励已领取！",
    icon: "success"
  });

  // 示例接口调用
  // request.post('/api/give-gift', { type: 'desktopEntry' });
}

四、注意事项与最佳实践

• 本流程与 bl.checkShortcut 无任何关联！
• 每次从桌面入口进入时都可以触发领奖逻辑，请确保奖励逻辑具备幂等性或每日限制。
• 建议添加快捷方式后引导用户次日从桌面进入领取奖励，提高次留率。
• 可通过埋点统计“添加成功率”与“桌面进入率”以优化引导策略。

五、优秀案例

步骤	描述	截图
1	添加桌面快捷方式入口
2	引导用户添加桌面快捷方式
3	用户添加到桌面后，并从桌面进入游戏，提示用户可领取奖励
4	用户领取奖励后，提示已领取

✅ 总结

• 使用 bl.addShortcut 添加桌面快捷方式。
• 使用 bl.onShow 监听 scene === 10002 识别是否是桌面入口。
• 触发奖励发放逻辑。
• 无需调用 bl.checkShortcut 进行检测。

如有更多问题，请联系平台技术支持或查阅官方文档。