《Android编程权威指南》音频播放与单元测试（一）

《Android编程权威指南》第 20 章，本章将会学习到单元测试，所谓单元测试就是编写小程序去验证主应用各个单元的独立行为，即测试一个个的类。

一、创建 SoundPool

SoundPool.Builder 可以创建一个 SoundPool 实例。setMaxStreams(Int) 可以指定某个时刻同时播放多少个音频

BeatBox.kt：

...
private const val MAX_SOUNDS = 5
class BeatBox(private val assets: AssetManager) {
    ...
    private val soundPool = SoundPool.Builder().setMaxStreams(MAX_SOUNDS).build()
...
}

已经播放了五个音频时，如果再尝试播放第6个，SoundPool 则会停止播放最早播放的那个音频。还可以使用 setAudioAttributes(AudioAttributes) 指定其他不同音频流属性。

有关 SoundPool 类的文档请参考：

https://developer.android.com/reference/android/media/SoundPool

二、访问 Assets

需要使用 AssetManager 对象去访问并播放音频文件。

val assetPath = sound.assetPath
val assetManger = context.assets
val soundData = assetManger.open(assetPath)

对于有的 API（比如 SoundPool ）需要 FileDescriptor。那么可以转而调用 AssetManager.openFd(String)

三、加载音频文件

使用 SoundPool 加载音频文件，可快速相应，不过它也需要预先加载音频。

先给 Sound 类中添加 soundId 属性，它是个可空类型，在它没有值得时候，可以设置为 null。

class Sound(val assetPath: String, var soundId: Int? = null) {
    val name = assetPath.split("/").last().removeSuffix(WAV)
}

在 BeatBox 中添加 load(Sound) 函数载入音频。

    private fun load(sound: Sound) {
        val afd: AssetFileDescriptor = assets.openFd(sound.assetPath)
        val soundId = soundPool.load(afd, 1)
        sound.soundId = soundId
    }

注意：调用 openFd(String) 函数有可能抛出 IOException，所以代码记得添加抛出异常代码。详情见 Demo。

四、播放音频

在 BeatBox 中添加 play(Sound) 函数。

    fun play(sound: Sound) {
        sound.soundId?.let {
            soundPool.play(it, 1.0f, 1.0f, 1, 0, 1.0f)
        }
    }

上述参数含义依次是：音频ID、左音量、右音量、优先级（无效）、是否循环（0 表示不循环，-1 是无限循环）和播放速率（1 表示常速）。

五、测试依赖

先添加两个测试工具：

Mockito

方便创建模拟对象的Java框架

Github 地址：https://github.com/mockito/mockito

Hamcrest

规则匹配器工具库「JUnit 库里已经自带 Hamcrest」

在 build.gradle 中添加依赖 Mockito 依赖：

    androidTestImplementation 'org.mockito:mockito-core:4.1.0'
    androidTestImplementation 'org.mockito:mockito-inline:4.1.0'

testImplementation 表示依赖项只包括在应用的测试编译里。
创建和配置模拟对象的函数都在 mockito-core 里。mockito-inline 是方便 Mockito 搭配 Kotlin 使用的特殊依赖。

六、创建测试类

打开 SoundViewModel.kt，Command+Shift+T（或Ctrl+Shift+T）

New Test

测试库选择 JUnit4，勾选 setUp/@Before。

创建测试类

androidTest 目录下的都是整合测试类，优点是应用测试所在的运行环境（系统框架和API）和应用发布后运行在设备上的运行环境是一样的。缺点是设置和运行比较耗时，因为是在全功能版本的Android系统上运行。

test 目录下的是单元测试类。单元测试运行在JVM上，可以脱离Android运行时环境，因此速度会快很多。

这里选择 test 目录存放测试类。

test

七、配置测试类

以@Before注解的包含公共代码的函数会在所有测试之前运行一次。按照约定，所有单元测试类都要有一个以@Before注解的setUp()函数。

先创建 SoundViewModel 和 Sound 对象：

class SoundViewModelTest {

    private lateinit var sound: Sound
    private lateinit var subject:SoundViewModel

    @Before
    fun setUp() {
        sound = Sound("assetPath")
        subject = SoundViewModel()
        subject.sound = sound
    }
}

这里用 subject 命名 SoundViewModel 对象的原因是写测试代码的一种约定习惯，方便识别和迁移。

篇一先结束了，学不动啦。继续分两篇，哈哈哈~~~~~~

其他

BeatBox 项目 Demo 地址：

https://github.com/visiongem/AndroidGuideApp/tree/master/BeatBox