短链接

游戏内通常需要内嵌打开一些外部运营网页，如俱乐部、运营活动、问卷调研地址等等，Combo SDK 提供了 OpenShortLink() API，可以通过 Combo SDK 内置的 WebView 打开一个短链接，而游戏侧无需关心具体的 URL 类型和具体内容，世游的运营人员将通过 Combo Console 来维护这些 URL。

在这些网页中，一般会需要游戏用户的信息用于实现特定功能，如在打开问卷调研时，传入用户区服、角色信息，用于填写问卷后的奖励发放。因此，游戏侧需要提供一些当前游戏 Session 的数据，例如游戏服务器 ID、角色 ID、角色名称等等。

提示

上述 URL 由世游运营在 Combo Console 配置
游戏客户端需要在用户界面提供访问这些 URL 的入口，用户点击时调用 OpenShortLink() 接口，并传入相应的 shortLink 值和必要的 gameData
shortLink 及其所必须包含的数据字段将由运营在具体需求中提供
请在登录成功后再调用 OpenShortLink() 接口

接入指南

支持平台

方法签名

public static void OpenShortLink(string shortLink, Dictionary<string, string> gameData, Action<Result<OpenShortLinkResult>> callback);

代码示例

Show Code

var shortLink = "xxx.club"; // 短链接
var gameData = new Dictionary<string, string>(){
    {"server_id", "1"}, // 游戏服务器 ID
    {"server_name", "测试服"} // 游戏服务器名称
    {"role_id", "123"}, // 游戏角色 ID
    {"role_name", "张三"}, // 游戏角色名称
    {"role_level","5"}, // 游戏角色等级
};
ComboSDK.OpenShortLink(shortLink, gameData, r =>{
    if (r.IsSuccess)
    {
        var result = r.Data;
    }
    else
    {
        var error = r.Error;
        Debug.LogError("打开短链接失败：" + error.DetailMessage);
    }
});

方法参数

Parameters	Required	Type	Description
shortLink	True	`string`	世游运营人员提供给游戏研发方的短链接
gameData	True	`Dictionary<string, string>`	游戏内数据信息
callback	True	`Action<Result<OpenShortLinkResult>>`	打开短链接后的回调方法，用于接收该 API 的结果

shortLink

shortLink 是世游运营人员提供给游戏研发方的短链接，用于在特定的游戏场景、游戏 UI 上打开世游用户运营向的 Web 页面。

gameData

gameData 需要包含哪些数据字段，取决于具体的 shortLink。常见的数据字段如下：

Parameters	Description
server_id	游戏服务器 ID
server_name	游戏服务器名称
role_id	游戏角色 ID
role_name	游戏角色名称
role_level	游戏角色等级

OpenShortLinkResult

Properties	Supported Platforms	Type	Description

Error

Error	Supported Platforms	Description
`INVALID_SHORT_LINK`		`shortLink` 不正确（如短链接不存在或已经禁用)
`INVALID_GAME_DATA`		`gameData` 不正确（如缺少 `shortLink` 所必需的数据字段）
`NETWORK_ERROR`		网络错误
`SERVER_ERROR`		服务端错误
`SYSTEM_ERROR`		系统错误

接入指南​

支持平台​

方法签名​

代码示例​

方法参数​

shortLink​

gameData​

OpenShortLinkResult​

Error​