iOS端实现语聊房

1、申请权限请求

进入音视频通话时，虽然SDK会检查是否已在App中授予了所需要的权限，当为保障体验，建议在发起通话前检查视频拍摄及麦克风采集的权限。

func checkMicrophonePermission(completion: @escaping (Bool) -> Void) {
    let status = AVCaptureDevice.authorizationStatus(for: .audio)
    
    switch status {
    case .notDetermined:
        AVCaptureDevice.requestAccess(for: .audio) { granted in
            completion(granted)
        }
    case .authorized:
        completion(true)
    default:
        completion(false)
    }
}

func checkCameraPermission(completion: @escaping (Bool) -> Void) {
    let status = AVCaptureDevice.authorizationStatus(for: .video)
    
    switch status {
    case .notDetermined:
        AVCaptureDevice.requestAccess(for: .video) { granted in
            completion(granted)
        }
    case .authorized:
        completion(true)
    default:
        completion(false)
    }
}

// 使用示例
checkMicrophonePermission { granted in
    if granted {
        print("用户已授权麦克风")
    } else {
        print("用户未授权麦克风")
    }
}

checkCameraPermission { granted in
    if granted {
        print("用户已授权摄像头")
    } else {
        print("用户未授权摄像头")
    }
}

2、鉴权Token

加入ARTC频道需要一个鉴权Token，用于鉴权用户的合法身份，其鉴权Token生成规则参见：Token鉴权。Token 生成有两种方式：单参数方式和多参数方式，不同的Token生成方式需要调用SDK不同的加入频道(joinChannel)的接口。

上线发布阶段：

由于Token的生成需要使用AppKey，写死在客户端存在泄漏的风险，因此强烈建议线上业务通过业务Server生成下发给客户端。

开发调试阶段：

开发调试阶段，如果业务Server还没有生成Token的逻辑，可以暂时参考APIExample上的Token生成逻辑，生成临时Token，其参考代码如下：

class ARTCTokenHelper: NSObject {

    /**
    * RTC AppId
    */
    public static let AppId = "<RTC AppId>"

    /**
    * RTC AppKey
    */
    public static let AppKey = "<RTC AppKey>"

    /**
    * 根据channelId，userId, timestamp 生成多参数入会的 token
    * Generate a multi-parameter meeting token based on channelId, userId, and timestamp
    */
    public func generateAuthInfoToken(appId: String = ARTCTokenHelper.AppId, appKey: String =  ARTCTokenHelper.AppKey, channelId: String, userId: String, timestamp: Int64) -> String {
        let stringBuilder = appId + appKey + channelId + userId + "\(timestamp)"
        let token = ARTCTokenHelper.GetSHA256(stringBuilder)
        return token
    }

    /**
    * 根据channelId，userId, nonce 生成单参数入会 的token
    * Generate a single-parameter meeting token based on channelId, userId, and nonce
    */
    public func generateJoinToken(appId: String = ARTCTokenHelper.AppId, appKey: String =  ARTCTokenHelper.AppKey, channelId: String, userId: String, timestamp: Int64, nonce: String = "") -> String {
        let token = self.generateAuthInfoToken(appId: appId, appKey: appKey, channelId: channelId, userId: userId, timestamp: timestamp)

        let tokenJson: [String: Any] = [
            "appid": appId,
            "channelid": channelId,
            "userid": userId,
            "nonce": nonce,
            "timestamp": timestamp,
            "token": token
        ]

        if let jsonData = try? JSONSerialization.data(withJSONObject: tokenJson, options: []),
        let base64Token = jsonData.base64EncodedString() as String? {
            return base64Token
        }

        return ""
    }

    /**
    * 字符串签名
    * String signing (SHA256)
    */
    private static func GetSHA256(_ input: String) -> String {
        // 将输入字符串转换为数据
        let data = Data(input.utf8)

        // 创建用于存储哈希结果的缓冲区
        var hash = [UInt8](repeating: 0, count: Int(CC_SHA256_DIGEST_LENGTH))

        // 计算 SHA-256 哈希值
        data.withUnsafeBytes {
            _ = CC_SHA256($0.baseAddress, CC_LONG(data.count), &hash)
        }

        // 将哈希值转换为十六进制字符串
        return hash.map { String(format: "%02hhx", $0) }.joined()
    }

}

3. 创建并初始化引擎

• 创建 RTC 引擎

调用getInstance创建 RTC 引擎对象。

private var rtcEngine: AliRtcEngine? = nil

// 创建引擎并设置回调
let engine = AliRtcEngine.sharedInstance(self, extras:nil)
self.rtcEngine = engine

• 初始化引擎

  • 调用setChannelProfile接口设置频道为互动模式。

  • 根据业务场景中用户的角色，调用setClientRole接口为用户设置主播/观众角色。

  • 调用setAudioProfile接口设置音频质量与场景模式。

// 设置频道模式为互动模式,RTC下都使用AliRtcInteractivelive
engine.setChannelProfile(AliRtcChannelProfile.interactivelive)
// 设置角色
if self.isAnchor {
    // 主播模式，需要推音视频流，设置AliRtcClientRoleInteractive
    engine.setClientRole(AliRtcClientRole.roleInteractive)
}
else {
    // 观众模式，不需要推音视频流，设置AliRtcClientRolelive
    engine.setClientRole(AliRtcClientRole.rolelive)
}

