DJI Mobile SDK Documentation
      包:dji.v5.manager.interfaces
      classSince MSDK 5.0.0

      IMegaphoneManager

      麦克风喊话器负载管理类。可通过此类设置喊话器的参数,播放录制的音频。

      Package dji.v5.manager.interfacesAndroid · Java / Kotlin

      麦克风喊话器负载管理类。可通过此类设置喊话器的参数,播放录制的音频。

      MSDK 5.0.0开始支持

      成员

      33 个成员

      监听

      6

      方法

      17

      枚举

      6

      Class

      4
      method

      addMegaphoneInfoListener

      Since MSDK 5.8.0
      void addMegaphoneInfoListener(MegaphoneInfoListener listener)

      设置喊话器信息监听器。

      参数

      名称类型说明
      listenerMegaphoneInfoListener 喊话器信息监听器。
      method

      removeMegaphoneInfoListener

      Since MSDK 5.8.0
      void removeMegaphoneInfoListener(MegaphoneInfoListener listener)

      移除喊话器信息监听器。

      参数

      名称类型说明
      listenerMegaphoneInfoListener 喊话器信息监听器。
      method

      clearAllMegaphoneInfoListener

      Since MSDK 5.8.0
      void clearAllMegaphoneInfoListener()

      移除所有喊话器信息监听器。

      method

      setMegaphoneIndex

      Since MSDK 5.0.0
      void setMegaphoneIndex(@NonNull MegaphoneIndex megaphoneIndex,@NonNull CommonCallbacks.CompletionCallback callback)

      设置目标喊话器的位置。请根据已连接的喊话器位置进行设置。对于可以支持多个喊话器的机型,可以调用这个接口选择目标喊话器进行设置和操作。如果不调用此接口,MSDK会默认选择一个已连接的喊话器进行操作。

      参数

      名称类型说明
      megaphoneIndex@NonNull MegaphoneIndex 目标喊话器的位置
      callback@NonNull CommonCallbacks.CompletionCallback 返回执行结果的回调。
      method

      getMegaphoneIndex

      Since MSDK 5.0.0
      void getMegaphoneIndex(@NonNull CommonCallbacks.CompletionCallbackWithParam<MegaphoneIndex> callback)

      获取设置的目标喊话器位置。

      参数

      名称类型说明
      callback@NonNull CommonCallbacks.CompletionCallbackWithParam<MegaphoneIndex> 返回执行结果的回调。
      method
      method

      setVolume

      Since MSDK 5.0.0
      void setVolume(@NonNull int volume, @Nullable CommonCallbacks.CompletionCallback callback)

      设置喊话器音量。

      参数

      名称类型说明
      volume@NonNull int 需要设置的音量。
      callback@Nullable CommonCallbacks.CompletionCallback 返回执行结果的回调。
      method
      method

      getVolume

      Since MSDK 5.0.0
      void getVolume(@Nullable CommonCallbacks.CompletionCallbackWithParam<Integer> callback)

      获取喊话器音量。

      参数

      名称类型说明
      callback@Nullable CommonCallbacks.CompletionCallbackWithParam<Integer> 返回执行结果的回调。
      method

      setPlayMode

      Since MSDK 5.0.0
      void setPlayMode(@NonNull PlayMode playMode, @Nullable CommonCallbacks.CompletionCallback callback)

      设置喊话器播放模式。包括单次播放和循环播放。

      参数

      名称类型说明
      playMode@NonNull PlayMode 需要设置的播放模式。
      callback@Nullable CommonCallbacks.CompletionCallback 返回执行结果的回调。
      method

      getPlayMode

      Since MSDK 5.0.0
      void getPlayMode(@Nullable CommonCallbacks.CompletionCallbackWithParam<PlayMode> callback)

      获取喊话器播放模式。

      参数

      名称类型说明
      callback@Nullable CommonCallbacks.CompletionCallbackWithParam<PlayMode> 返回执行结果的回调。
      method

      setWorkMode

      Since MSDK 5.0.0
      void setWorkMode(@NonNull WorkMode workMode,@Nullable CommonCallbacks.CompletionCallback callback)

      设置喊话器工作模式。包括TTS文本模式和语音模式。

      参数

      名称类型说明
      workMode@NonNull WorkMode 需要设置的工作模式。
      callback@Nullable CommonCallbacks.CompletionCallback 返回执行结果的回调。
      method

      getWorkMode

      Since MSDK 5.0.0
      void getWorkMode(@Nullable CommonCallbacks.CompletionCallbackWithParam<WorkMode> callback)

      获取喊话器工作模式。

      参数

      名称类型说明
      callback@Nullable CommonCallbacks.CompletionCallbackWithParam<WorkMode> 返回执行结果的回调。
      method
      method

      getStatus

      Since MSDK 5.0.0
      void getStatus(@Nullable CommonCallbacks.CompletionCallbackWithParam<MegaphoneStatus> callback)

      获取喊话器状态。

      参数

      名称类型说明
      callback@Nullable CommonCallbacks.CompletionCallbackWithParam<MegaphoneStatus> 返回执行结果的回调。
      method
      method

      startPlay

      Since MSDK 5.0.0
      void startPlay(@Nullable CommonCallbacks.CompletionCallback callback)

      喊话器开始播放。在调用开始播放接口之前,你需要调用文件传输方式startPushingFileToMegaphone或者流式传输方式startRealTimeTransmission把需要播放的数据传给喊话器。

      参数

      名称类型说明
      callback@Nullable CommonCallbacks.CompletionCallback 返回执行结果的回调。
      method
      method

      stopPlay

      Since MSDK 5.0.0
      void stopPlay(@Nullable CommonCallbacks.CompletionCallback callback)

      喊话器停止播放。

      参数

      名称类型说明
      callback@Nullable CommonCallbacks.CompletionCallback 返回执行结果的回调。
      method

      startPushingFileToMegaphone

      Since MSDK 5.0.0
      void startPushingFileToMegaphone(@NonNull FileInfo fileInfo, @Nullable CommonCallbacks.CompletionCallbackWithProgress<Integer> callback)

      传输TTS数据或者音频文件到喊话器。当数据传输完成后,你可以调用startPlay 接口进行播放。

      注意
      流式传输模式的数据必须为 OPUS 编码格式的音频数据。如果是 MP3 文件,请用 PCMTools 转换为 OPUS 文件,从 MSDK 5.14.0 版本开始将不再支持通过 DJI 转化的 OPUS 文件。

      参数

      名称类型说明
      fileInfo@NonNull FileInfo 文件信息。
      callback@Nullable CommonCallbacks.CompletionCallbackWithProgress<Integer> 返回执行结果的回调。
      method

      cancelPushingFileToMegaphone

      Since MSDK 5.0.0
      void cancelPushingFileToMegaphone(@Nullable CommonCallbacks.CompletionCallback callback)

      取消传输TTS数据或者音频文件到喊话器。

      参数

      名称类型说明
      callback@Nullable CommonCallbacks.CompletionCallback 返回执行结果的回调。
      method

      startRealTimeTransmission

      Since MSDK 5.0.0
      void startRealTimeTransmission(@Nullable CommonCallbacks.CompletionCallback callback)

      开启流式传输模式。你可以调用sendRealTimeDataToMegaphone向喊话器发送需要播放的数据,调用appendEOFToRealTimeData添加EOF标志位,表示数据发送完毕。然后调用startPlay接口进行播放。

      注意
      流式传输模式的数据必须为OPUS编码格式的音频数据。

      参数

      名称类型说明
      callback@Nullable CommonCallbacks.CompletionCallback 返回执行结果的回调。
      method

      sendRealTimeDataToMegaphone

      Since MSDK 5.0.0
      void sendRealTimeDataToMegaphone(byte[] data, int length, @Nullable CommonCallbacks.CompletionCallback callback)

      向喊话器发送需要播放数据。可以多次调用此接口发送播放数据。

      参数

      名称类型说明
      databyte[] 需要传输的数据,数据必须为OPUS编码格式的音频数据。
      lengthint 数据长度。
      callback@Nullable CommonCallbacks.CompletionCallback 返回执行结果的回调。
      method

      appendEOFToRealTimeData

      Since MSDK 5.0.0
      void appendEOFToRealTimeData(@Nullable CommonCallbacks.CompletionCallback callback)

      添加EOF标志位,表示数据发送完毕。你可以调用startPlay接口进行播放。

      参数

      名称类型说明
      callback@Nullable CommonCallbacks.CompletionCallback 返回执行结果的回调。
      method

      cancelRealTimeTransmission

      Since MSDK 5.0.0
      void cancelRealTimeTransmission(@Nullable CommonCallbacks.CompletionCallback callback)

      取消本次传输,将清空已上传的数据。

      参数

      名称类型说明
      callback@Nullable CommonCallbacks.CompletionCallback 返回执行结果的回调。
      method

      addRealTimeTransmissionStateListener

      Since MSDK 5.0.0
      void addRealTimeTransmissionStateListener(@Nullable RealTimeTransimissionStateListener listener)

      设置流式传输模式的状态监听器。

      参数

      名称类型说明
      listener@Nullable RealTimeTransimissionStateListener 流式传输模式的状态监听器。
      method

      removeRealTimeTransmissionStateListener

      Since MSDK 5.0.0
      void removeRealTimeTransmissionStateListener(@Nullable RealTimeTransimissionStateListener listener)

      移除流式传输模式的状态监听器。

      参数

      名称类型说明
      listener@Nullable RealTimeTransimissionStateListener 流式传输模式的状态监听器。
      method

      clearAllRealTimeTransmissionStateListener

      Since MSDK 5.0.0
      void clearAllRealTimeTransmissionStateListener()

      移除所有流式传输模式的状态监听器。

      enum

      MegaphoneIndex

      Since MSDK 5.0.0

      喊话器位置。

      枚举成员

      名称说明
      PORTSIDE喊话器位于飞行器左舷侧(主)。
      STARBOARD喊话器位于飞行器右舷侧。
      UPSIDE喊话器位于飞行器上侧。
      OSDK喊话器跟OSDK口连接。
      PORT_1喊话器位于飞行器的端口1。
      PORT_2喊话器位于飞行器的端口2。
      PORT_3喊话器位于飞行器的端口3。
      PORT_4喊话器位于飞行器的端口4。
      PORT_5喊话器位于飞行器的端口5。
      PORT_6喊话器位于飞行器的端口6。
      PORT_7喊话器位于飞行器的端口7。
      enum

      WorkMode

      Since MSDK 5.0.0

      喊话器工作模式。包括TTS文本模式和语音模式。

      枚举成员

      名称说明
      TTSTTS模式,输入本文转换成语音进行播放。
      VOICE语音模式,输入语音进行播放。
      REAL_TIME实时喊话模式,仅支持 AS1 喊话器。
      enum

      PlayMode

      Since MSDK 5.0.0

      喊话器播放模式。包括单次播放和循环播放。

      枚举成员

      名称说明
      SINGLE单次播放模式。
      LOOP循环播放模式。
      enum

      MegaphoneStatus

      Since MSDK 5.0.0

      喊话器状态。

      枚举成员

      名称说明
      IDLE喊话器处于空闲状态。
      IN_TRANSMISSION喊话器处于数据传输状态。
      PLAYING喊话器处于数据播放状态。
      IN_EXCEPTION喊话器处于异常状态,请联系设备提供商解决。
      TTS_IN_CONVERSIONTTS正在转换成语音中。
      class

      FileInfo

      Since MSDK 5.0.0
      class FileInfo

      文件传输方式的文件信息类。包括需要传输的类型,数据和文件。

      enum

      UploadType

      Since MSDK 5.0.0

      文件传输方式的传输的类型。包括本地音频文件数据和TTS二进制数据。

      枚举成员

      名称说明
      TTS_DATATTS二进制数据类型,TTS二进制数据需要采用UTF-8格式。设置为此类型,你需要调用setData设置TTS二进制数据。
      VOICE_FILE本地音频文件类型,音频文件需要采用OPUS编码格式。设置为此类型,你需要调用setFile设置本地音频文件路径。
      class

      RealTimeTransimissionStateListener

      Since MSDK 5.0.0
      interface RealTimeTransimissionStateListener

      流式传输模式的状态监听器。

      enum

      UploadState

      Since MSDK 5.0.0

      流式传输模式上传状态。

      枚举成员

      名称说明
      UPLOADING上传中。
      UPLOAD_SUCCESS上传成功。
      UPLOAD_FAILED上传失败,请重新上传。
      MD5_FAILEDMD5校验失败。
      ABORTED上传终止。
      class

      MegaphoneInfoListener

      Since MSDK 5.8.0
      interface MegaphoneInfoListener

      喊话器信息监听器。

      class

      MegaphoneInfo

      Since MSDK 5.0.0
      class MegaphoneInfo

      喊话器信息类,包含喊话器的音量,播放模式,工作模式,状态等。