3.8.1 及以上版本升级指南

---

在 3.8.1 版本，对以下 API 接口进行废弃变更。

onPublisherSendAudioFirstFrame

废弃了原有的 onPublisherSendAudioFirstFrame 回调接口，替换为同名的 onPublisherSendAudioFirstFrame 回调，并新增通道 channel 参数，支持按推流通道回调相关的事件活动。

• 从原来的

  static void Function()? onPublisherSendAudioFirstFrame;

• 修改为

  static void Function(ZegoPublishChannel channel)? onPublisherSendAudioFirstFrame;

适配方式

• 3.8.1 版本前

  ZegoExpressEngine.onPublisherSendAudioFirstFrame = () {
      // ...
  };

• 3.8.1 版本及以上

  ZegoExpressEngine.onPublisherSendAudioFirstFrame = (channel) {
      // ...
  };

setAudioReceiveRange

废弃了原有的 ZegoRangeAudio 类的成员函数 setAudioReceiveRange 接口，替换为同名的 setAudioReceiveRange 接口，并扩展参数 ZegoReceiveRangeParam 类型，支持设置范围语音的音频接收范围。

• 从原来的

  Future<void> setAudioReceiveRange(double range);

• 修改为

  Future<int> setAudioReceiveRange(ZegoReceiveRangeParam param);

适配方式

• 3.8.1 版本前

  rangeAudio.setAudioReceiveRange(1.0);

• 3.8.1 版本及以上

  var param = ZegoReceiveRangeParam(0.5, 1.0);
  rangeAudio.setAudioReceiveRange(param);

setStreamVocalRange

废弃了原有的 ZegoRangeAudio 类的成员函数 setStreamVocalRange 接口，替换为同名的 setStreamVocalRange 接口，并扩展参数 ZegoVocalRangeParam 类型，支持设置范围语音的单条流发声范围。

• 从原来的

  Future<void> setStreamVocalRange(String streamID, double vocalRange);

• 修改为

  Future<int> setStreamVocalRange(String streamID, ZegoVocalRangeParam param);

适配方式

• 3.8.1 版本前

  rangeAudio.setStreamVocalRange(streamid, 1.0);

• 3.8.1 版本及以上

  var param = ZegoVocalRangeParam(0.5, 1.0);
  rangeAudio.setStreamVocalRange(streamid, param);