物联网开发平台 语音对讲

一、应用端接入

语音对讲需要设备端与应用端协同：设备端负责音频的采集与播放（见下文 设备端接入），应用端则在查看监控期间开启本地麦克风采集，将 APP 语音传输给设备端。如需双向画面，还可同时开启本地摄像头。

注意：开启本地麦克风与摄像头前，请确保已在工程中申请并获取麦克风、摄像头权限，否则 startLocalAudio / startLocalVideo 会返回 ERR_MIC_NOT_AUTHORIZED / ERR_CAMERA_NOT_AUTHORIZED 等错误码。

二、接口说明

三、调用示例

AndroidiOS// 本地麦克风（对讲）session.startLocalAudio();session.muteLocalAudio(false);// session.stopLocalAudio();// 本地摄像头（可选，用于双向视频）TXCloudVideoView localView = findViewById(R.id.local_view);TXIoTVideoEncoderParams params = new TXIoTVideoEncoderParams();params.resolution = TXIoTVideoResolution.RESOLUTION_640_360;session.startLocalVideo(localView, params);// session.stopLocalVideo();// 本地麦克风（对讲）[session startLocalAudio];[session muteLocalAudio:NO];// [session stopLocalAudio];// 本地摄像头（可选，用于双向视频）UIView *localView = self.localVideoView;TXIoTVideoEncoderParams *params = [[TXIoTVideoEncoderParams alloc] init];params.resolution = TXIoTVideoResolution_640_360;[session startLocalVideo:localView videoEncoderParams:params];// [session stopLocalVideo];

四、错误处理

语音对讲需开启本地麦克风与摄像头，以下错误码在对讲过程中可能返回，完整错误码定义见 TXIoTErrorCode。

AndroidiOS

五、步骤 1：注册 on_audio_frame_received 回调

调用 tc_iot_av_init 注册 tc_iot_av_observer_s 时，为 on_audio_frame_received 赋值。APP 端在查看监控期间发起语音对讲时，设备端会通过该回调持续收到音频帧：

#include "tc_iot_av.h"static void on_audio_frame_received(const tc_iot_audio_frame *frame);tc_iot_av_observer_s observer;memset(&observer, 0, sizeof(observer));observer.on_audio_frame_received = on_audio_frame_received;tc_iot_error_e av_rc = tc_iot_av_init(&observer);if (av_rc != TC_IOT_ERR_SUCCESS) { printf("tc_iot_av_init failed: %d\\n", av_rc);}

六、步骤 2：解析音频帧

on_audio_frame_received 回调携带的 tc_iot_audio_frame 结构体字段如下：

注意：说明：

注意：目前 codec 固定为 TC_IOT_AUDIO_CODEC_PCM，无需考虑其他编码格式。

七、步骤 3：将音频数据送入播放器

将 data 指向的 PCM 数据写入设备的本地播放器（扬声器）完成播放。播放器接口由具体硬件平台提供，以下以自定义 speaker_play_pcm 函数表示，请替换为你设备实际的音频输出接口：

// speaker_play_pcm 由业务自行实现，对接具体硬件平台的音频输出接口extern void speaker_play_pcm(const uint8_t *pcm_data, size_t pcm_size);static void on_audio_frame_received(const tc_iot_audio_frame *frame) { if (!frame || !frame->data || frame->data_size == 0) { return; } speaker_play_pcm(frame->data, frame->data_size);}

八、常见问题