logo
当前页

快速开始

准备环境

在开始集成音视频 UIKit 前,请确保开发环境满足以下要求:

  • Xcode 15.0 或以上版本。
  • iOS 12.0 或以上版本且支持音视频的 iOS 设备。
  • iOS 设备已经连接到 Internet。

前提条件

实现流程

集成 SDK

1 添加 ZegoUIKitPrebuiltCall 作为依赖项

  1. 打开终端,前往到您项目的根目录,并运行以下命令创建 podfile
    Untitled
    pod init
    
    1
    Copied!
  2. 编辑 Podfile 文件添加基本依赖项:
    Untitled
    pod 'ZegoUIKitPrebuiltCall'
    
    1
    Copied!
  3. 在终端中运行以下命令,使用 Cocoapods 下载所需的所有依赖项和 SDK:
    Untitled
    pod install
    
    1
    Copied!

2 导入 ZegoUIKit 和 ZegoUIKitPrebuiltCall

在您的项目导入 ZegoUIKit 和 ZegoUIKitPrebuiltCall。

swift
objc
  import ZegoUIKit
  import ZegoUIKitPrebuiltCall
  // 您的 ViewController.swift
  class ViewController: UIViewController {
      // 其他代码...
  }
1
Copied!
  @import ZegoUIKit;
  @import ZegoUIKitPrebuiltCall;
  @import ZegoUIKitSignalingPlugin;
  @import ZegoPluginAdapter;
1
Copied!

配置项目

打开Info.plist,在dict部分内添加以下代码:

Untitled
<key>NSCameraUsageDescription</key>
<string>我们需要相机访问权限以实现通话</string>
<key>NSMicrophoneUsageDescription</key>
<string>我们需要麦克风访问权限以实现通话</string>
1
Copied!

使用 ZegoUIKitPrebuiltCallVC

声明 userIDuserNamecallID,用于创建通话。

Note
  • userIDcallID只能包含数字、字母和下划线(_)。
  • 用户使用相同的 callID 即可相互通话。
  • UIKit 默认语言为英文,如需修改为中文,请修改 ZegoUIKitPrebuiltCallConfig.zegoCallText
swift
objc
// 您的 ViewController.swift
class ViewController: UIViewController {
    // 其他代码...
    var userID: String = <#UserID#> 
    var userName: String = <#UserName#>
    var callID: String = <#CallID#>
    var appSign: String = <#AppSign#> // 从 ZEGO 控制台获取
    var appID: UInt32 = <#AppID#>  // 从 ZEGO 控制台获取 

    @IBAction func makeNewCall(_ sender: Any) {
        
        // 您还可以使用 groupVideo/groupVoice/oneOnOneVoice 进行更多类型的呼叫。
        let config: ZegoUIKitPrebuiltCallConfig = ZegoUIKitPrebuiltCallConfig.oneOnOneVideoCall()
        // 修改语言为中文
        config.zegoCallText = ZegoCallText(language: .CHS)
        let callVC = ZegoUIKitPrebuiltCallVC.init(appID: self.appID, 
                                                  appSign: self.appSign, 
                                                  userID: self.userID, 
                                                  userName: self.userName, 
                                                  callID: self.callID, 
                                                  config: config)
        callVC.modalPresentationStyle = .fullScreen
        self.present(callVC, animated: true, completion: nil)
    }
}
1
Copied!
@implementation ViewController

- (void)viewDidLoad {
    [super viewDidLoad];
    
    NSString * userID = @"userID";
    NSString * userName = @"userName";
    unsigned int appID = appID; // 从 ZEGO 控制台获取
    NSString * appSign = @"appSign"; // 从 ZEGO 控制台获取
    NSString * callID = @"callID";
    
    // 您还可以使用 groupVideo/groupVoice/oneOnOneVoice 进行更多类型的呼叫。
    ZegoUIKitPrebuiltCallConfig *config = [ZegoUIKitPrebuiltCallConfig oneOnOneVideoCall];
    // 修改语言为中文
    config.translationText = [[ZegoTranslationText alloc] initWithLanguage:ZegoUIKitLanguageCHS];
    ZegoUIKitPrebuiltCallVC *vc = [[ZegoUIKitPrebuiltCallVC alloc] init:appID appSign:appSign userID:userID userName:userName callID:callID config:config];
    vc.modalPresentationStyle = UIModalPresentationFullScreen;
    [self presentViewController:vc animated:YES completion:nil];
}
1
Copied!

然后,通过呈现VC来进行新的呼叫。

运行和测试

至此,您已经完成了所有步骤!

只需在 Xcode 中点击 Run 即可在设备上运行和测试您的应用程序。

相关指南

资源

常见问题

Previous

功能地图

Next

快速开始(包含呼叫邀请)