游戏联运

Combo SDK 内部集成很多联运游戏发行方，部分发行方会有一些必须接入的 API。

• bilibili
• 4399

信息

游戏客户端统一调用 Combo SDK 的 API 既可，不需要自行判断发行方。

Combo SDK 内部只会对有合规要求的发行方调用它们的 API。

上报创建角色

提示

• 这个方法需要在用户创建角色成功时调用 (bilibili 审核要求)
• 4399 要求 serverId 不能为 0

支持平台

方法签名

public static void ReportCreateRole(RoleInfo roleInfo);

代码示例

Show Code

ComboSDK.ReportCreateRole(new RoleInfo {
    roleCreateTime = 1708928214,
    roleId = "10001",
    roleLevel = 1,
    roleName = "测试01",
    serverId = "1",
    serverName = "mock-server-name-01"
});

方法参数

Parameters	Required	Type	Description
RoleInfo	True	RoleInfo	玩家角色信息

RoleInfo

Properties	Type	Description
roleId	string	游戏角色 Id
roleName	string	游戏角色的名称 长度不超过 64
roleLevel	int	游戏角色等级
roleCreateTime	long	游戏角色的创建时间 unix timestamp
serverId	string	游戏服务器 Id 长度不超过 10 位的整数字符串
serverName	string	游戏服务器名称

上报进入游戏

提示

请在用户登录并选择角色后调用，配合一次登录只能调用一次，不能多次调用 (bilibili、4399 审核要求)

支持平台

方法签名

public static void ReportEnterGame(RoleInfo roleInfo);

代码示例

Show Code

ComboSDK.ReportEnterGame(new RoleInfo {
    roleCreateTime = 1708928214,
    roleId = "10001",
    roleLevel = 1,
    roleName = "测试01",
    serverId = "1",
    serverName = "mock-server-name-01"
});

方法参数

Parameters	Required	Type	Description
RoleInfo	True	RoleInfo	玩家角色信息

退出游戏

警告

• 审核要求 (xiaomi、vivo、oppo、4399、uc)
• 推荐监听 back of android phone
• 需要先调用 ComboSDK.IsFeatureAvailable，检查 Quit 是否有效，如果无效则使用自己的退出弹窗

支持平台

方法签名

public static void Quit(Action<Result<QuitResult>> callback);

代码示例

Show Code

if (ComboSDK.IsFeatureAvailable(Feature.QUIT))
{
    ComboSDK.Quit(r =>
    {
        if (r.IsSuccess)
        {
            Application.Quit();
        }
        else
        {
            var error = r.Error;
            Debug.LogError("退出游戏失败：" + error.DetailMessage);
        }
    });
}
else
{
    // Combo SDK 退出游戏功能不可用，游戏可自行实现退出游戏相关逻辑
}