Action 11:取得游戏连结
功能说明
- 此功能提供用户在登入系统时须使用的游戏连结。
- 游戏连结有效时间为 1 分钟。
- 游戏中「返回大厅」时另有 postMessage 通知,请参阅 附录 说明。
参数
参数 | 格式 | 强制 | 说明 |
---|---|---|---|
action | Integer | Y | 11 |
ts | Long | Y | 当前系统时间 |
uid | String(50) | Y | 玩家账号 |
lang | String | N | 语系 参照附录 语系代码 尚未支援该语系的游戏预设将以英文开启 |
gType | String(3) | N | 游戏类型 参照附录 游戏提供商 |
mType | String(5) | N | 机台类型若需直接进入游戏,需同时带入 mType 及 gType |
remark | String(100) | N | 备注 |
windowMode | String(1) | N | 1:使用 JDB 游戏大厅(默认值)若未带入 gType 及 mType,则直接到游戏大厅 若带入 gType 及 mType 时,直接进入游戏。 2:不使用 JDB 游戏大厅 gType 及 mType 为必填字段。 |
isAPP | Boolean | N | 是否为手机 APP 进入游戏 true:手机APP false:手机网页、计算机网页(默认值) |
lobbyURL | String(100) | N | 游戏大厅网址当 windowMode 为 2 时,此参数才会有作用。 当 lobbyURL 为空时,不显示大厅按钮。 在游戏商 HRG 中 url 必须使用 https。 游戏商 CreedRoomz、ZestPlay 不支援此功能。 |
mute | Integer | N | 默认音效开关 0:开启音效(默认值) 1:静音 |
cardGameGroup | String(5) | N | 棋牌游戏群组只限 a-z、A-Z、0-9 英文与数值组合(默认值 0) |
isShowDollarSign | Boolean | N | 是否显示币别符号 true:显示币别符号(默认值) false:不显示币别符号 |
activityIds | String Array | N | 活动识别代号列表如有需要请洽业务人员。 |
eventId | Long | N | 免费场次识别代号如果填入该字段,启动游戏时将直接跳转至免费场次模式。 请先创建免费场次 Action 72:创建免费场次 |
Example
{
"action": 11,
"ts": 1447490495704,
"uid": "testpl01",
"lang": "cn",
"gType": "0",
"mType": "8001",
"windowMode": "2",
"lobbyURL": "https://xxx.xxx.xxx/lobby.html",
"activityIds": ["1234", "5678"],
"eventId": 12345
}
返回结果
参数 | 格式 | 说明 |
---|---|---|
status | String(4) | 成功:0000 错误:参照附录 错误代码 |
err_text | String(255) | 错误讯息 |
path | String(255) | 登入URL |
操作范例
// Http Request
http://{API_Address}/apiRequest.do?dc=jb1&x=y1wayxScczy6ABfElfaVwb5CdfHxBN_JGtxyBSvpo
hLQakP8M2QSetJNojJBzvnrVChhq8YWWgBTdGeXFTH4vSNQQ66epf4NqYeQ6bJ15pvHctQjQevulv7GHqOifuju_gY0H54FfVdQc9D5tKh1AZ9KDh9dwcGSszZxU7JOOoHdYITlCO5LhvGmHxPBwZ
// Http Response (success)
{
"status":"0000",
"path":"https://xxx.xxx.xxx?x=Q0Y2NUZDNEFBODEzNUM5NURGRjc5QTUzRDk0RTlDRDUzNE
Q0MjhEOEMzMSSSSSURDODBCNzdCMEE2OTE3MzczRkE5RDNGQ0QzQjdFNTlBMjE4Njg5ND
M4RDREMEI1NkYzQjkxOEU5QTU0QTM5QTY1MEUyNjYzMDg1RkFBQTM1OUU3RTI2RTBGQU
EzMUI0MkQ4NEFBRjVDNkJFRkQzMzU1NzA5OUNDMkYxMzMyOThBNjhBRURCNzExREMzRjh
DNzA1N0VFNEIzMzhCNTFEQ0FDODVEODQ3NEFDNTE1MEE1NTMzODQ="
}
// Http Response (error)
{
"status":"9005",
"err_text":"Assertion(SAML) didn't pass the timestamp validation."
}
// 若游戏正在维护中,我方会回传:
{
"status": "9022",
"err_text": "Game is maintained. mType: 8001"
}