如果你想给视频通话开发一个分享链接，方便用户的朋友通过链接直接加入某个视频通话或直播推流，方法一是让用户向朋友分享聊天室代码，让其朋友把这个代码敲到他们自己的应用上；方法二是让用户的朋友通过用户分享的链接直接进入聊天室。很明显方法二更好，而方法二需要搭建通用链接。

什么是通用链接？

大部分情况下，应用程序中的视图都有对应的网页视图。例如，你可以在手机上的网页浏览器上打开 instagram 个人中心，也可以在 instagram 应用里打开这个视图，而通用链接就是把网页浏览器上的内容显示到应用程序上的“通道”。

在有些情况下，我们无法通过通用链接打开网页，比如，有些复杂的游戏不能在网页浏览器上运行，如果点击专属链接，就会直达模板页面并将模板页面传递给应用，应用会渲染所有内容或加入游戏。

安卓和 iOS 系统上的通用链接不一样，想通过 URL 直接打开应用程序，需要分别在两种系统上设置通用链接。

前期准备

一个声网Agora 开发者账户——点击这里免费注册
VS Code 或 Android Studio
Xcode 12.3 或更高版本
安卓和 iOS 设备
配置了 SSL 证书的公共服务器（HTTPS）

设置通用链接

通用链接很好设置，主要分两步：

设置网站
设置应用程序

我们先从网站设置开始。

设置网站

我们必须在 Flutter 中为 URL 创建两个参考点，以便在安卓和 iOS 系统上都能打开链接。

我们先来分别看看如何在安卓和 iOS 系统上设置网站以打开通用链接。

安卓

对于安卓系统，我们首先创建一个存储在 .known/assetlinks.json 的 JSON 文件，通过创建这个文件来声明网站与应用程序的关联。

在 JSON 文件中添加以下属性：

[{
"relation": ["delegate_permission/common.handle_all_urls"],
"target": {
    "namespace": "agora_uikit",
    "package_name": "io.agora.agora_uikit_example",
    "sha256_cert_fingerprints": [""]
}
}]

namespace ：Flutter 应用程序的名称。
package_name ：在应用程序的 build .gradle 文件中声明的应用程序 ID。
sha256_cert_fingerprints ：使用以下命令通过 Java keytool 生成指纹：

keytool -list -v -keystore my-release-key.keystore

iOS

对于 iOS 系统，我们会创建一个名为 apple-app-site-association 的文件，用这个文件来声明网站与应用程序的关联。注意，该文件在保存时没有任何扩展名。

Apple 应用网站协会（AASA）应配置在根目录下，为你的 CDN 添加合适的标头，确保为该文件配置 Content-Type=application/pkcs7-mime 标头。AASA 文件如下：

{
  "applinks": {
    "apps": [],
    "details": [{
        "appIDs": ["DEVELOPMENT_TEAM.PRODUCT_BUNDLE_IDENTIFIER"],
        "components": [
          {
            "/": "*"
          }
        ]
    }]
  }
}

你只需用应用程序中的关联值替换 DEVELOPMENT_TEAM 和 PRODUCT_BUNDLE_IDENTIFIER 。找到你的项目中的 iOS 目录，在该目录的终端中运行下列命令，就可以找到DEVELOPMENT_TEAM 和 PRODUCT_BUNDLE_IDENTIFIER ，如下：

grep -r -m 1 "DEVELOPMENT_TEAM" .; grep -r -m 1 "PRODUCT_BUNDLE_IDENTIFIER" .

你的终端如下：

=> grep -r -m 1 "DEVELOPMENT_TEAM" .; grep -r -m 1 "PRODUCT_BUNDLE_IDENTIFIER" ../AppName.xcodeproj/project.pbxproj:    DEVELOPMENT_TEAM = 278494H572;
./AppName.xcodeproj/project.pbxproj:    PRODUCT_BUNDLE_IDENTIFIER = io.agora.AppName;

这种情况下，我们想要的值分别是 278494H572 和 io.agora.AppName。

如果想查看是否正确设置网站，可前往 Branch.io’s validator。

如果想查看更多的示例，可查看 Apple 文档。

添加 AASA 后，你的服务器目录如下：

以上是所有设置，接下来设置应用程序。

设置应用程序

首先，设置应用程序信任，即应用程序已获得网站批准，可以自动打开该域名的链接。如果系统验证你拥有该 URL，就会自动将这些 URL intent 路由到你的应用程序。

我们一起看一下如何在安卓系统和 iOS 系统中设置 URL 和应用程序之间的信任。

安卓

对于安卓系统，我们只需在 AndroidManifest.xml 中添加 intent 过滤器。

<intent-filter>
    <action android:name="android.intent.action.VIEW" />
    <category android:name="android.intent.category.DEFAULT" />
    <category android:name="android.intent.category.BROWSABLE" />
    <data android:scheme="https"
        android:host="[YOUR_HOST]" />
</intent-filter>

在上述代码中，用你的 HTTPS 服务器替换 [YOUR_HOST]。

iOS

对于 iOS 系统，可以使用 Xcode 将关联域的兼容性添加到项目中。在 Xcode 上打开的Flutter 应用程序的 iOS 目录，选择 Runner：

在Runner中，选择 Signing & Capabilities。

点击 +Capability
选择列表中的 Associated Domains。

点击 + icon，添加你的服务器 URL。

applinks:www.link-to-your-server.com

以上就是所有设置。我们来一起看一下如何在 UIKit 中使用 URL 来分享邀请。

Agora Flutter UIKit

Flutter UIKit 现在可以使用通用链接啦，通用链接可以自动分享邀请信息，还可以验证 URL 和应用程序之间的信任。

想了解如何使用通用链接，可以找到 Flutter UIKit 的深度链接分支：https://github.com/AgoraIO-Community/Flutter-UIKit/tree/deeplink

如果想用 Flutter UIKit 生成邀请信息和会议 URL，只需将 deeplinkBaseUrl 添加到 AgoraClient 中，就可以声明客户对象，如下所示：

final AgoraClient client = AgoraClient(    
    agoraConnectionData: AgoraConnectionData(      
        appId: "<--Add your APP ID here-->",      
        channelName: "test",    
    ),    
    enabledPermission: [Permission.camera,Permission.microphone],
    deepLinkBaseUrl: "link-to-your-server.com",  
);

我们继续下一步骤。

测试

可以在安卓系统或 iOS 上进行测试。在根目录下的在终端输入下列命令：

flutter run

总结

我们成功搭建了一个视频聊天应用程序，这个应用可以分享会议 URL 并直接邀请他人加入你的通话，无需输入频道名称。

如果想在你的 Agora Flutter UIKit 中使用通用链接，请看完整代码。

其他资源

要了解更多关于声网Agora Flutter SDK 的信息及其他用例，请查看开发者指南。

点击这里查看上述功能的完整文档，还可以查看其他功能。

原文作者：Meherdeep Thakur
原文链接：Adding Meeting URLs to your Agora Live Video Call using the Flutter UIKit