跳到主要内容

游戏联运

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

信息

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

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

上报创建角色​

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

支持平台​

Android HarmonyOS WebGL

方法签名​

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"
});

方法参数​

ParametersRequiredTypeDescription
RoleInfoTrueRoleInfo玩家角色信息

RoleInfo​

PropertiesTypeDescription
roleIdstring游戏角色 Id
roleNamestring游戏角色的名称
长度不超过 64
roleLevelint游戏角色等级
roleCreateTimelong游戏角色的创建时间
unix timestamp
serverIdstring游戏服务器 Id
长度不超过 10 位的整数字符串
serverNamestring游戏服务器名称

上报进入游戏​

提示

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

支持平台​

Android

方法签名​

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"
});

方法参数​

ParametersRequiredTypeDescription
RoleInfoTrueRoleInfo玩家角色信息

退出游戏​

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

支持平台​

Android

方法签名​

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 退出游戏功能不可用,游戏可自行实现退出游戏相关逻辑
}

QuitResult​

PropertiesSupported PlatformsTypeDescription

Error​

CodeSupported PlatformsDescription
THIRD_PARTY_ERRORAndroid
第三方 SDK 错误
UNKNOWN_ERRORAndroid
未知错误