# QQ小游戏发送到PC引导

# QQ小游戏发送到PC引导接入

从基础库1.64.0开始支持
支持平台:Android、ios
客户端版本:仅手Q8.9.78及以上
支持类型:仅小游戏(该功能仅对部分游戏灰度,如需增加请先联系运营添加游戏appid白名单)

# 功能介绍

QQ小游戏的打开方式增加通过PC QQGAME公众号打开的入口;用户可通过PC QQGAME公众号将小游戏游玩入口从手机端发送至电脑端,例如通过游戏内活动或任务的形式进行引导,实现用户在PC端也能游玩到QQ小游戏

# 引导流程

步骤一:用户点击小游戏内相关跳转入口,该入口需要由游戏方开发者实现,可被包装成游戏内活动或者任务
步骤二:拉起弹窗,让用户确认是否需要将小游戏入口发送到电脑
步骤三:若入口发送成功,则弹出确认弹窗给予用户确认,并附上图文引导
步骤四:用户打开PCQQ将会收到来自PC QQGAME公众号消息
步骤五:用户点击对应公众号消息,将会先拉起畅玩2.0,拉起小游戏,并将拉起成功事件回调给开发者(平台已支持该部分能力)

PC QQgame公众号消息展示样式效果:

  • 标题:继续玩《游戏名称》,【自定义文案】;
  • 副标题:桌面版小游戏,畅享大屏体验
  • 跳转:统一打开小游戏 (其中自定义文案,图片素材由CP提供)

# 功能限制

发送频率:每个游戏每24小时内每个用户仅可使用一次。

发送限制:超频将无法发送。开发者可通过回调事件在游戏内实现”已发送“、”已成功从PC打开“的状态。

# 接口说明

qq.sendPCGuide(object object)

# 参数

Object object

属性名 类型 默认值 必填 说明
title string 公众号消息标题自定义文案 (e.g.继续玩《游戏名称》,[自定义文案])
imageUrl string 公众号消息背景图
success function 接口调用成功的回调函数
fail function 接口调用失败的回调函数
complete function 接口调用结束的回调函数(调用成功、失败都会执行)

# fail 返回参数

字段 类型 说明
errCode Int 错误码
errMsg String 错误信息,格式 uploadFile:fail msg

# 错误码

错误码 信息
0 发送成功
10000 当前游戏过程中已经发送过公众号消息
10001 用户取消发送