目录
📂 前言
AR 眼镜系统版本
W517 Android9。
系统应用音效
系统应用音效主要包括：通知音效、蓝牙电话音效、点击音效等。
1. 🔱 技术方案
1.1 技术方案概述
系统应用音效都是比较短的，一般采用 Android 推荐的 ogg 格式，直接使用 SoundPool 播放即可。
1.2 实现方案
1）初始化
在适当位置初始化 SoundPool 工具类（比如：在 Activity 的 onCreate 方法中初始化），包括：初始化相应 SoundPool、load 相应音效资源、保存音效资源 ID。
1、初始化相应 SoundPool
private val phoneSP by lazy { SoundPool(20, AudioManager.STREAM_VOICE_CALL, 0) }
private val notifySP by lazy { SoundPool(20, AudioManager.STREAM_NOTIFICATION, 0) }
private val clickSP by lazy { SoundPool(20, AudioManager.STREAM_SYSTEM, 0) }SoundPool 构造第一个参数为 maxStreams，一般设置为1或10，本文设置为20是有一定风险的（主要是为了规避接通蓝牙电话时，点击蓝牙电话接听的系统音效被蓝牙电话音效通道抢占，导致点击蓝牙电话接听的系统音效无法播放的问题）。
SoundPool 构造第二个参数是 streamType 值，具体值的含义可查看附录1。比如：本文的通知音效使用 STREAM_NOTIFICATION，蓝牙电话使用的 STREAM_VOICE_CALL，点击音效使用的 STREAM_SYSTEM。
2、load 相应音效资源，保存音效资源 ID
/**
* 加载音效ID
*/
private var hangupId: Int = -1
private var answerId: Int = -1
private var notifyComeId: Int = -1
private var notifyClearId: Int = -1
private var clickId: Int = -1
fun init(context: Context) {
hangupId = phoneSP.load(context, R.raw.phone_hang_up, 3)
answerId = phoneSP.load(context, R.raw.phone_answer, 3)
notifyComeId = notifySP.load(context, R.raw.notification_message, 1)
notifyClearId = notifySP.load(context, R.raw.notification_clear, 1)
clickId = clickSP.load(context, R.raw.click, 1)
Log.i(TAG, "init: hangupId = $hangupId,answerId = $answerId,notifyComeId = $notifyComeId,notifyClearId = $notifyClearId,clickId = $clickId")
}load 方法的第三个参数为声音的优先级，源码注释为：目前不起作用，默认使用1即可。
2）播放音效
在触发音效播放处调用播放音效，包括播放音效通用方法、播放音效特定封装方法。
1、播放音效通用方法
/**
* 播放音效
*/
fun play(
context: Context,
soundPool: SoundPool,
soundId: Int,
resId: Int,
leftVol: Float = -1f,
rightVol: Float = -1f
) {
...
// soundId：加载的音频资源的 ID。
// leftVolume和rightVolume：左右声道的音量，范围为 0.0（静音）到 1.0（最大音量）。
// priority：播放优先级，一般设为 1。
// loop：是否循环播放，0 表示不循环，-1 表示无限循环。
// rate：播放速率，1.0 表示正常速率，更大的值表示更快的播放速率，0.5 表示慢速播放。
soundPool.play(soundId, leftVol, rightVol, 1, 0, 1.0f)
...
}2、播放音效特定封装方法
fun playHangup(context: Context) {
Log.i(TAG, "playHangup: resId = ${R.raw.phone_hang_up}")
play(context, phoneSP, hangupId, R.raw.phone_hang_up)
}
fun playAnswer(context: Context) {
Log.i(TAG, "playAnswer: resId = ${R.raw.phone_answer}")
play(context, phoneSP, answerId, R.raw.phone_answer)
}
fun playNotifyCome(context: Context) {
Log.i(TAG, "playNotifyCome: resId = ${R.raw.notification_message}")
play(context, notifySP, notifyComeId, R.raw.notification_message)
}
fun playNotifyClear(context: Context) {
Log.i(TAG, "playNotifyClear: resId = ${R.raw.notification_clear}")
play(context, notifySP, notifyClearId, R.raw.notification_clear)
}3）释放资源
在适当位置释放 SoundPool 对象（比如：在 Activity 的 onDestroy 方法中释放资源）
/**
* 释放资源
*/
fun release() {
phoneSP.release()
notifySP.release()
}2. 💠 播放音效
2.1 静音不播放
判断当前系统对应音效是否静音，如果静音则不播放音效。
/**
* 播放音效
*/
fun play(
context: Context,
soundPool: SoundPool,
soundId: Int,
resId: Int,
leftVol: Float = -1f,
rightVol: Float = -1f
) {
// 1.静音不播放
if (isSilent(context)) {
Log.i(TAG, "_play: AudioManager RINGER_MODE_SILENT!")
return
}
...
}
/**
* @return 是否静音
*/
private fun isSilent(context: Context) =
(context.getSystemService(Context.AUDIO_SERVICE) as AudioManager).ringerMode == AudioManager.RINGER_MODE_SILENT2.2 获取音效默认音量
设定音效播放前，先获取到系统音效的默认音量大小，在播放时使用系统音效的默认音量值。
/**
* 播放音效
*/
fun play(
context: Context,
soundPool: SoundPool,
soundId: Int,
resId: Int,
leftVol: Float = -1f,
rightVol: Float = -1f
) {
...
// 2.获取音效默认音量
val volFloat = getVol(context)
...
}
/**
* @return 音效默认音量
*/
private fun getVol(context: Context) = 10.0.pow(
(context.resources.getInteger(com.android.internal.R.integer.config_soundEffectVolumeDb)
.toFloat() / 20).toDouble()
).toFloat()3. ⚛️ 单声道空间音效
3.1 实现方案
-
屏蔽原生 View 点击音效：android:soundEffectsEnabled="false"
-
使用 SoundPool 单独设置左右声道音量，假如只播放右声道，则把左声道音量置为0。
3.2 封装播放单声道空间音效
fun playClickLeft(context: Context) {
Log.i(TAG, "playClickLeft: resId = ${R.raw.click}")
play(context, phoneSP, hangupId, R.raw.click, rightVol = 0f)
}
fun playClickRight(context: Context) {
Log.i(TAG, "playClickRight: resId = ${R.raw.click}")
play(context, phoneSP, hangupId, R.raw.click, 0f)
}
/**
* 播放音效
*/
fun play(
context: Context,
soundPool: SoundPool,
soundId: Int,
resId: Int,
leftVol: Float = -1f,
rightVol: Float = -1f
) {
...
// 2.获取音效默认音量
val volFloat = getVol(context)
val tempLeftVol = if (leftVol != -1f) leftVol else volFloat
val tempRightVol = if (rightVol != -1f) rightVol else volFloat
soundPool.play(soundId, tempLeftVol, tempRightVol, 1, 0, 1.0f)
...
}4. ✅ 小结
对于系统应用音效，本文只是一个基础实现方案，更多业务细节请参考产品逻辑去实现。
另外，由于本人能力有限，如有错误，敬请批评指正，谢谢。
附录1：StreamType 值
/** Used to identify the default audio stream volume */
public static final int STREAM_DEFAULT = -1;
/** Used to identify the volume of audio streams for phone calls */
public static final int STREAM_VOICE_CALL = 0;
/** Used to identify the volume of audio streams for system sounds */
public static final int STREAM_SYSTEM = 1;
/** Used to identify the volume of audio streams for the phone ring and message alerts */
public static final int STREAM_RING = 2;
/** Used to identify the volume of audio streams for music playback */
public static final int STREAM_MUSIC = 3;
/** Used to identify the volume of audio streams for alarms */
public static final int STREAM_ALARM = 4;
/** Used to identify the volume of audio streams for notifications */
public static final int STREAM_NOTIFICATION = 5;
/** Used to identify the volume of audio streams for phone calls when connected on bluetooth */
public static final int STREAM_BLUETOOTH_SCO = 6;
/** Used to identify the volume of audio streams for enforced system sounds in certain
* countries (e.g camera in Japan) */
public static final int STREAM_SYSTEM_ENFORCED = 7;
/** Used to identify the volume of audio streams for DTMF tones */
public static final int STREAM_DTMF = 8;
/** Used to identify the volume of audio streams exclusively transmitted through the
* speaker (TTS) of the device */
public static final int STREAM_TTS = 9;
/** Used to identify the volume of audio streams for accessibility prompts */
public static final int STREAM_ACCESSIBILITY = 10;附录2：音效播放工具源码
/**
* Description: 音效播放工具
* CreateDate: 2024/6/26 15:47
* Author: agg
*/
object SoundPoolTools {
private val TAG = SoundPoolTools::class.java.simpleName
private val phoneSP by lazy { SoundPool(20, AudioManager.STREAM_VOICE_CALL, 0) }
private val notifySP by lazy { SoundPool(20, AudioManager.STREAM_NOTIFICATION, 0) }
private val clickSP by lazy { SoundPool(20, AudioManager.STREAM_SYSTEM, 0) }
/**
* 加载音效ID
*/
private var hangupId: Int = -1
private var answerId: Int = -1
private var notifyComeId: Int = -1
private var notifyClearId: Int = -1
private var clickId: Int = -1
fun init(context: Context) {
hangupId = phoneSP.load(context, R.raw.phone_hang_up, 3)
answerId = phoneSP.load(context, R.raw.phone_answer, 3)
notifyComeId = notifySP.load(context, R.raw.notification_message, 1)
notifyClearId = notifySP.load(context, R.raw.notification_clear, 1)
clickId = clickSP.load(context, R.raw.click, 1)
Log.i(TAG, "init: hangupId = $hangupId,answerId = $answerId,notifyComeId = $notifyComeId,notifyClearId = $notifyClearId,clickId = $clickId")
}
fun playClickLeft(context: Context) {
Log.i(TAG, "playClickLeft: resId = ${R.raw.click}")
play(context, phoneSP, hangupId, R.raw.click, rightVol = 0f)
}
fun playClickRight(context: Context) {
Log.i(TAG, "playClickRight: resId = ${R.raw.click}")
play(context, phoneSP, hangupId, R.raw.click, 0f)
}
fun playHangup(context: Context) {
Log.i(TAG, "playHangup: resId = ${R.raw.phone_hang_up}")
play(context, phoneSP, hangupId, R.raw.phone_hang_up)
}
fun playAnswer(context: Context) {
Log.i(TAG, "playAnswer: resId = ${R.raw.phone_answer}")
play(context, phoneSP, answerId, R.raw.phone_answer)
}
fun playNotifyCome(context: Context) {
Log.i(TAG, "playNotifyCome: resId = ${R.raw.notification_message}")
play(context, notifySP, notifyComeId, R.raw.notification_message)
}
fun playNotifyClear(context: Context) {
Log.i(TAG, "playNotifyClear: resId = ${R.raw.notification_clear}")
play(context, notifySP, notifyClearId, R.raw.notification_clear)
}
/**
* 播放音效
*/
fun play(
context: Context,
soundPool: SoundPool,
soundId: Int,
resId: Int,
leftVol: Float = -1f,
rightVol: Float = -1f
) {
// 1.静音不播放
if (isSilent(context)) {
Log.i(TAG, "_play: AudioManager RINGER_MODE_SILENT!")
return
}
// 2.获取音效默认音量
val volFloat = getVol(context)
val tempLeftVol = if (leftVol != -1f) leftVol else volFloat
val tempRightVol = if (rightVol != -1f) rightVol else volFloat
// 3.播放音效
// soundId：加载的音频资源的 ID。
// leftVolume和rightVolume：左右声道的音量，范围为 0.0（静音）到 1.0（最大音量）。
// priority：播放优先级，一般设为 1。
// loop：是否循环播放，0 表示不循环，-1 表示无限循环。
// rate：播放速率，1.0 表示正常速率，更大的值表示更快的播放速率，0.5 表示慢速播放。
if (soundId != -1) {
Log.i(TAG, "_play: play [direct],soundId = $soundId,resId = $resId")
soundPool.play(soundId, tempLeftVol, tempRightVol, 1, 0, 1.0f)
} else {
Log.i(TAG, "_play: play [load],soundId = $soundId,resId = $resId")
soundPool.load(context, resId, 1)
soundPool.setOnLoadCompleteListener { _, _, _ ->
Log.i(TAG, "_play: play [load -> play],soundId = $soundId,resId = $resId")
soundPool.play(soundId, tempLeftVol, tempRightVol, 1, 0, 1.0f)
}
}
}
/**
* 释放资源
*/
fun release() {
phoneSP.release()
notifySP.release()
}
/**
* @return 是否静音
*/
private fun isSilent(context: Context) =
(context.getSystemService(Context.AUDIO_SERVICE) as AudioManager).ringerMode == AudioManager.RINGER_MODE_SILENT
/**
* @return 音效默认音量
*/
private fun getVol(context: Context) = 10.0.pow(
(context.resources.getInteger(com.android.internal.R.integer.config_soundEffectVolumeDb)
.toFloat() / 20).toDouble()
).toFloat()
}
1004
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
