帮你快速理解、总结文档立即下载
文档中心>物联网开发平台>客户端 API>Android>TXIoTCallSession

TXIoTCallSession

最近更新时间：2026-07-30 12:00:38

我的收藏

本页目录：



概述

TXIoTCallSession 负责与设备之间的音视频通话，包括发起呼叫、挂断、远端画面渲染、麦克风/摄像头控制及音频输出设备选择。TXIoTCallSession 通过 TXIoTEngine.getCallSession 获取实例，需在登录成功后调用。
说明：
回调模型：通话事件通过 TXIoTCallListener 接口回调，所有 Listener 回调在主线程触发，公共类型与错误码定义见 TXIoTEngineDef。

方法列表

方法签名
描述
添加通话事件监听器。
移除通话事件监听器。
向设备发起通话（音频/视频）。
hangup
挂断当前通话。
开始渲染远端视频。
停止渲染远端视频。
打开麦克风。
关闭麦克风。
打开摄像头并设置本地预览视图。
关闭摄像头。
切换摄像头（前后置）。
选择音频播放设备（扬声器/听筒）。

addListener

addListener
void addListener
(TXIoTCallListener listener)
添加通话事件监听器
参数
描述
listener
TXIoTCallListener；监听器实例。

removeListener

removeListener
void removeListener
(TXIoTCallListener listener)
移除通话事件监听器
参数
描述
listener
TXIoTCallListener；监听器实例。

callDevice

callDevice
void callDevice
(TXIoTDeviceId deviceId, TXIoTCallMediaType callType)
向设备发起通话（音频/视频）
参数
描述
deviceId
TXIoTDeviceId；设备标识（含 productId / deviceName）。
callType
TXIoTCallMediaType；通话类型（音频/视频）。

hangup

hangup
void hangup
()
挂断当前进行中的通话

startRemoteView

startRemoteView
void startRemoteView
(TXIoTCallUser callUser, TXCloudVideoView videoView)
开始渲染远端视频
参数
描述
callUser
TXIoTCallUser；参与通话的用户。
videoView
TXCloudVideoView；视频渲染视图。

stopRemoteView

stopRemoteView
void stopRemoteView
(TXIoTCallUser callUser)
停止渲染远端视频
参数
描述
callUser
TXIoTCallUser；参与通话的用户。

openMicrophone

openMicrophone
void openMicrophone
()
打开麦克风

closeMicrophone

closeMicrophone
void closeMicrophone
()
关闭麦克风

openCamera

openCamera
void openCamera
(TXIoTCamera camera, TXCloudVideoView videoView)
打开摄像头并设置本地预览视图
参数
描述
camera
TXIoTCamera；摄像头（前置/后置）。
videoView
TXCloudVideoView；视频渲染视图。

closeCamera

closeCamera
void closeCamera
()
关闭摄像头

switchCamera

switchCamera
void switchCamera
(TXIoTCamera camera)
切换摄像头（前后置）
参数
描述
camera
TXIoTCamera；摄像头（前置/后置）。

selectAudioPlaybackDevice

selectAudioPlaybackDevice
void selectAudioPlaybackDevice
(TXIoTAudioPlaybackDevice device)
选择音频播放设备（扬声器/听筒）
参数
描述
device
TXIoTAudioPlaybackDevice；音频播放设备（扬声器/听筒）。

通话事件回调

TXIoTCallListener
回调方法
说明
onError(TXIoTErrorCode code, String msg)
通话发生错误。
onCallBegin(TXIoTCallMediaType mediaType)
通话开始。
onCallEnd(TXIoTCallMediaType mediaType, TXIoTCallEndReason reason)
通话结束，携带结束原因。
onCallRejected(TXIoTCallUser callUser)
通话被对方拒接。
onCallNoResponse(TXIoTCallUser callUser)
对方无应答。
onCallLineBusy(TXIoTCallUser callUser)
对方占线。
onCallUserOffline(TXIoTCallUser callUser)
对方离线。
onCallUserAudioAvailable(TXIoTCallUser callUser, boolean available)
远端用户音频状态发生变化。
onCallUserVideoAvailable(TXIoTCallUser callUser, boolean available)
远端用户视频状态发生变化。
onCallNetworkQualityChanged(TXIoTQuality localQuality, List<TXIoTQuality> remoteQualityList)
网络质量变化通知。

通话相关数据结构与枚举

TXIoTCallMediaType

TXIoTCallMediaType
枚举
说明
AUDIO
音频通话。
VIDEO
视频通话。

TXIoTCallEndReason

TXIoTCallEndReason
枚举
说明
UNKNOWN
未知原因。
LOCAL_HANGUP
本地挂断。
REMOTE_HANGUP
远端挂断。
CALL_PERMISSION_DENIED
呼叫权限被拒绝。
NETWORK_ERROR
网络错误。

TXIoTAudioPlaybackDevice

TXIoTAudioPlaybackDevice
枚举
说明
SPEAKER_PHONE
扬声器（外放）。
EAR_PIECE
听筒。

TXIoTCamera

TXIoTCamera
枚举
说明
FRONT
前置摄像头。
BACK
后置摄像头。

TXIoTNetworkQuality

TXIoTNetworkQuality
枚举
说明
EXCELLENT
极佳
GOOD
良好
POOR
较差
BAD
差
VERY_BAD
很差
DOWN
网络不可用

TXIoTCallUser

TXIoTCallUser
字段
说明
deviceId
参与通话的设备 ID。

TXIoTQuality

TXIoTQuality
字段
说明
callUser
网络质量对应的通话用户。
quality
网络质量等级。
中国站