// 设置音频Profile，默认使用高音质模式AliRtcEngineHighQualityMode及音乐模式AliRtcSceneMusicMode
engine.setAudioProfile(AliRtcAudioProfile.engineHighQualityMode, audio_scene: AliRtcAudioScenario.sceneMusicMode)

• 实现常用回调

SDK 在运行过程中如遇到异常情况，会优先尝试内部重试机制以自动恢复。对于无法自行解决的错误，SDK 会通过预定义的回调接口通知您的应用程序。

以下是一些 SDK 无法处理、需由应用层监听和响应的关键回调：

extension VideoCallMainVC: AliRtcEngineDelegate {

    func onJoinChannelResult(_ result: Int32, channel: String, elapsed: Int32) {
        "onJoinChannelResult1 result: \(result)".printLog()
    }

    func onJoinChannelResult(_ result: Int32, channel: String, userId: String, elapsed: Int32) {
        "onJoinChannelResult2 result: \(result)".printLog()
    }

    func onRemoteUser(onLineNotify uid: String, elapsed: Int32) {
        // 远端用户的上线
        "onRemoteUserOlineNotify uid: \(uid)".printLog()
    }

    func onRemoteUserOffLineNotify(_ uid: String, offlineReason reason: AliRtcUserOfflineReason) {
        // 远端用户的下线
        "onRemoteUserOffLineNotify uid: \(uid) reason: \(reason)".printLog()
    }


    func onRemoteTrackAvailableNotify(_ uid: String, audioTrack: AliRtcAudioTrack, videoTrack: AliRtcVideoTrack) {
        "onRemoteTrackAvailableNotify uid: \(uid) audioTrack: \(audioTrack)  videoTrack: \(videoTrack)".printLog()
    }

    func onAuthInfoWillExpire() {
        "onAuthInfoWillExpire".printLog()

        /* TODO: 务必处理；Token即将过期，需要业务触发重新获取当前channel，user的鉴权信息，然后设置refreshAuthInfo即可 */
    }

    func onAuthInfoExpired() {
        "onAuthInfoExpired".printLog()

        /* TODO: 务必处理；提示Token失效，并执行离会与释放引擎 */
    }

    func onBye(_ code: Int32) {
        "onBye code: \(code)".printLog()

        /* TODO: 务必处理；业务可能会触发同一个UserID的不同设备抢占的情况 */
    }

    func onLocalDeviceException(_ deviceType: AliRtcLocalDeviceType, exceptionType: AliRtcLocalDeviceExceptionType, message msg: String?) {
        "onLocalDeviceException deviceType: \(deviceType)  exceptionType: \(exceptionType)".printLog()

        /* TODO: 务必处理；建议业务提示设备错误，此时SDK内部已经尝试了各种恢复策略已经无法继续使用时才会上报 */
    }

    func onConnectionStatusChange(_ status: AliRtcConnectionStatus, reason: AliRtcConnectionStatusChangeReason) {
        "onConnectionStatusChange status: \(status)  reason: \(reason)".printLog()

        if status == .failed {
            /* TODO: 务必处理；建议业务提示用户，此时SDK内部已经尝试了各种恢复策略已经无法继续使用时才会上报 */
        }
        else {
            /* TODO: 可选处理；增加业务代码，一般用于数据统计、UI变化 */
        }
    }
}

4. 设置推拉流属性

SDK 默认情况下会自动推送和拉取频道内的音视频流

• 设置为观众模式后只能拉流，publishLocalAudioStream 无效

• 对于主播和观众均可以设置为下面的配置

// 设置音频Profile，默认使用高音质模式AliRtcEngineHighQualityMode及音乐模式AliRtcSceneMusicMode
engine.setAudioProfile(AliRtcAudioProfile.engineHighQualityMode, audio_scene: AliRtcAudioScenario.sceneMusicMode)

// 语聊场景，不需要publish视频
engine.publishLocalVideoStream(false)

// 设置默认订阅远端的音频
engine.setDefaultSubscribeAllRemoteAudioStreams(true)
engine.subscribeAllRemoteAudioStreams(true)

5. 加入频道开始纯音频互动

调用joinChannel接口加入频道。

注意：

如果token是单参数规则生成的，需要调用SDK单参数的joinChannel[1/3]接口，如果是多参数规则生成的，需要调用SDK多参数的joinChannel[2/3]接口。调用完加入频道后，可以在onJoinChannelResult回调中拿到加入频道结果，如果result为0，则表示加入频道成功，否则需要检查传进来的Token是否非法。

self.rtcEngine?.joinChannel(joinToken, channelId: nil, userId: nil, name: nil) 

6. 结束纯音频互动

音频互动结束，需要离开房间并销毁引擎，按照下列步骤结束音视频互动

1. 调用leaveChannel离会。

2. 调用destroy销毁引擎，并释放相关资源。

self.rtcEngine?.leaveChannel()
AliRtcEngine.destroy()
self.rtcEngine = nil

7. （可选）观众上下麦

业务场景中，如果观众角色的用户想要推流，需要调用setClientRole将观众角色切换为主播角色。

// 切换为主播角色
self.rtcEngine?.setClientRole(AliRtcClientRole.roleInteractive)

// 切换为观众角色
self.rtcEngine?.setClientRole(AliRtcClientRole.rolelive)