VideoSDK RTC iOS SDK
videosdk.live的官方iOS SDK
特性
- VideoSDK允许您将沉浸式视频体验集成到应用程序中。
- 基于WebRTC和优化UDP协议的实时通讯SDK。我们的SDK帮助开发者将实时音频和视频通话添加到任何iOS移动应用中。
要求
- iOS 11.0+
- Xcode 12.0+
- Swift 5.0+
安装
CocoaPods
CocoaPods是一个Cocoa项目的依赖管理器。有关用法和安装说明,请访问他们的网站。要使用CocoaPods将VideoSDK集成到您的Xcode项目中,请在您的Podfile
中进行指定。
pod 'VideoSDKRTC'
or
pod 'VideoSDKRTC', :git => 'https://github.com/videosdk-live/videosdk-rtc-ios-sdk.git'
重要
- 您需要将'启用位代码'设置为false。
用法
导入
import VideoSDKRTC
配置VideoSDK
VideoSDK.config(token: <server token here>)
- JWT服务器令牌需要由您的服务器生成。
- 如果您还没有设置服务器,请按照如何设置本地服务器进行操作。
初始化会议
let meeting = VideoSDK.initMeeting(
meetingId: <meetingId>, participantName: <your name>, micEnabled: true, webcamEnabled: true)
- 首先,您需要生成会议ID或从服务器获取它以初始化会议实例。
- 对于participantName -> 提供要显示在会议中的您的姓名。
- 可选地设置mic和摄像头设置的真/假。
添加监听器
meeting?.addEventListener(self)
- 在您的ViewController中实现
MeetingEventListener
以获取各种会议事件的通知。
加入
meeting?.join()
监听器
MeetingEventListener
onMeetingJoined()
当会议开始时调用。onMeetingLeft()
当会议结束时调用。onParticipantJoined(_ participant: Participant)
有新参与者加入时调用。onParticipantLeft(_ participant: Participant)
参与者离开时调用。onRecordingStarted()
会议录音开始时调用。onRecordingStoppped
会议录音停止后调用。onLivestreamStarted
直播流开始时调用。onLivestreamStopped
直播流停止后调用。onSpeakerChanged(participantId: String?)
当活动讲者改变时调用。onMicRequested(participantId: String?, accept: @escaping () -> Void, reject: @escaping () -> Void)
当有人请求开启麦克风时调用。onWebcamRequested(participantId: String?, accept: @escaping () -> Void, reject: @escaping () -> Void)
当有人请求开启摄像头时调用。
ParticipantEventListener
onStreamEnabled(_ stream: MediaStream, forParticipant participant: Participant)
当参与者开启麦克风或摄像头时调用。onStreamDisabled(_ stream: MediaStream, forParticipant participant: Participant)
当参与者关闭麦克风或摄像头时调用。
Permissions
- 您的应用需要在 info.plist 文件中添加权限才能使用麦克风和摄像头。请添加以下代码到您应用的 info.plist 文件中。
<key>NSCameraUsageDescription</key>
<string>Allow camera access to start video.</string>
<key>NSMicrophoneUsageDescription</key>
<string>Allow microphone access to start audio.</string>
示例
查看更多详情,请见示例。