AudioManager SDK

Introduction

AudioManager专注于录音相关逻辑的处理，目前举手发言场景和点名发言场景已经使用AudioManager，后续有其他场景要使用到录音相关功能都应使用此类

Dev tips

• AudioManager独立于举手发言场景，它不与举手发言场景耦合，唯一与举手场景耦合的地方时录音结束后发送消息给主播，每个场景发送的逻辑不一样，所以采用接口的方式(post interface)，让调用者实现，此场景下由RaiseManager实现.

• 因为录音相关逻辑涉及到上传和下载的功能，AudioManager专注于录音处理，由于网络框架每个项目都有自己独有的一套，且庞大，所以调用者通过HttpHelper接口，自己实现上传下载的功能,这样保证了扩展又保证了SDK的大小.

• AudioInfo表示录音的消息，里面封装有基本的信息，为了扩展，AudioManager可以传入一个继承于AudioInfo的范型，这样就可以在回调中收到自己定义的录音消息对象，可以储存一些自己定义的信息.

参数及方法介绍:

构建AudioManager 需要传入的参数

• 必要参数
• Context: 上下文
• HttpHelper: 用于上传下载录音的接口，每个应用场景必须自己实现
• 非必要参数
• MaxRecordTime: 单次录音最大录制时间，超时会在AudioListener中回调
• MinRecordTime: 单次录音最小录音时间，超时会在AudioListener中回调
• AudioListener: 录音时的一些信息回调(与MaxRecordTime和MinRecordTime有关)
• StatusListener: 对于录音信息的一些状态回调(录音上传中，播放中，下载失败...)

主要方法

• startRecord: 开始录制语音
• stopRecord: 停止录制语音，将当前录制的语音自动加入到队列中
• cancel: 取消录制
• startUpload: 开始上传录音，指定上传某个录音，也可以自动取队列的首个录音上传，如果上传失败他会在后台自动续传
• download: 下载指定的录音
• addSpeech: AudioManager 自己管理一个用于展示到UI的List,此方法为添加到此列表
• getSpeechList: 获得用于展示到UI的List，比如给RecycleView使用
• play: 播放录音,内部有一个队列，如果在一个录音播放完之前被调用多次，则后面加入的录音都在队列中，等待播放，播放完上一个录音会检测队列，有等待的录音则继续播放下一个
• palySingle: 播放录音，内部没有队列，调用时如果之前的录音还没播放完则停止之前的录音，立即开始现在录音的播放
• stopPlay: 停止播放所有录音
• release: 释放资源

示例代码

    mAudioManager = AudioManager
                .builder()
                .httpHelper(new OkHttpHelper(getActivity()))
                .minRecordTime(2, TimeUnit.SECONDS)
                .with(getActivity())
                .addAudioListener(AudioListener)
                .addStatusListener(StatusListener)
                .build();

详解

AudioInfo structure

AudioListener Introduction

StatusListener Introduction

录音状态信息有变化则会调用此回调(如录音下载成功，失败...)，回调提供一个继承于AudioInfo的范型(可自己指定，便于存放一些自定义消息)以及一个状态码，告诉开发者当前录音的状态

Post Interface

所有应用场景必须实现它，上传成功后便会调用它发送im消息，每个场景自定义自己的逻辑

Executor Interface

此接口是处理自动续传逻辑，即上传失败后，后台保持队列继续上传直到成功，默认实现为HttpExecutor,可以实现Executor Interface自定义自己的自动续传逻辑.

HttpHelper Interface

此接口是上传下载录音的接口，没有默认实现，如果要想上传下载录音必须，自己实现，原因上面已经提及

Audio Interface

AudioManager就实现于此接口，如果你觉得此录音管理类写的太渣了，你完全可以实现此接口重新写相关的逻辑，完全不用改之前的所有代码，此SDK大量使用接口处理扩展和低耦合，后面的场景应该是用此开发模式