您尚未登录

登录

您尚未登录

登录

推荐您使用PC浏览器访问

确定
  • 开发者中心
  • >
  • 云游戏
  • >
  • SDK参考手册
  • >
  • H5
  • >
  • v3.3.1

1 H5 SDK 参考手册

1.1 Cloudplay对象

方法 描述 方法 描述
initSDK 初始化SDK startGame 启动游戏
stopGame 停止游戏 enableAudio 音频播放
getCid 获取本次云游戏的cid bringUpApp 将游戏切换成前台
enterQueue 进入排队 outQueue 退出排队
getNetInfo 获取网络请求数据接口 getGameArchiveStatus 获取游戏的存档状态
gameArchived 游戏是否存在存档 checkPlayingGame 检测进行中的游戏
getCloudPlayStatusCode 获取云游戏状态码 reportFinishInfo 云游戏结束信息上报接口
sendMessage 发送消息到服务器

1.2 initSDK

调用方法

Cloudplay.initSDK({
    accessKeyID: '',
    channelId: '',
    onSceneChanged: function(sceneId, extraInfo) {
        console.log('sceneId:'+sceneId,extraInfo);
        if(sceneId == 'play') {
            alert('游戏开始了');
        }
    },
    MessageHandler: function(message) {
        console.log('got message:',message);
    }
});

参数说明

参数 类型 必选 说明
accessKeyID string 接入商唯一ID
channelId string 接入方自行定义,主要方便接入方推广需要,如一个APK,发布到不同的推广平台时用不同channelId
onSceneChanged function 场景切换回调函数:参考本文档中的“onSceneChanged回调函数说明”
MessageHandler function 支付消息的回调函数:参考本文档中的“MessageHandler回调函数说明”

onSceneChanged回调函数说明

sceneId sceneId说明 extraInfo类型 extraInfo属性名 extraInfo属性说明
init 初始化中 null
play 开始游戏 null
stop 游戏结束 object interval 本次游戏时间,单位:秒
~ ~ ~ reason timeLimit:本次游戏时间已到
noOperation:无操作超时,默认20分钟,可联系运营人员修改配置
instanceError:云端实例出错
tokenExpire:Token过期失效
maintainServer:正在维护服务器
internalError:内部错误
instanceLimit:超过实例数的申请上限
queueLimit:排队人数过多,禁止排队
internal:主动停止游戏
tokenFailed:token鉴权失败
~ ~ ~ message 提示信息
maintain 服务器维护 object progress soon:维护进度即将开始
start:开始
~ ~ ~ time 时间,单位:秒
~ ~ ~ message 提示信息
timeout 游戏时间结束,但不结束游戏 object interval 本次游戏时间,单位:秒
~ ~ ~ message 提示信息
remainingTime 剩余游戏时间 object time 剩余可玩的游戏时间,单位:秒
~ ~ ~ countDown true:需要倒计时
false:不需要倒计时
wait 排队 object reason showQueueInfo:显示当前的排队信息
applyGame:排队完成,正在进入游戏
whetherToQueue:是否进入排队,如果进入排队调用Cloudplay.enterQueue(),否则调用Cloudplay.outQueue()
~ ~ ~ message 提示信息
~ ~ ~ waitingPeople 等待人数
~ ~ ~ waitingTime 预计等待时间,单位:秒
totalTime 本次可玩游戏时间 object time 单位:秒
~ ~ ~ message 提示信息
reconnectingStatus 重连状态提示 object message 提示信息
offline 断网提示 object message 提示信息
warning 出错提示 object message 提示信息
loadPlayer 加载播放器 object result true:成功
false:失败
qqup 云上调起了QQ应用 null
delay 画面延迟 object delay 当前画面的延时,单位:毫秒。
备注:只有使用WebRTC播放器时才有此参数
packetsLost 丢包率 object packetsLost 当前画面的丢包率,单位:%。
备注:只有使用WebRTC播放器时才有此参数

MessageHandler回调函数说明

参数名 类型 必选 说明
userId string 目标userId
from string 消息发送方标识
to string 消息接收方标识
mid string 消息ID
type int 消息类型:固定值为1
ack int 应答类型:固定值为0
payload string 消息内容

1.3 startGame

调用方法

Cloudplay.startGame('example', {
    userInfo: {
        uId: '',
        uToken: '',
        uType: 0
    },
    pkgName: '',
    appChannel: '1'
    cToken: '',
    isPortrait: false,
    priority: 0,
    configInfo: '',
    playingtime: 1200,
    streamType: '1',
    isArchive: true,
    cid: '',
    protoData: '',
    extraId: '',
});

参数说明

参数 类型 必选 说明
uId string 自行定义32位以内a-z,0-9字符串
uToken string 自行定义32位以内a-z,0-9字符串
uType int 默认传0
pkgName string 游戏包名称
appChannel string 游戏渠道号
cToken string 用来校验参数的有效性:生成算法详见本文档的cToken生成算法
isPortrait boolean 游戏的横竖屏属性:true为竖屏游戏;false为横屏游戏
priority int 申请游戏服务的优先级;默认设置为0;值越大优先级越高
configInfo string 免登录功能所需信息,如不使用,传任意非空字符串
playingtime int 用户可以玩的总游戏时间,单位:秒
streamType string 指定使用哪种 Streaming, 1:WebRTC, 0:H5Streaming
isArchive boolean 是否存档:默认为true;true存档;false不存档;
cid int 游戏的cid
protoData string 透传字段,服务器端状态同步接口透传使用
extraId string 预留字段,传空字符串

