错误处理

• 用 switch 按语义分支处理
• 用 error.code 拿到整数错误码，方便日志与工单排查
• 用 error.message 拿到纯文本描述
• error.localizedDescription 输出 "<code>: <message>"

​

错误清单

​

错误码规则

• 客户端错误（上表中客户端码小于 1000 的那些）会加上平台前缀，拼成 6 位数：iOS 前缀 203，macOS 前缀 205
• 服务端透传错误（apiError 且服务端码不小于 1000）原样保留，不加前缀

​

unauthorized 的常见来源

​

推荐的处理方式

do {
    try await meeting.requestOpenMic()
} catch let error as SMeetingError {
    switch error {
    case .tokenExpired, .tokenInvalid, .notLoggedIn:
        await reLogin()
    case .unauthorized:
        showToast("主持人已开启全体静音")
    case .apiError(let code, let message):
        showToast(message)
        log("meeting api error \(code)")
    default:
        showToast(error.message)
        log(error.localizedDescription)
    }
} catch {
    // 底层音视频层抛出的错误
    log("\(error)")
}

• 除了 SMeetingError，底层音视频层也可能抛出自己的错误类型（例如采集失败、连接失败），所以 catch 兜底分支不要省
• 面向最终用户提示时优先用 error.message；写日志时用 error.localizedDescription，它带错误码
• SMeetingError 遵循 Equatable，可以直接和具体 case 比较

​

不会抛错的接口

• logout()
• exitRoom()
• closeMic() / closeCamera() / stopShare()
• disableIm()
• toggleRemoteAudioMute(_:)
• getRoomInfo() / getWhiteBoard() / getUsersInfo() / getUsersInfoList() / getRemoteVideoTrack(uid:desc:) / getDevices(kind:)

​

相关页面

• 核心概念
• 接口文档 - SMeeting