启动云游戏
接口介绍
public boolean startCloudApp(final Activity activity, final Map<String, String> params);
功能描述
开启云游戏,从当前Activity跳转到游戏Activity。
参数介绍
@param {Activity} activity:进入游戏界面的activity
@param {Map} params:启动相关配置,具体如下:
参数 |
是否必选 |
参数类型 |
描述 |
约束 |
---|---|---|---|---|
ip |
是 |
String |
接入游戏使用ip地址,即云手游服务器的EIP。 可以通过“查询云手机详情”API获取,即响应消息中“public_ip”参数的取值。 |
非空 |
port |
是 |
String |
接入游戏使用的端口 可以通过“查询云手机详情”API获取,即响应消息中“access_port”参数的取值。 |
非空 |
package_name |
是 |
String |
要启动的游戏包名 |
非空 |
launcher_activity |
是 |
String |
要启动的游戏启动页名 |
非空 说明:20.6.0版本之后可以为空 |
app_id |
是 |
String |
云游戏唯一id |
32位长度 |
session_id |
是 |
String |
用户本次接入游戏的会话id |
32位长度 |
game_timeout |
是 |
String |
用户玩游戏时home的时长,单位是秒 |
非空 |
available_playtime |
是 |
String |
用户可以玩游戏的时长,单位是秒 |
大于等于0 0表示不启用该功能。 |
ticket |
是 |
String |
256位随机数 |
非空 |
aes_key |
是 |
String |
对称密钥,32位16进制字符串 |
32位长度 |
auth_ts |
是 |
String |
验签使用的时间戳 |
非空 |
token |
是 |
String |
玩家登录云端游戏的账号信息 |
非空 |
touch_timeout |
否 |
String |
无操作超时的时长,单位是秒 说明:20.6.0版本新增此参数 |
大于等于0 0表示不开启该功能 说明:20.6.0版本约束为大于等于120 |
user_id |
否 |
String |
备用参数 说明:20.6.0版本新增此参数 |
- |
调用示例
以启动王者荣耀为例:
final HashMap<String, String > params = new HashMap<String, String>(); String sessionId = UUID.randomUUID().toString().replaceAll("-",""); params.put("ip", "117.3.111.4"); params.put("port", "12345"); params.put("package_name", "com.tencent.tmgp.sgame"); params.put("launcher_activity", "com.tencent.tmgp.sgame.SGameActivity"); params.put("app_id", "123e7654e89b12d3a412345655440000"); params.put("session_id", sessionId); params.put("game_timeout", "60"); params.put("available_playtime", "6000"); params.put("ticket", "123e7654e89b12d3a412345655440000123e7654e89b12d3a412345655440000123e7654e89b12d3a412345655440000123e7654e89b12d3a412345655440000123e7654e89b12d3a412345655440000123e7654e89b12d3a412345655440000123e7654e89b12d3a412345655440000123e7654e89b12d3a412345655440000"); params.put("aes_key", "36728337b89f22122af4a6e08bb1e7c0"); params.put("auth_ts", "1586922142623"); params.put("token", "user_token"); CloudAppManager.defaultManager().startCloudApp(GameActivity.this, params);
