title: 安装和初始化

本篇文档介绍如何安装 SDK 并初始化 WilddogVideoCall。

使用 CocoaPods 安装 SDK

通过 Cocoapods 安装 Video iOS SDK 以及其依赖的 Auth SDK。

  • 在 Xcode 中创建一个工程，并在 terminal 中用 cd 命令进入到工程所在文件夹内，执行 pod init 命令；
  • 打开生成的 Podfile 文件，在第一行声明开发平台和版本（如iOS 8.0），并在随后写入要引入的库：
  1. platform :ios, '8.0'
  2. target 'your-target-name' do
  3.   pod 'WilddogVideoCall'
  4. end
  • 保存 Podfile，并执行 pod install 命令，将上述依赖安装到你的工程。
  • 双击生成的 your-project-name.xcworkspace 文件打开工程。

初始化

在使用 WilddogVideoCall SDK 之前，需要用 VideoAppId 和 token 初始化 WDGVideoInitializer 实例。

  • VideoAppId 是用户在野狗控制台创建的应用的唯一标识。
  • Token（身份认证令牌）是用户在 WilddogRoom SDK 中的唯一身份标识，用于识别用户身份并控制访问权限。

获取 VideoAppId

打开 控制面板 - 应用 - 实时视频通话 - 配置 标签页，获取 VideoAppID。

提示：

VideoAppId 为 应用 - 实时视频通话 - 配置 标签页中的 VideoAppID 字段值，请勿与应用的 AppID 混淆。 VideoAppID 为 wd 开头的随机字符串，例如：wd1234567890abcdef。

获取 Token

用户需要通过 野狗身份认证 服务来认证身份并登录服务器。开发者可以根据需要选择匿名登录、手机登录、邮箱密码、第三方或自定义认证等多种方式进行身份认证。成功通过身份认证后，使用 -[WDGUser getTokenWithCompletion:] 方法获取 token。

以匿名方式登录后初始化 WDGVideoInitializer 为例：

  1. [WDGApp configureWithOptions:[[WDGOptions alloc] initWithSyncURL:@"https://your-video-appid.wilddogio.com"]];
  2. [[WDGAuth auth] signOut:nil];
  3. // 匿名登录
  4. [[WDGAuth auth] signInAnonymouslyWithCompletion:^(WDGUser * _Nullable user, NSError * _Nullable error) {
  5.     if (!error) {
  6.         // 获取 Token
  7.         [user getTokenWithCompletion:^(NSString * _Nullable idToken, NSError * _Nullable error) {
  8.             // 初始化 WDGVideoInitializer
  9.             [[WDGVideoInitializer sharedInstancce] configureWithVideoAppId:@"your-video-appid" token:idToken];
  10.         }];
  11.     }
  12. }];

创建 Video 客户端

使用 +[WDGVideoCall sharedInstance] 方法获取 WDGVideoCall 单例，设置代理 <WDGVideoCallDelegate> 用于监听通话请求：

  1. [[WDGVideoCall sharedInstance].delegate = self;

实现代理方法 -[WDGVideoCallDelegate wilddogVideoCall:didReceiveCallWithConversation:data:]，当收到远端通话请求时，会触发该方法：

  1. - (void)wilddogVideoCall:(WDGVideoCall *)videoCall didReceiveCallWithConversation:(WDGConversation *)conversation data:(NSString *)data {
  2.     // 处理通话请求。
  3. }

实现代理方法 -[WDGVideoCallDelegate wilddogVideoCall:didFailWithTokenError:]，当 token 错误或过期时，会触发该方法：

  1. - (void)wilddogVideoCall:(WDGVideoCall *)videoCall didFailWithTokenError:(NSError *)error {
  2.     // 处理 token 错误。
  3. }