快速开始
准备环境
在开始集成音视频 UIKit 前,请确保开发环境满足以下要求:
- Xcode 15.0 或以上版本。
- iOS 12.0 或以上版本且支持音视频的 iOS 设备。
- iOS 设备已经连接到 Internet。
前提条件
- 已在 ZEGO 控制台 创建项目,并申请有效的 AppID 和 AppSign,详情请参考 控制台 - 项目信息。
- 联系 ZEGO 技术支持,开通 UIKit 相关服务。
实现流程
集成 SDK
1 添加 ZegoUIKitPrebuiltCall 作为依赖项
- 打开终端,前往到您项目的根目录,并运行以下命令创建
podfile
:Untitledpod init
1 - 编辑
Podfile
文件添加基本依赖项:Untitledpod 'ZegoUIKitPrebuiltCall'
1 - 在终端中运行以下命令,使用 Cocoapods 下载所需的所有依赖项和 SDK:
Untitled
pod install
1
2 导入 ZegoUIKit 和 ZegoUIKitPrebuiltCall
在您的项目导入 ZegoUIKit 和 ZegoUIKitPrebuiltCall。
swift
objc
import ZegoUIKit
import ZegoUIKitPrebuiltCall
// 您的 ViewController.swift
class ViewController: UIViewController {
// 其他代码...
}
1
@import ZegoUIKit;
@import ZegoUIKitPrebuiltCall;
@import ZegoUIKitSignalingPlugin;
@import ZegoPluginAdapter;
1
配置项目
打开Info.plist
,在dict
部分内添加以下代码:
Untitled
<key>NSCameraUsageDescription</key>
<string>我们需要相机访问权限以实现通话</string>
<key>NSMicrophoneUsageDescription</key>
<string>我们需要麦克风访问权限以实现通话</string>
1
使用 ZegoUIKitPrebuiltCallVC
声明 userID
、userName
和 callID
,用于创建通话。
Note
userID
和callID
只能包含数字、字母和下划线(_)。- 用户使用相同的
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
@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
然后,通过呈现VC
来进行新的呼叫。
运行和测试
至此,您已经完成了所有步骤!
只需在 Xcode 中点击 Run 即可在设备上运行和测试您的应用程序。
相关指南
通话设置
资源
示例代码
获取完整示例代码。
常见问题
如何处理接入错误