1.4 stopGame

调用方法

Cloudplay.stopGame();

1.5 enableAudio

调用方法

Cloudplay.enableAudio(enabled);

参数说明

参数 类型 必选 说明
enabled boolean 是否播放音频:true: 播放;false: 静音

1.6 getCid

调用方法

Cloudplay.getCid();

返回数据说明

属性 类型 说明
cid string 本次游戏的cid

1.7 bringUpApp

调用方法

Cloudplay.bringUpApp();

1.8 enterQueue

调用方法

Cloudplay.enterQueue();

1.9 outQueue

调用方法

Cloudplay.outQueue();

1.10 getNetInfo

调用方法

Cloudplay.getNetInfo();

返回数据说明

属性 说明
url 网络请求的url
time 请求耗时
result 请求结果。
msg 结果详细描述
uid 当前用户的uid
cid 当前云游的cid
action 请求的类型(长连接:access、input连接:input、视频流:videoUrl、音频流:audioUrl、action:actionId)。
transId 当前申请的唯一ID
packageName 请求的游戏包名。
startTime 开始请求的时间
responseTime 请求结束的时间。

1.11 getGameArchiveStatus

调用方法

Cloudplay.getGameArchiveStatus ({
    userInfo: {
        uId: '',
        uToken: '',
        uType: 0
    },
    pkgName: '',
    appChannel: '1'
    ifCanPlay:function(res) {
        // todo
    },
});

参数说明

参数 类型 必选 说明
uId string 自行定义32位以内a-z,0-9字符串
uToken string 自行定义32位以内a-z,0-9字符串
uType int 默认传0
pkgName string 游戏包名称
appChannel string 游戏渠道号
ifCanPlay function 回调函数

返回数据说明

属性 类型 说明
code int 0:获取信息成功, 1:获取信息失败
errorMessage string 报错信息
ifCanPlay boolen true: 可以进行游戏, false:不可进行游戏

1.12 gameArchived

调用方法

Cloudplay.gameArchived ({
    userInfo: {
        uId: '',
        uToken: '',
        uType: 0
    },
    pkgName: '',
    appChannel: '1'
    hasArchive:function(res) {
        // todo
    },
});

参数说明

参数 类型 必选 说明
uId string 自行定义32位以内a-z,0-9字符串
uToken string 自行定义32位以内a-z,0-9字符串
uType int 默认传0
pkgName string 游戏包名称
appChannel string 游戏渠道号
hasArchive function 回调函数

返回数据说明

属性 类型 说明
code int 0:获取信息成功, 1:获取信息失败
errorMessage string 报错信息
hasArchive boolen true: 有存档, false:没有存档

1.13 checkPlayingGame

调用方法

Cloudplay.checkPlayingGame ({
    userInfo: {
        uId: '',
        uToken: '',
        uType: 0
    },
    playingGame:function(res) {
        // todo
    },
});

参数说明

参数 类型 必选 说明
uId string 自行定义32位以内a-z,0-9字符串
uToken string 自行定义32位以内a-z,0-9字符串
uType int 默认传0
playingGame function 回调函数

返回数据说明

属性 类型 说明
code int 0:获取信息成功, 1:获取信息失败
errorMessage string 报错信息
playingGame array [{appChannel: “”, cid: “”, pkgName: “”}] 未释放游戏的appChannel、cid、pkgName信息。如果数组为空,则没有未释放的游戏

1.14 getCloudPlayStatusCode

调用方法

Cloudplay.getCloudPlayStatusCode ();

返回数据说明

属性 类型 说明
100999001 int 没流地址,cid未获取成功(初始状态)
100999002 int 没流地址,cid获取成功,Socket连接失败。
100999003 int 没流地址,cid获取成功,Socket连接成功,乒乓状态异常。
100999004 int 没流地址,cid获取成功,Socket连接成功,乒乓状态正常。
100999005 int 有流地址,video成功。
100999006 int 有流地址,video失败,audio成功。
100999007 int 有流地址,video失败,audio失败,input成功。
100999008 int 有流地址,video失败,audio失败,input失败。

1.15 reportFinishInfo

调用方法

Cloudplay.reportFinishInfo ({
    finishCode: 0,
    pkgName: '',
    appChannel: '',
    gameId: '',
    cid: '',
    sdkVersion: '',
});

参数说明

参数 类型 说明
finishCode string 结束状态 0:正常结束, 1:超时结束, 2:异常结束有SDK错误码,3:异常结束无SDk错误码。
pkgName string 云游戏包名
appChannel string 云游戏渠道号
gameId string 云游戏id号
cid string 云游戏cid
sdkVersion string SDK版本号

1.16 sendMessage

调用方法

Cloudplay.sendMessage(payload)

参数说明

参数名 类型 必选 说明
payload string 发送的数据信息
×

本篇文章对你是否有帮助?

更多建议

请输入您的建议