快速开始

准备环境

在开始集成语聊房 UIKit 前，请确保开发环境满足以下要求：

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

前提条件

已在 ZEGO 控制台创建项目，并申请有效的 AppID 和 AppSign，详情请参考控制台 - 项目信息。
联系 ZEGO 技术支持，开通 UIKit 相关服务。

实现流程

集成 SDK

1. 添加依赖

按照以下步骤添加 ZegoUIKitPrebuiltLiveAudioRoom 依赖：

打开终端，导航到您的项目的根目录，并运行以下命令创建一个 podfile：
```
pod init
```
```
pod init
```

编辑 Podfile 文件以添加依赖：

pod 'ZegoUIKitPrebuiltLiveAudioRoom'

pod 'ZegoUIKitPrebuiltLiveAudioRoom'

在终端中运行以下命令，使用 Cocoapods 安装所需的依赖：
```
pod install
```
```
pod install
```

2. 导入 SDK

参考以下代码导入 ZegoUIKitPrebuiltLiveAudioRoom SDK 和 ZegoUIKit SDK。

swift

import ZegoUIKitPrebuiltLiveAudioRoom
import ZegoUIKit
// YourViewController.swift
class ViewController: UIViewController {
    // 其他代码...
}

import ZegoUIKitPrebuiltLiveAudioRoom
import ZegoUIKit
// YourViewController.swift
class ViewController: UIViewController {
    // 其他代码...
}

配置您的项目

打开 Info.plist，并在 dict 部分内添加以下代码：

<key>NSCameraUsageDescription</key>
<string>需要访问相机的权限。</string>
<key>NSMicrophoneUsageDescription</key>
<string>需要访问麦克风的权限。</string>

<key>NSCameraUsageDescription</key>
<string>需要访问相机的权限。</string>
<key>NSMicrophoneUsageDescription</key>
<string>需要访问麦克风的权限。</string>

关闭 Bitcode。选择您的目标项目，并按照以下两张图片上的说明分别关闭 Bitcode。

使用语聊房 UIKit

为连接语聊房组件服务指定 userID 和 userName。
创建一个 roomID，代表您想要创建的语聊房。

说明

userID 和 roomID 只能包含数字、字母和下划线 (_)。
使用相同的 roomID 将进入同一个语聊房。
使用相同的 roomID，只能有一个用户作为主持人进入语聊房。其他用户需要作为观众进入语聊房。
UIKit 默认语言为英文，如需修改为中文，请修改 ZegoUIKitPrebuiltLiveAudioRoomConfig.translationText。

swift

class ViewController: UIViewController {
    let appID: UInt32 = <#AppID#>
    let appSign: String = <#AppSign#>
    var userID: String = <#UserID#>
    var userName: String = <#UserName#>
    var roomID: String = <#RoomID#>
    
    // 房主开始
    @IBAction func startLiveAudio(_ sender: Any) {
        
        let config: ZegoUIKitPrebuiltLiveAudioRoomConfig = ZegoUIKitPrebuiltLiveAudioRoomConfig.host()
        // 修改语言为中文
        config.translationText = ZegoTranslationText(language: .CHS)
        let liveAudioVC: ZegoUIKitPrebuiltLiveAudioRoomVC = ZegoUIKitPrebuiltLiveAudioRoomVC(appID: self.appID, appSign: self.appSign, userID: self.userID, userName: self.userName, roomID: self.roomID, config: config)
        liveAudioVC.modalPresentationStyle = .fullScreen
        self.present(liveAudioVC, animated: true, completion: nil)
    }
    
    // 观众收听
    @IBAction func joinLiveAudio(_ sender: Any) {
        let config: ZegoUIKitPrebuiltLiveAudioRoomConfig = ZegoUIKitPrebuiltLiveAudioRoomConfig.audience()
        // 修改语言为中文
        config.translationText = ZegoTranslationText(language: .CHS)
        let liveAudioVC: ZegoUIKitPrebuiltLiveAudioRoomVC = ZegoUIKitPrebuiltLiveAudioRoomVC(appID: self.appID, appSign: self.appSign, userID: self.userID, userName: self.userName, roomID: self.roomID, config: config)
        liveAudioVC.modalPresentationStyle = .fullScreen
        self.present(liveAudioVC, animated: true)
    }
}

class ViewController: UIViewController {
    let appID: UInt32 = <#AppID#>
    let appSign: String = <#AppSign#>
    var userID: String = <#UserID#>
    var userName: String = <#UserName#>
    var roomID: String = <#RoomID#>
    
    // 房主开始
    @IBAction func startLiveAudio(_ sender: Any) {
        
        let config: ZegoUIKitPrebuiltLiveAudioRoomConfig = ZegoUIKitPrebuiltLiveAudioRoomConfig.host()
        // 修改语言为中文
        config.translationText = ZegoTranslationText(language: .CHS)
        let liveAudioVC: ZegoUIKitPrebuiltLiveAudioRoomVC = ZegoUIKitPrebuiltLiveAudioRoomVC(appID: self.appID, appSign: self.appSign, userID: self.userID, userName: self.userName, roomID: self.roomID, config: config)
        liveAudioVC.modalPresentationStyle = .fullScreen
        self.present(liveAudioVC, animated: true, completion: nil)
    }
    
    // 观众收听
    @IBAction func joinLiveAudio(_ sender: Any) {
        let config: ZegoUIKitPrebuiltLiveAudioRoomConfig = ZegoUIKitPrebuiltLiveAudioRoomConfig.audience()
        // 修改语言为中文
        config.translationText = ZegoTranslationText(language: .CHS)
        let liveAudioVC: ZegoUIKitPrebuiltLiveAudioRoomVC = ZegoUIKitPrebuiltLiveAudioRoomVC(appID: self.appID, appSign: self.appSign, userID: self.userID, userName: self.userName, roomID: self.roomID, config: config)
        liveAudioVC.modalPresentationStyle = .fullScreen
        self.present(liveAudioVC, animated: true)
    }
}

然后，您可以通过展示 ViewController 来创建一个语聊房。

运行 & 测试

现在您已经完成了所有步骤！

您只需在 XCode 中，点击运行，就可以在您的设备上运行和测试您的应用。

资源

示例代码

点击这里获取完整的示例代码。