sendSEIMessage method Null safety
- {StreamIndex streamIndex = StreamIndex.main,
- required Uint8List message,
- required int repeatCount}
通过视频帧发送 SEI 数据。
在视频通话场景下,SEI 数据会随视频帧发送;在语音通话场景下,SDK 会自动生成一路 16px × 16px 的黑帧视频流用来发送 SEI 数据。
streamIndex 指定携带 SEI 数据的媒体流类型。
语音通话场景下,该值需设为 main,否则 SEI 数据会被丢弃从而无法送达远端。
message 是 SEI 消息内容,长度不超过 4KB。
repeatCount 是消息发送重复次数,取值范围是 [0, 30]。
调用此接口后,SEI 数据会添加到当前视频帧开始的连续 repeatCount 个视频帧中。
返回值:
>=0: 将被添加到视频帧中的 SEI 的数量<0: 发送失败
注意:
- 语音通话场景中,仅支持在内部采集模式下调用该接口发送 SEI 数据,且调用频率需为 15/repeat_count FPS。
- 视频帧仅携带前后 2s 内收到的 SEI 数据;语音通话场景下,若调用此接口后 1min 内未有 SEI 数据发送,则 SDK 会自动取消发布视频黑帧。
- 消息发送成功后,远端会收到 RTCVideoEventHandler.onSEIMessageReceived 回调。
- 语音通话切换至视频通话时,会停止 SEI 数据发送,你需再次调用该接口方可恢复发送。
Implementation
Future<int?> sendSEIMessage(
{StreamIndex streamIndex = StreamIndex.main,
required Uint8List message,
required int repeatCount});