跳到主要内容

应用链接

Combo SDK 提供了对应用链接功能的支持：

通过这些机制，开发者可以实现如下功能：

  • 深度跳转（Deep Linking）：用户点击网页或其他应用中的链接时，可以直接跳转并打开 App 内的特定页面，而不是仅仅启动 App。
  • 统一的链接管理：同一个链接既可在浏览器中打开，也可以唤起已安装的 App，无需使用自定义 URI Scheme。
  • 增强安全性：App Links 和 Universal Links 及 App Linking 都基于 HTTPS 并通过验证机制确保链接只能被指定 App 处理，防止钓鱼攻击或恶意跳转。

Combo SDK 已封装并简化了相关配置流程，帮助开发者快速集成 App Links / Universal Links / App Linking 功能，无需深入了解各平台底层实现。

支持平台​

Android iOS HarmonyOS

使用 Unity 的 Deep Linking API 处理游戏被 Deep Link 唤起时的回调。

使用 Unity 的 Deep Linking API 处理游戏被 Deep Link 唤起时的回调。

使用 Combo SDK 的 API OnDeepLinkActivated 来处理游戏被 Deep Link 唤起时的回调。

提示
  • 游戏需要尽早调用 OnDeepLinkActivated 来注册回调，推荐在单例管理类的 Awake() 方法中调用。
  • OnDeepLinkActivated 仅支持 HarmonyOS 平台。在其他平台上，传入此 API 的 callback 永远不会接收到回调。

方法签名​

public static void OnDeepLinkActivated(Action<string> callback);

方法参数​

ParameterRequiredTypeDescription
callbackTrueAction<string>当游戏通过 Deep Link 被唤起时调用的回调函数。回调参数为 Deep Link URL，开发者可以根据这个 URL 执行跳转场景或其他逻辑。

代码示例​

Show Code 
private void Awake()
{
    ComboSDK.OnDeepLinkActivated((url) =>
    {
        // 处理收到的 Deep Link URL
        Log.I("Game received deep link: " + url);

        // 示例：根据 URL 跳转场景
        // string sceneName = url.Split('?')[1];
        // SceneManager.LoadScene(sceneName);
    });
}

Xcode 配置​

iOS 平台需要对 Xcode 工程做以下配置：

img

以上配置长期有效，除非另行沟通，否则后续的 iOS 版本都需要包含上述配置。

配置完毕后，需要使用世游提供的 Distribution 证书出包，在 iOS 设备上 Safari 或备忘录中访问链接 https://applinks/app 测试唤起游戏客户端。

在国内 Android 分发生态中，用户通常通过各大应用商店（如小米、华为、OPPO 等）安装渠道包，其包名往往与官网包不同。

在浏览器或 WebView 环境中，如果 Web 端唤起逻辑强绑定官网包名（如使用包含 package= 的 Intent URL 或 App Links），当用户设备上仅安装渠道包时，系统将无法匹配到对应应用，导致已安装但无法唤起的问题。

为解决上述场景问题，Combo SDK for Android 额外提供 Custom deep links 作为渠道包兼容唤起方案，与 App Links 形成互补。

提示
  • 若需使用此功能，请使用 Combo CLI v2.16.0 or later 版本构建 APK。
  • Combo CLI 会在构建时自动将 Custom Scheme 注入 AndroidManifest.xml，游戏无需手动修改清单文件。
  • 本方案仅适用于 Android 平台，用于解决国内渠道包唤起兼容问题。

协议规则说明​

自定义 Scheme 采用统一命名规则：世游固定标识 seayoo + 项目 Game ID，作为该应用的唯一标识。

Custom deep links 的通用格式为：seayoo{GameID}://<host>/<path>?param1=value1&param2=value2。

Combo SDK 对 Custom deep links 的 host 与 path 不作强制约束，游戏可根据自身业务需求与世游协商定义 host 与 path 规则，例如：

seayooxxx://xxx.seayoo.com/app?roomId=70005468&type=invite

链接回调​

使用 Unity 的 Deep Linking API 处理游戏被 Custom deep links 唤起时的回调。

提示

H5 页面会将原始跳转参数（如 roomId）完整透传至 query 中。游戏脚本在处理 Deep Linking API 回调时，需解析完整的 URL 字符串。

最后于 更新