物联网开发平台 Android 智能设备（视频通话）

一、前提条件

在接入通话功能前，请你先完成 登录与注册 文档中跑通 login 登录功能，如果你已经完成，可以跳过该操作。

注意：说明：

注意：音视频通话依赖摄像头与麦克风采集，请确保已在 AndroidManifest.xml 中声明 android.permission.CAMERA、android.permission.RECORD_AUDIO 权限，并在运行时向用户申请授权。

二、步骤 1：注册通话事件回调

登录成功后，通过 TXIoTCallSession.getInstance().addListener 注册 TXIoTCallSession.Listener，通话相关的回调如下：

private final TXIoTCallSession.Listener mCallListener = new TXIoTCallSession.Listener() { @Override public void onCallRequested(Contact contact, Option option) { // 收到来电，根据业务决定接听或拒绝（见步骤 2） } @Override public void onCallAccepted(Contact contact) { // 通话正式建立，此时开启采集推流与渲染对端画面（见步骤 3） } @Override public void onCallRejected(Contact contact) { // 本次呼叫被拒绝，结束本次呼叫并释放资源 } @Override public void onCallTimeout(Contact contact) { // 来电未及时处理超时，释放资源 } @Override public void onCallHangup(Contact contact) { // 对端挂断，停止采集与渲染并释放资源（见步骤 4） }};// 登录成功后注册监听TXIoTCallSession.getInstance().addListener(mCallListener);

三、步骤 2：响应来电

设备作为被叫，收到 onCallRequested 后，根据业务逻辑调用 accept 接听，或调用 reject 拒绝：

注意：accept 回调 onSuccess 仅代表接听请求已发出，通话尚未建立。请勿在此时立即开启采集推流，务必等到 onCallAccepted 回调触发后（通话正式建立）再开启摄像头/麦克风。

@Overridepublic void onCallRequested(Contact contact, Option option) { // 示例：直接接听，实际业务可结合按键、界面弹窗等方式决定接听或拒绝 TXIoTCallSession.getInstance().accept(contact.userId, new TXIoTCallback() { @Override public void onSuccess() { // 接听请求已发出，等待 onCallAccepted 回调触发后再开启采集推流 } @Override public void onError(int code, String desc) { Log.e(TAG, "accept failed: " + code + " " + desc); } }); // 拒绝来电： // TXIoTCallSession.getInstance().reject(contact.userId, callback);}

四、步骤 3：开启采集推流与渲染对端画面

通话正式建立（onCallAccepted 回调触发）后，根据 onCallRequested 携带的 option.mediaContent 开启本地采集推流，直接调用如下接口即可：

// mLocalView / mRemoteView 为布局中的 TXCloudVideoView，分别用于本地预览与对端画面String userId = "peer_user_id";if (media == MediaContent.VIDEO || media == MediaContent.AUDIO_VIDEO) { TXIoTCallSession.getInstance().openCamera(true, mLocalView); // 使用前置摄像头，本地预览到 mLocalView TXIoTCallSession.getInstance().startRemoteView(userId, mRemoteView);// 渲染对端画面}if (media == MediaContent.AUDIO || media == MediaContent.AUDIO_VIDEO) { TXIoTCallSession.getInstance().openMicrophone();}

五、步骤 4：挂断通话

通话中主动挂断，调用 hangup；对端挂断时会触发 onCallHangup，此时应关闭本地采集、停止对端画面渲染：

// 主动挂断TXIoTCallSession.getInstance().hangup(userId, new TXIoTCallback() { @Override public void onSuccess() { // 停止采集与渲染，释放资源（onCallHangup / onCallTimeout / onCallRejected 均调用） TXIoTCallSession.getInstance().stopRemoteView(userId); TXIoTCallSession.getInstance().closeCamera(); TXIoTCallSession.getInstance().closeMicrophone(); } @Override public void onError(int code, String desc) { Log.e(TAG, "hangup failed: " + code + " " + desc); }});

注意：说明：

注意：来电未及时处理时会触发 onCallTimeout，处理方式与 onCallHangup 一致：关闭采集、停止渲染并释放资源。

六、完整示例代码

以下 CallActivity 示例整合了通话事件响应、接听来电、开启采集推流与渲染对端画面、以及挂断的完整流程，实际接入时，请将布局中的 TXCloudVideoView 与业务界面对接。

import android.os.Bundle;import android.util.Log;import androidx.annotation.Nullable;import androidx.appcompat.app.AppCompatActivity;import com.tencent.liteav.iot.TXIoTCallback;import com.tencent.liteav.iot.TXIoTCallSession;import com.tencent.liteav.iot.TXIoTCallSession.Contact;import com.tencent.liteav.iot.TXIoTCallSession.MediaContent;import com.tencent.liteav.iot.TXIoTCallSession.Option;import com.tencent.liteav.iot.TXIoTError;import com.tencent.rtmp.ui.TXCloudVideoView;public class CallActivity extends AppCompatActivity { private static final String TAG = "CallActivity"; private TXCloudVideoView mLocalView; private TXCloudVideoView mRemoteView; // 记住当前通话的媒体类型与对端账号，供接听/挂断复用 private MediaContent mCurrentMedia = MediaContent.AUDIO_VIDEO; private String mPeerUserId; private final TXIoTCallSession.Listener mCallListener = new TXIoTCallSession.Listener() { @Override public void onCallRequested(Contact contact, Option option) { Log.i(TAG, "onCallRequested userId=" + contact.userId + " media=" + option.mediaContent); mPeerUserId = contact.userId; mCurrentMedia = option.mediaContent; // 示例：自动接听。实际可弹出接听/拒绝界面 acceptCall(contact.userId); } @Override public void onCallAccepted(Contact contact) { Log.i(TAG, "onCallAccepted userId=" + contact.userId); // 通话正式建立，此时才开启采集推流与渲染对端画面 startCallStreams(contact, mCurrentMedia); } @Override public void onCallRejected(Contact contact) { Log.i(TAG, "onCallRejected userId=" + contact.userId); stopCallStreams(contact.userId); } @Override public void onCallTimeout(Contact contact) { Log.i(TAG, "onCallTimeout userId=" + contact.userId); stopCallStreams(contact.userId); } @Override public void onCallHangup(Contact contact) { Log.i(TAG, "onCallHangup userId=" + contact.userId); stopCallStreams(contact.userId); } }; @Override protected void onCreate(@Nullable Bundle savedInstanceState) { super.onCreate(savedInstanceState); // setContentView(R.layout.activity_call); // mLocalView = findViewById(R.id.local_view); // mRemoteView = findViewById(R.id.remote_view); // 请确保已完成 login 登录，并已申请摄像头/麦克风运行时权限 TXIoTCallSession.getInstance().addListener(mCallListener); } // 接听来电（采集推流放到 onCallAccepted 回调中执行） private void acceptCall(String userId) { TXIoTCallSession.getInstance().accept(userId, new TXIoTCallback() { @Override public void onSuccess() { Log.i(TAG, "accept succeed, waiting for onCallAccepted"); } @Override public void onError(int code, String desc) { Log.e(TAG, "accept failed: " + code + " " + desc); } }); } // 通话建立后：根据媒体类型开启采集推流并渲染对端画面 private void startCallStreams(Contact contact, MediaContent media) { TXIoTCallSession session = TXIoTCallSession.getInstance(); if (media == MediaContent.VIDEO || media == MediaContent.AUDIO_VIDEO) { int rc = session.openCamera(true, mLocalView); if (rc != TXIoTError.SUCCESS) { Log.e(TAG, "openCamera failed: " + rc); } session.startRemoteView(contact.userId, mRemoteView); } if (media == MediaContent.AUDIO || media == MediaContent.AUDIO_VIDEO) { int rc = session.openMicrophone(); if (rc != TXIoTError.SUCCESS) { Log.e(TAG, "openMicrophone failed: " + rc); } } } // 主动挂断 private void hangupCall(String userId) { TXIoTCallSession.getInstance().hangup(userId, new TXIoTCallback() { @Override public void onSuccess() { stopCallStreams(userId); } @Override public void onError(int code, String desc) { Log.e(TAG, "hangup failed: " + code + " " + desc); } }); } // 停止采集与渲染，释放资源 private void stopCallStreams(String userId) { TXIoTCallSession session = TXIoTCallSession.getInstance(); if (userId != null) { session.stopRemoteView(userId); } session.closeCamera(); session.closeMicrophone(); } @Override protected void onDestroy() { super.onDestroy(); // 退出通话界面时，务必挂断并释放资源，移除监听 if (mPeerUserId != null) { hangupCall(mPeerUserId); } else { stopCallStreams(null); } TXIoTCallSession.getInstance().removeListener(mCallListener); }}

七、常见问题

八、联系我们

如果你在接入或使用过程中有任何疑问或者建议，欢迎 联系我们 提交反馈。