小米已接入快游戏联盟（OVMR）标准，通过新标准进行导出。近期小米小游戏已经停止Cocos导出，为避免影响您的游戏正常打包，请尽快迁移至快游戏联盟标准。

• 新开发者：请直接按快联盟标准接入
• 存量开发者：请直接按快联盟标准打包，避免新版本无法导出

qg.getShortcut

基础信息说明

功能概述：获取全局桌面图标管理对象，通过该对象可查询桌面图标是否已创建，以及创建桌面图标。

参数说明

qg.getShortcut() 无需传入参数。

返回值说明

同步返回：Shortcut 对象实例（全局单例）。

Shortcut 对象方法

shortcut.hasInstalled(Object)
查询用户设备桌面是否已创建当前快游戏的快捷方式。

回调结果说明

• success(result)：查询成功时触发。result 为布尔值，true 表示已创建桌面图标，false 表示未创建。
• fail(err)：调用失败时触发，err 内通常包含 errMsg、errCode。
• complete()：调用流程结束都会执行。

shortcut.install(Object)
创建桌面图标，在用户设备桌面添加快游戏快捷方式。

回调结果说明

• success()：宿主完成创建流程，且图标创建成功时触发。
• fail(err)：调用失败、参数异常或用户取消/拒绝授权时触发，err 内通常包含 errMsg、errCode。
• complete()：调用流程结束都会执行。

失败错误码

示例代码

查询桌面图标状态并按需创建

const shortcut = qg.getShortcut()

shortcut.hasInstalled({
  success: function(res) {
    if (res) {
      // 已创建桌面图标，可提示"看视频复活"
      console.log('桌面图标已创建')
    } else {
      // 未创建，引导用户"保存桌面复活"
      shortcut.install({
        //自定义弹窗文案
        message: '添加到桌面，下次可快速启动游戏',
        success: function() {
          console.log('桌面图标创建成功')
        },
        fail: function(err) {
          if (err.errCode === 201) {
            // 用户拒绝创建，记录状态避免重复弹窗
            console.log('用户拒绝创建桌面图标')
          }
          console.error('创建桌面图标失败', err)
        },
        complete: () => {
          console.log('创建桌面图标操作结束')
        }
      })
    }
  },
  fail: function(err) {
    console.error('查询桌面图标状态失败', err)
  }
})

注意事项

• 弹窗文案支持自定义，每行最多 18 个字，最多显示 3 行，填写后请先进行预览，确认显示效果符合预期
• 请勿滥用接口，项目正式上线将进行审核，一经发现滥用行为，将予以驳回