游戏更新

由于不同发行版本对更新唤起功能的支持不同，Combo SDK 统一对游戏更新功能进行了处理。

游戏方按本文档进行接入后，即可完成针对所有发行版本和投放分包的游戏更新。

目前只支持 Android 系统的游戏更新功能。

信息

拓展阅读：

• TapTap 更新唤起
• 华为 游戏升级

使用发行版本自有更新唤起功能

警告

调用此方法前需要先调用 IsFeatureAvailable()，检查 UpdateGame() 是否可用。

方法签名

public static void UpdateGame(Action<Result<UpdateGameResult>> callback);

代码示例

Show Code

if (ComboSDK.IsFeatureAvailable(Feature.UPDATE_GAME))
{
    // feature available
    ComboSDK.UpdateGame( r =>
    {
        if (r.IsSuccess)
        {
            // 更新游戏成功
        }
        else
        {
            var error = r.Error;
            Debug.LogError("更新游戏失败：" + error.DetailMessage);
            // 游戏可进行兜底处理
        }
    });
}
else
{
    // 更新游戏功能不可用，游戏可自行实现更新游戏逻辑
}

方法参数

Parameter	Required	Type	Description
callback	True	Action<Result<UpdateGameResult>>	更新游戏回调方法，用于接收更新游戏接口回调结果

UpdateGameResult

Properties	Supported Platforms	Type	Description

下载链接

针对不支持更新唤起的发行版本（即 UpdateGame() 不可用时），可调用 GetDownloadUrl() 方法，获得该发行版本或发行版本分包对应的下载地址，游戏方自行实现更新唤起弹窗，引导用户进行游戏更新。

信息

该下载地址可能为商店的固定下载页面地址或将游戏产物上传至商店后台后返回的 APK 下载地址。

方法签名

public static void GetDownloadUrl(Action<Result<DownloadUrlResult>> callback);

代码示例

Show Code

if (ComboSDK.IsFeatureAvailable(Feature.UPDATE_GAME))
{
    ComboSDK.UpdateGame( r =>
    {
        if (r.IsSuccess)
        {
            // 更新游戏成功
        }
        else
        {
            var error = r.Error;
            Debug.LogError("更新游戏失败：" + error.DetailMessage);
            // 游戏可进行兜底处理
        }
    });
}
else
{
    ComboSDK.GetDownloadUrl( r => 
    {
        if(r.IsSuccess)
        {
            var result = r.Data;
            var downloadUrl = result.downloadUrl;
            // 游戏方自行实现更新唤起弹窗，引导用户进行游戏更新
        }
        else 
        {
            var error = r.Error;
            Debug.LogError("获取 Download Url 失败: " + error.Message);
            // 游戏可进行兜底处理
        }
    });
}

方法参数

Parameter	Required	Type	Description
callback	True	Action<Result<DownloadUrlResult>>	获取下载地址回调方法，用于接收下载地址并进行处理

DownloadUrlResult

Properties	Supported Platforms	Type	Description
downloadUrl		string	发行版本或发行版本分包对应的下载地址