06.Android音频焦点
音频音频焦点 (audio focus)
前言
Android 是多任务系统,Audio 系统是竞争资源。在 Android 系统中允许多个应用同时播放音频,例如,我们在播放音乐的时候,点开了一个视频,如果音乐和视频声音混合在一起,这样就会让人不爽;如果,我们在听音乐的时候,收到信息,我们又希望能听到信息的提示音,可以让音乐的声音先降低,在结束音结束后再恢复音量。为了管理音频焦点,Android 引入音频焦点 (audio focus) 这一特性,旨在保证同一时段内只有一个应用可以维持音频聚焦。
音频焦点的良好协作性,主要依赖于应用程序是否遵循音频焦点指南,操作系统没有强制执行音频焦点的规范来约束应用程序,如果应用选择在失去音频焦点后继续大声播放音频,会带来不良的用户体验,可能直接导致应户卸载应用,但这是无法阻止的行为,只能靠开发者自我约束。
常见的音频焦点用例
当你的应用需要播放声音的时候,应该先请求音频聚焦,在获得音频焦点后再播放声音。
用户在使用你的应用播放音频 1 时,打开另一个应用并尝试播放该应用相关的音频 2
- 你的应用不处理音频焦点的情况下
您的音频 1 和另一个应用的音频 2 会重叠播放,用户无法正常听到来自任何应用的音频,这样的用户体验很不友好。 - 您的应用处理了音频焦点的情况下
在另一个应用需要播放音频时,它会请求音频焦点常驻,即音频永久聚焦。一旦系统授权,它便会开始播放音频,这时候您的应用需要响应音频焦点的丢失通知,停止播放。这样用户就只会听到另一个应用的音频。
同样的道理,假如过了五分钟,您的应用需要播放音频,您同样需要申请音频焦点,一旦获得系统授权,我们就可以开始播放音频,其它应用响应音频焦点丢失通知,停止播放。
当您播放音频时候,正好手机来电,需要播放响铃
- 您的应用不处理音频焦点的情况下
手机响铃后,用户会听到铃声和您的手机音频叠加在一起播放。如果用户选择直接挂断电话,您的音频会保持播放。如果用户选择接通电话,他会听到通话声音和您的应用音频叠加在一起播放,挂断通话后您的应用音频会保持播放。无论如何,您的应用音频将全程保持播放状态。这带来的通话体验极差。 - 您的应用处理了音频焦点的情况下
当手机响铃(您还未接通电话),您的应用应该选择相应的回避(这是系统应用的要求)措施来响应短暂的音频焦点丢失。回避的措施可以是把应用的音量降低到百分之二十,也可以是直接暂停播放(如果您的应用是播客类,语音类应用)。
- 如果用户拒绝接听电话,您的应用可以马上采取响应音频焦点的获取,然后做出提高音量或恢复播放的相关操作。
- 如果用户接听了电话,操作系统会发出音频焦点丢失的通知。您的应用应该选择暂停播放,然后在通话结束后恢复播放。
[你的 App 是音乐类] 当后台运行的导航程序正在播报转向语音的时候,你的应用正在播放音乐
- 您的应用不处理音频焦点的情况下
导航语音和音乐混在一起播放将会使用户分心。 - 您的应用处理了音频焦点的情况下
当导航开始播报语音的时候,您的应用需要响应音频焦点丢失,选择回避模式,降低声音。
这里所说的回避模式,没有约束规定,建议您做到把音量调节到百分之二十。有一些特殊的情况,如果应用是有声读物,播客或口语类应用,建议暂停声音播放。
当语音播报完,导航应用会释放掉音频焦点,您的应用可以再次获得音频聚焦,然后恢复到原有音量播放(选择降低音量的回避模式时),或者恢复播放(选择暂停的回避模式时)。
[你的 App 是游戏] 用户在打电话的时候启动游戏(游戏播放音频)
- 您的应用不处理音频焦点的情况下
通话声音和游戏声音的重叠播放同样会让用户的体验非常糟糕。 - 您的应用处理了音频焦点的情况下
在 Android O 中,有一个应对诸如本用例的音频焦点的功能,叫做延迟音频聚焦。
假如当用户在通话中打开游戏,他们想玩游戏,不想听到游戏声音。但是当他们通话结束的时候他们想听到游戏声音(通话应用暂时持有音频焦点)。如果您的应用支持延迟音频聚焦,会发生如下情况:
- 当您的应用申请音频焦点的时候,会被拒绝并锁住,通话应用继续持有音频焦点,您的应用因此不播放音频。因为您的应用是游戏,可以正常继续操作,只是没有声音。
- 当通话结束,您的应用会被授权延迟音频聚焦。这个授权是来自刚才申请音频聚焦被拒绝后锁住的那个请求,它只是被延迟一段时间后再授权给您,此时便可以开始恢复播放。
目前低于 Android O 的版本是不支持延迟音频聚焦这个功能的,所以本用例在其它版本下,应用并不会延迟获得音频焦点。
[后台生成语音的 App] 导航应用或其它能生成音频通知的应用程序
如果您正在开发一款能够在短时间内以突发的方式生成音频的应用程序,类似的应用程序功能如:生成通知声音,提醒声音或一次又一次地在后台生成口语播放的应用程序。
假设您的应用正在后台运行,并且即将生成一些音频。 用户正在收听音乐或播客,而您的应用正好在短时间内生成音频:
在您的应用程序生成音频之前,它应该请求短暂的音频焦点。只有当它被授予焦点时,才能播放音频。优秀的应用程序应该遵守音频焦点的短暂丢失选择降低音量,如果抢占音频焦点的应用程序是播客应用程序,则您可以考虑暂停,直到重新获得音频焦点以恢复播放为止。未能正确请求音频焦点将导致用户同时听到音乐(或播客)和您的应用音频。
[录音 App] 录音应用程序或语音识别应用程序
如果您正在开发一款需要在一段时间内录制音频的应用程序,在这段时间内系统或其他应用程序不应该发出任何声音(通知或其他媒体播放)。
您的应用请求获得的音频焦点,如果是来自于系统授权的,那么便可以安心地开始录制,因为系统了解并确保手机在此期间可能生成或存在的其它音频不会干扰到您的录制。在此期间,来自于其它应用的音频焦点申请都会被系统拒绝。当录制完成记得释放音频焦点,以便系统授权其它应用正常播放声音。
音频焦点处理
处理音频焦点一些规则
- 在开始播放之前,调用 requestAudioFocus() 方法,并检查返回值是否是 AUDIOFOCUS_REQUEST_GRANTED,若成功获取,则开始播放。
- 当 App 失去音频焦点时,根据失去的焦点类型,应该暂停播放,或者将音量调低 (Android8.0,AUDIOFOCUS_GAIN_TRANSIENT_MAY_DUCK 自动降低音量)。
- 当播放结束时,释放音频焦点。
请求音频焦点
只是发出请求,并非直接获取。为了申请到音频聚焦,您必须向系统描述好您的意图。介绍四个常见音频焦点类型:
请求音频焦点类型
AudioManager.AUDIOFOCUS_GAIN 请求长时间音频聚焦
请求的这类音频焦点持续时间是未知的,通常用来表示长时间获取焦点。例如:播放音乐、多媒体播放或者播客等应用。
AudioManager.AUDIOFOCUS_GAIN_TRANSIENT 临时需要音频焦点
请求的音频焦点持续时间比较短,通常用来播放导航路线的声音,或者播放通知声音。例如:电话、QQ、微信等通话应用。
AudioManager.AUDIOFOCUS_GAIN_TRANSIENT_MAY_DUCK 临时需要音频焦点
这个也是表明请求的音频焦点持续时间比较短,但是在这段时间内,它希望其他应用以较低音量继续播放。例如:闹铃,导航 (我们在使用导航的时候可以听音乐,当出现导航语音的时候,音乐音量会降低以便我们能听清楚导航的语音,当导航语音播放完毕后,音乐恢复音量,继续播放) 等应用。
AudioManager.UDIOFOCUS_GAIN_TRANSIENT_EXCLUSIVE 临时需要音频焦点,不需要其他 App 获取焦点
这个也是表明音请求的音频焦点持续时间比较短,但是在这段时间内,不希望任何应用 (包括系统应用) 来做任何与音频相关的事情,就算是降低音量播放音乐也是不被希望的。例如当我们进行录音或者语音识别的时候,我们不希望其他的声音出现干扰。
请求音频焦点代码
Android 8.0(API 级别 26) 以及更高的版本
从 Android 8.0(API 级别 26)开始,当您调用 requestAudioFocus()
时,必须提供 AudioFocusRequest
参数。要释放音频焦点,请调用 abandonAudioFocusRequest()
方法,该方法也接受 AudioFocusRequest 作为参数。在请求和放弃焦点时,应使用相同的 AudioFocusRequest 实例。
要创建 AudioFocusRequest,请使用 AudioFocusRequest.Builder
。由于焦点请求始终必须指定请求的类型,因此此类型会包含在构建器的构造函数中。使用构建器的方法来设置请求的其他字段。
FocusGain 字段为必需字段;所有其他字段均为可选字段:
方法 | 作用 |
---|---|
setFocusGain(int focusGain) | 每个请求中都必须包含此字段。此字段的值与 Android 8.0 之前的 requestAudioFocus() 调用中所使用的 durationHint 值相同:AUDIOFOCUS_GAIN 、 AUDIOFOCUS_GAIN_TRANSIENT 、 AUDIOFOCUS_GAIN_TRANSIENT_MAY_DUCK 或 AUDIOFOCUS_GAIN_TRANSIENT_EXCLUSIVE 。 |
setAudioAttributes(AudioAttributes) | 这个方法是用来描述 app 的使用情况。这方法需要传入一个 AudioAttributes 对象,这个对象也是使用 Builder 模式来构造,例如使用 AudioAttributes.Builder.setUsage() 来描述使用这个音频来干什么,我们可以传入一个 AudioAttributes.USAGE_MEDIA 来表明用这个音频来作为媒体文件来播放,也可以传入一个 AudioAttributes.USAGE_ALARM 来表明用这个来作为闹铃。 |
setWillPauseWhenDucked(boolean pauseOnDuck) | 当其他应用使用 AUDIOFOCUS_GAIN_TRANSIENT_MAY_DUCK 请求焦点时,持有焦点的应用通常不会收到 onAudioFocusChange() 回调,因为系统可以自行降低音量。如果您需要暂停播放而不是降低音量,请调用 setWillPauseWhenDucked(true),然后创建并设置 OnAudioFocusChangeListener,具体如自动降低音量中所述。 |
setAcceptsDelayedFocusGain(boolean acceptsDelayedFocusGain) | 当焦点被其他应用锁定时,对音频焦点的请求可能会失败。此方法可实现延迟获取焦点,即在焦点可用时异步获取焦点。请注意,要使 “ 延迟获取焦点 “ 起作用,您还必须在音频请求中指定 AudioManager.OnAudioFocusChangeListener,因为您的应用必须收到回调才能知道自己获取了焦点。 |
setOnAudioFocusChangeListener(OnAudioFocusChangeListener) | 只有当您在请求中还指定了 willPauseWhenDucked(true) 或 setAcceptsDelayedFocusGain(true) 时,才需要 OnAudioFocusChangeListener。有两个方法可以设置监听器:一个带处理程序参数,一个不带。处理程序是运行监听器的线程。如果您未指定处理程序,则会使用与主 Looper 关联的处理程序。 |
示例代码:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
AudioManager mAudioManager = (AudioManager) mContext.getSystemService(Context.AUDIO_SERVICE);
AudioAttributes mAudioAttributes =
new AudioAttributes.Builder()
.setUsage(AudioAttributes.USAGE_MEDIA)
.setContentType(AudioAttributes.CONTENT_TYPE_MUSIC)
.build();
AudioFocusRequest mAudioFocusRequest =
new AudioFocusRequest.Builder(AudioManager.AUDIOFOCUS_GAIN)
.setAudioAttributes(mAudioAttributes)
.setAcceptsDelayedFocusGain(true)
.setOnAudioFocusChangeListener(...) // Need to implement listener
.build();
int focusRequest = mAudioManager.requestAudioFocus(mAudioFocusRequest);
switch (focusRequest) {
case AudioManager.AUDIOFOCUS_REQUEST_FAILED:
// 不允许播放
case AudioManager.AUDIOFOCUS_REQUEST_GRANTED:
// 开始播放
}
延迟获取焦点
在 Android 8.0 之前,当我们请求音频焦点的时候,只会返回两种结果,要么请求成功 (AUDIOFOCUS_REQUEST_GRANTED
),要么请求失败 (AUDIOFOCUS_REQUEST_FAILED
)。
而从 Android 8.0 开始,还有一种结果,延迟成功请求 (AUDIOFOCUS_REQUEST_DELAYED
),这个也是成功的请求,但是这个请求具有延迟性。例如当我们处于通话状态的时候,我们很显然不希望任何 app 来获取到音频焦点来做些事,例如播放音乐。
然而只有设置过 AudioFocusRequest.Builder.setAcceptsDelayedFocusGain(true)
才能获取到这种结果。获取到了音频焦点呢,当然还需要设置 AudioManager.OnAudioFocusChangeListener
这个音频焦点变化的监听器,通过回调确认何时获取到了音频焦点。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
public void requestPlayback() {
int audioFocus = mAudioManager.requestAudioFocus(mAudioFocusRequest);
switch (audioFocus) {
case AudioManager.AUDIOFOCUS_REQUEST_FAILED:
...
case AudioManager.AUDIOFOCUS_REQUEST_GRANTED:
...
case AudioManager.AUDIOFOCUS_REQUEST_DELAYED:
mAudioFocusPlaybackDelayed = true;
}
}
// 在您 OnAudioFocusChangeListener 的实现,您需要检查 mAudioFocusPlaybackDelayed 这个变量,当您响应 AUDIOFOCUS_GAIN 音频聚焦的时候, 如下所示:
private void onAudioFocusChange(int focusChange) {
switch (focusChange) {
case AudioManager.AUDIOFOCUS_GAIN:
logToUI("Audio Focus: Gained");
if (mAudioFocusPlaybackDelayed || mAudioFocusResumeOnFocusGained) {
mAudioFocusPlaybackDelayed = false;
mAudioFocusResumeOnFocusGained = false;
start();
}
break;
case AudioManager.AUDIOFOCUS_LOSS:
mAudioFocusResumeOnFocusGained = false;
mAudioFocusPlaybackDelayed = false;
stop();
break;
case AudioManager.AUDIOFOCUS_LOSS_TRANSIENT:
mAudioFocusResumeOnFocusGained = true;
mAudioFocusPlaybackDelayed = false;
pause();
break;
case AudioManager.AUDIOFOCUS_LOSS_TRANSIENT_CAN_DUCK:
pause();
break;
}
}
Android 8.0(API 级别 26) 之前
Android O 以下,不需要用到 AudioFocusRequest
1
2
// AudioManager
public int requestAudioFocus(OnAudioFocusChangeListener l, int streamType, int durationHint)
- 参数 1:OnAudioFocusChangeListener 申请成功之后监听 Audio Focus 使用情况的 Listener,后续如果有别的程序要竞争 Audio Focus,都是通过这个 Listener 的 onAudioFocusChange() 方法来通知这个 Audio Focus 的使用者的
- 参数 2:streamType 这个参数和 Android 中的 AudioManager 有关系,涉及到手机上的音频管理策略。
1
2
3
4
5
6
// Android将系统的声音分为以下几类常见的(未写全):
STREAM_ALARM:警告声
STREAM_MUSCI:音乐声,例如music等
STREAM_RING:铃声
STREAM_SYSTEM:系统声音 ,例如低电提示音,锁屏音等
STREAM_VOCIE_CALL:电话声音
- 参数 3:durationHint 用于表明音频焦点的持续时间,这个很关键,它也有许多种类型。
见上面的音频焦点类型
示例代码:
1
2
3
4
5
6
7
8
9
10
11
AudioManager mAudioManager = (AudioManager) mContext.getSystemService(Context.AUDIO_SERVICE);
int focusRequest = mAudioManager.requestAudioFocus(
OnAudioFocusChangeListener, // Need to implement listener
AudioManager.STREAM_MUSIC,
AudioManager.AUDIOFOCUS_GAIN);
switch (focusRequest) {
case AudioManager.AUDIOFOCUS_REQUEST_FAILED:
// don't start playback
case AudioManager.AUDIOFOCUS_REQUEST_GRANTED:
// actually start playback
}
AudioManager.requestAudioFocus() 请求焦点结果值及延迟聚焦
AudioManager.AUDIOFOCUS_REQUEST_GRANTED 表明请求焦点成功
请求 audio focus change 成功
AudioManager.AUDIOFOCUS_REQUEST_FAILED 表明请求焦点失败
请求 audio focus change 失败
“Note: The system will not grant audio focus (AUDIOFOCUS_REQUEST_FAILED) if there is a phone call currently in process and the application will not receive AUDIOFOCUS_GAIN after the call ends.”
AudioManager.AUDIOFOCUS_REQUEST_DELAYED 延迟聚焦
参考:AudioFocusRequest.Builder.setAcceptsDelayedFocusGain(boolean)
响应音频焦点的状态改变
一旦获得音频聚焦,您的应用要马上做出响应,因为它的状态可能在任何时间发生改变(丢失或重新获取),您可以实现 OnAudioFocusChangeListener
的来响应状态改变。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
private final class AudioFocusHelper
implements AudioManager.OnAudioFocusChangeListener {
private void abandonAudioFocus() {
mAudioManager.abandonAudioFocus(this);
}
@Override
public void onAudioFocusChange(int focusChange) {
switch (focusChange) {
case AudioManager.AUDIOFOCUS_GAIN:
if (mPlayOnAudioFocus && !isPlaying()) {
play();
} else if (isPlaying()) {
setVolume(MEDIA_VOLUME_DEFAULT);
}
mPlayOnAudioFocus = false;
break;
case AudioManager.AUDIOFOCUS_LOSS_TRANSIENT_CAN_DUCK:
setVolume(MEDIA_VOLUME_DUCK);
break;
case AudioManager.AUDIOFOCUS_LOSS_TRANSIENT:
if (isPlaying()) {
mPlayOnAudioFocus = true;
pause();
}
break;
case AudioManager.AUDIOFOCUS_LOSS:
mAudioManager.abandonAudioFocus(this);
mPlayOnAudioFocus = false;
stop();
break;
}
}
}
应对焦点丢失
选择在 OnAudioFocusChangeListener 中暂停还是降低音量,取决于您应用的交互方式。在 Android O 上,会自动的帮您降低音量,所以您可以忽略 OnAudioFocusChangeListener 接口的 AUDIOFOCUS_LOSS_TRANSIENT_CAN_DUCK
事件。在 Android O 以下的版本,您需要自己用代码实现。
- AudioManager.AUDIOFOCUS_LOSS 长时间丢失
长时间丢失焦点,当其他应用申请的焦点为 AudioManager.AUDIOFOCUS_GAIN 时,会触发此回调事件;例如播放 QQ 音乐,网易云音乐等,此时应当暂停音频并释放音频相关的资源。 - AudioManager.AUDIOFOCUS_LOSS_TRANSIENT 短暂性丢失焦点
短暂性丢失焦点,当其他应用申请AUDIOFOCUS_GAIN_TRANSIENT
或AUDIOFOCUS_GAIN_TRANSIENT_EXCLUSIVE
时,会触发此回调事件;例如播放短视频,拨打电话等,通常需要暂停音乐播放 - AudioManager.AUDIOFOCUS_LOSS_TRANSIENT_CAN_DUCK 短暂性丢失,可降低音量
短暂性丢失焦点并作降音处理,当其他应用申请AUDIOFOCUS_GAIN_TRANSIENT_MAY_DUCK
时,会触发此回调事件,通常需要降低音量 - AudioManager.AUDIOFOCUS_GAIN
当其他应用申请焦点之后又释放焦点会触发此回调;可重新播放音乐
自动降低音量
在 Android 8.0 之前,如果请求焦点使用了 AudioManager.AUDIOFOCUS_GAIN_TRANSIENT_MAY_DUCK
参数,它表明希望拥有了音频焦点的其他应用降低音量来使用音频,然而并不是所有的应用都会这样做 (有可能开发者忘记了优化),因为这并不是系统强制的。 从 Android8.0 开始,这个降低音量的工作,就是系统默认行为了,可以说是一个良心的优化。
在 Android8.0 及以上,如果不希望系统自动降低音量,而是想自己控制,这个可以通过 AudioFocusRequest.Builder.setWillPauseWhenDucked(true)
方法取消系统的默认行为,然后通过监听音频焦点变化,来自己处理。
释放音频焦点
播放完音频,记得使用 AudioManager.abandonAudioFocus(…)
来释放掉音频焦点
1
2
3
4
5
6
public final void pause() {
if (!mPlayOnAudioFocus) {
mAudioFocusHelper.abandonAudioFocus();
}
onPause();
}
工具类
https://wrichikbasu.github.io/AudioFocusController/
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
public final class AudioFocusController implements AudioManager.OnAudioFocusChangeListener {
private final Context context;
private final boolean pauseWhenDucked;
private final boolean pauseWhenNoisy;
private final int streamType;
private final int durationHint;
private final OnAudioFocusChangeListener listener;
private final AudioManager audioManager;
private final AudioFocusRequest audioFocusRequest;
private boolean focusAbandoned;
private boolean volumeDucked;
private final BroadcastReceiver broadcastReceiver = new BroadcastReceiver() {
@Override
public void onReceive(Context context, Intent intent) {
if (intent.getAction().equals(AudioManager.ACTION_AUDIO_BECOMING_NOISY)) { // wired headset is unplugged
listener.onPause();
abandonFocus();
}
}
};
//-----------------------------------------------------------------------------------------------------------
public interface OnAudioFocusChangeListener {
/**
* Duck the volume.
* <p>
* Will be called if and only if {@link Builder#setPauseWhenAudioIsNoisy(boolean)} is passed
* {@code true}.
* </p>
*/
default void onDecreaseVolume() {
}
/**
* Revive the volume to what it was before ducking.
* <p>
* Will be called if and only if {@link Builder#setPauseWhenAudioIsNoisy(boolean)} is passed
* {@code true}.
* </p>
*/
default void onIncreaseVolume() {
}
/**
* Pause the playback.
*/
void onPause();
/**
* Resume/start the playback.
*/
void onResume();
/**
* request focus failed.
*
* Note: The system will not grant audio focus (AUDIOFOCUS_REQUEST_FAILED) if there is a phone call currently in process and the application will not receive AUDIOFOCUS_GAIN after the call ends.
*/
default void onRequestFocusFailed() {
}
}
//------------------------------------------------------------------------------------------------------------
/**
* Builder class for {@link AudioFocusController} class objects.
*/
public static final class Builder {
private final Context context;
private int usage;
private int contentType;
private boolean acceptsDelayedFocus;
private boolean pauseWhenDucked;
private OnAudioFocusChangeListener listener;
private int stream;
private int durationHint;
private boolean pauseOnAudioNoisy;
//++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
/**
* @param context The {@link Context} that is asking for audio focus.
*/
@SuppressLint("InlinedApi")
public Builder(@NonNull Context context) {
this.context = context;
acceptsDelayedFocus = true;
pauseWhenDucked = false;
pauseOnAudioNoisy = false;
listener = null;
usage = AudioAttributes.USAGE_UNKNOWN; // Android21
durationHint = AudioManager.AUDIOFOCUS_GAIN;
contentType = AudioAttributes.CONTENT_TYPE_UNKNOWN; // Android21
stream = AudioManager.USE_DEFAULT_STREAM_TYPE;
}
//++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
/**
* Sets the attribute describing what is the intended use of the audio signal.
*
* @param usage one of {@link AudioAttributes#USAGE_UNKNOWN}, {@link
* AudioAttributes#USAGE_MEDIA}, {@link AudioAttributes#USAGE_VOICE_COMMUNICATION},
* {@link AudioAttributes#USAGE_VOICE_COMMUNICATION_SIGNALLING}, {@link
* AudioAttributes#USAGE_ALARM}, {@link AudioAttributes#USAGE_NOTIFICATION},
* {@link AudioAttributes#USAGE_NOTIFICATION_RINGTONE}, {@link
* AudioAttributes#USAGE_NOTIFICATION_COMMUNICATION_REQUEST}, {@link
* AudioAttributes#USAGE_NOTIFICATION_COMMUNICATION_INSTANT}, {@link
* AudioAttributes#USAGE_NOTIFICATION_COMMUNICATION_DELAYED}, {@link
* AudioAttributes#USAGE_NOTIFICATION_EVENT}, {@link AudioAttributes#USAGE_ASSISTANT},
* {@link AudioAttributes#USAGE_ASSISTANCE_ACCESSIBILITY}, {@link
* AudioAttributes#USAGE_ASSISTANCE_NAVIGATION_GUIDANCE}, {@link
* AudioAttributes#USAGE_ASSISTANCE_SONIFICATION}, {@link
* AudioAttributes#USAGE_GAME}.
* @return The same Builder instance.
*/
@RequiresApi(api = Build.VERSION_CODES.LOLLIPOP)
public Builder setUsage(int usage) {
this.usage = usage;
return this;
}
//++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
/**
* Sets the attribute describing the content type of the audio signal, such as speech, or
* music.
*
* @param contentType the content type values, one of {@link AudioAttributes#CONTENT_TYPE_MOVIE},
* {@link AudioAttributes#CONTENT_TYPE_MUSIC}, {@link
* AudioAttributes#CONTENT_TYPE_SONIFICATION}, {@link
* AudioAttributes#CONTENT_TYPE_SPEECH}, {@link AudioAttributes#CONTENT_TYPE_UNKNOWN}.
* @return the same Builder instance.
*/
@RequiresApi(api = Build.VERSION_CODES.LOLLIPOP)
public Builder setContentType(int contentType) {
this.contentType = contentType;
return this;
}
//++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
/**
* Sets whether the app will accept delayed focus gain. Default is {@code true}.
*
* @param acceptsDelayedFocus Whether the app accepts delayed focus gain.
* @return The same Builder instance.
*/
public Builder setAcceptsDelayedFocus(boolean acceptsDelayedFocus) {
this.acceptsDelayedFocus = acceptsDelayedFocus;
return this;
}
//++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
/**
* Sets whether the audio will be paused instead of ducking when {@link
* AudioManager#AUDIOFOCUS_LOSS_TRANSIENT_CAN_DUCK} is received. Default is {@code false}.
*
* @param pauseWhenDucked Whether the audio will be paused instead of ducking.
* @return The same Builder instance.
*/
public Builder setPauseWhenDucked(boolean pauseWhenDucked) {
this.pauseWhenDucked = pauseWhenDucked;
return this;
}
//++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
/**
* Sets the {@link OnAudioFocusChangeListener} that will receive callbacks.
*
* @param listener The {@link OnAudioFocusChangeListener} implementation that will receive
* callbacks.
* @return The same Builder instance.
*/
public Builder setAudioFocusChangeListener(@NonNull OnAudioFocusChangeListener listener) {
this.listener = listener;
return this;
}
//++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
/**
* Sets the audio stream for devices lower than Android Oreo.
*
* @param stream The stream that will be used for playing the audio. Should be one of {@link
* AudioManager#STREAM_ACCESSIBILITY}, {@link AudioManager#STREAM_ALARM},
* {@link AudioManager#STREAM_DTMF}, {@link AudioManager#STREAM_MUSIC}, {@link
* AudioManager#STREAM_NOTIFICATION}, {@link AudioManager#STREAM_RING}, {@link
* AudioManager#STREAM_SYSTEM} or {@link AudioManager#STREAM_VOICE_CALL}.
* @return The same Builder instance.
*/
public Builder setStream(int stream) {
this.stream = stream;
return this;
}
//++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
/**
* Sets the duration for which the audio will be played.
*
* @param durationHint The duration hint, one of {@link AudioManager#AUDIOFOCUS_GAIN},
* {@link AudioManager#AUDIOFOCUS_GAIN_TRANSIENT}, {@link
* AudioManager#AUDIOFOCUS_GAIN_TRANSIENT_EXCLUSIVE} or {@link
* AudioManager#AUDIOFOCUS_GAIN_TRANSIENT_MAY_DUCK}.
* @return The same Builder instance.
*/
public Builder setDurationHint(int durationHint) {
this.durationHint = durationHint;
return this;
}
//++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
/**
* Sets whether playback will be paused when audio becomes noisy. Default is {@code false}.
* <p>
* If this function is passed {@code true}, a context-registered broadcast receiver is
* registered for {@link AudioManager#ACTION_AUDIO_BECOMING_NOISY}. When this broadcast is
* received, {@link OnAudioFocusChangeListener#onPause()} will be called, and focus will be
* abandoned.
* </p>
*
* @param value Whether playback will be paused when audio becomes noisy.
* @return The same Builder instance.
*/
public Builder setPauseWhenAudioIsNoisy(boolean value) {
this.pauseOnAudioNoisy = value;
return this;
}
//++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
/**
* Builds a new {@link AudioFocusController} instance combining all the information gathered
* by this {@code Builder}'s configuration methods.
* <p>
* Throws {@link IllegalStateException} when the listener has not been set.
* </p>
*
* @return the {@link AudioFocusController} instance qualified by all the properties set on
* this {@code Builder}.
*/
@NonNull
public AudioFocusController build() {
if (listener == null) {
throw new IllegalStateException("Listener cannot be null.");
}
return new AudioFocusController(this);
}
}
//------------------------------------------------------------------------------------------------------------
private AudioFocusController(Builder builder) {
context = builder.context;
boolean acceptsDelayedFocus = builder.acceptsDelayedFocus;
pauseWhenDucked = builder.pauseWhenDucked;
pauseWhenNoisy = builder.pauseOnAudioNoisy;
listener = builder.listener;
int usage = builder.usage;
int contentType = builder.contentType;
streamType = builder.stream;
durationHint = builder.durationHint;
focusAbandoned = false;
volumeDucked = false;
audioManager = (AudioManager) context.getSystemService(Context.AUDIO_SERVICE);
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
AudioAttributes attributes = new AudioAttributes.Builder()
.setUsage(usage)
.setContentType(contentType)
.build(); // >=Android21
audioFocusRequest = new AudioFocusRequest.Builder(durationHint)
.setAudioAttributes(attributes)
.setWillPauseWhenDucked(pauseWhenDucked)
.setAcceptsDelayedFocusGain(acceptsDelayedFocus)
.setOnAudioFocusChangeListener(this)
.build(); // >=Android26
} else {
audioFocusRequest = null;
}
}
//------------------------------------------------------------------------------------------------------------
/**
* Requests audio focus from the system.
* <p>
* This function should be called every time you want to start/resume playback. If the system
* grants focus, you will get a call in {@link OnAudioFocusChangeListener#onResume()}.
* </p>
* <p>
* If the system issues delayed focus, or rejects the request, then no callback will be issued.
* However, once the system grants full focus after delayed focus has been issued, the {@link
* OnAudioFocusChangeListener#onResume()} method will be called.
* </p>
*/
public void requestFocus() {
int status;
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
status = audioManager.requestAudioFocus(audioFocusRequest);
} else {
status = audioManager.requestAudioFocus(this, streamType, durationHint);
}
if (status == AudioManager.AUDIOFOCUS_REQUEST_GRANTED) {
listener.onResume();
registerReceiver();
focusAbandoned = false;
if (volumeDucked) {
listener.onIncreaseVolume();
volumeDucked = false;
}
} else if (status == AudioManager.AUDIOFOCUS_REQUEST_FAILED) {
listener.onRequestFocusFailed();
}
}
//------------------------------------------------------------------------------------------------------------
/**
* Abandons audio focus.
* <p>
* Call this method every time you stop/pause playback. This will free audio focus for other
* apps.
* </p>
*/
public void abandonFocus() {
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
audioManager.abandonAudioFocusRequest(audioFocusRequest);
} else {
audioManager.abandonAudioFocus(this);
}
focusAbandoned = true;
unregisterReceiver();
}
//------------------------------------------------------------------------------------------------------------
@Override
public void onAudioFocusChange(int focusChange) {
switch (focusChange) {
case AudioManager.AUDIOFOCUS_LOSS:
listener.onPause();
abandonFocus();
unregisterReceiver();
break;
case AudioManager.AUDIOFOCUS_LOSS_TRANSIENT:
listener.onPause();
unregisterReceiver();
break;
case AudioManager.AUDIOFOCUS_LOSS_TRANSIENT_CAN_DUCK:
if (pauseWhenDucked) {
listener.onPause();
unregisterReceiver();
} else {
listener.onDecreaseVolume();
volumeDucked = true;
}
break;
case AudioManager.AUDIOFOCUS_GAIN:
if (volumeDucked) {
volumeDucked = false;
listener.onIncreaseVolume();
} else {
listener.onResume();
registerReceiver();
}
break;
default:
break;
}
}
//------------------------------------------------------------------------------------------------------
/**
* Unregisters the broadcast receiver for {@link AudioManager#ACTION_AUDIO_BECOMING_NOISY}.
*/
private void unregisterReceiver() {
if (pauseWhenNoisy) {
try {
context.unregisterReceiver(broadcastReceiver);
} catch (Exception ignored) {
}
}
}
//------------------------------------------------------------------------------------------------------
/**
* Registers the broadcast receiver for {@link AudioManager#ACTION_AUDIO_BECOMING_NOISY}.
*/
private void registerReceiver() {
if (pauseWhenNoisy) {
IntentFilter intentFilter = new IntentFilter(AudioManager.ACTION_AUDIO_BECOMING_NOISY);
try {
context.registerReceiver(broadcastReceiver, intentFilter);
} catch (Exception ignored) {
}
}
}
}
使用:
1
2
3
4
5
6
7
8
9
10
11
// 创建实例
audioFocusController = new AudioFocusController.Builder(context) // Context must be passed
.setAudioFocusChangeListener(this) // Pass the listener instance created above
.setAcceptsDelayedFocus(true) // Indicate whether you will accept delayed focus
.setPauseWhenAudioIsNoisy(false) // Indicate whether you want to be paused when audio becomes noisy
.setPauseWhenDucked(false) // Indicate whether you want to be paused instead of ducking
.setContentType(AudioAttributes.CONTENT_TYPE_MUSIC) // Set the content type
.setDurationHint(AudioManager.AUDIOFOCUS_GAIN) // Set the duration hint
.setUsage(AudioAttributes.USAGE_MEDIA) // Set the usage
.setStream(AudioManager.STREAM_MUSIC) // Set the stream
.build();
Ref
- android 音视频指南 - 管理音频焦点
https://juejin.im/post/5bda9c15f265da395a1dd57c - Android 音频焦点详解(上)
https://www.jianshu.com/p/5d8d7b677690 - Respecting Audio Focus
https://android-developers.googleblog.com/2013/08/respecting-audio-focus.html
Android 音量控制
调整当前视频音量
- public void setVolume(float leftVolume, float rightVolume)
需要当 MediaPlayer 准备好了,调用才有用;需要在
onPrepared(mp: MediaPlayer?)
中回调设置才有效;setVolume 的取值范围是 0f~1f,这样设置,并不会影响手机本身按钮控制的音量大小
1
MediaPlayer?.setVolume(volume, volume)
VideoView
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
videoView.setOnPreparedListener(new MediaPlayer.OnPreparedListener() {
@Override
public void onPrepared(MediaPlayer mp) {
mediaPlayer = mp;//赋值得到MediaPlayer引用
mp.setVolume(0f, 0f);
}
});
//控制按钮
btn_voice.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
if (mediaPlayer != null) {
if (!slience) {
mediaPlayer.setVolume(0f, 0f);
} else {
mediaPlayer.setVolume(1, 1);
}
slience = !slience;
btn_voice.setText(slience ? "静音" : "有声");
}
}
});
静音播放
1
2
MediaPlayer.setAudioStreamType(AudioManager.STREAM_MUSIC);
MediaPlayer.setVolume(0, 0);
当我们接听电话返回后,会发现静音失效,原本静音播放的视频有声音了!解决这个问题的办法是设置:
1
mMediaPlayer.setAudioStreamType(AudioManager.STREAM_ALARM);使用AudioManager.STREAM_ALARM这种音频模式来实现静音播放!
调整系统音量
监听系统媒体音量变化
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
public class VolumeChangeObserver {
private static final String ACTION_VOLUME_CHANGED = "android.media.VOLUME_CHANGED_ACTION";
private static final String EXTRA_VOLUME_STREAM_TYPE = "android.media.EXTRA_VOLUME_STREAM_TYPE";
private Context mContext;
private OnVolumeChangeListener mOnVolumeChangeListener;
private VolumeReceiver mVolumeReceiver;
private AudioManager mAudioManager;
public static VolumeChangeObserver get(Context context) {
return new VolumeChangeObserver(context);
}
private VolumeChangeObserver(Context context) {
mContext = context;
mAudioManager = (AudioManager) context.getSystemService(Context.AUDIO_SERVICE);
}
public int getCurrentVolume() {
return mAudioManager.getStreamVolume(AudioManager.STREAM_MUSIC);
}
public VolumeChangeObserver registerVolumeReceiver() {
IntentFilter intentFilter = new IntentFilter();
intentFilter.addAction(ACTION_VOLUME_CHANGED);
mVolumeReceiver = new VolumeReceiver(this);
mContext.registerReceiver(mVolumeReceiver, intentFilter);
return this;
}
public void unregisterVolumeReceiver() {
if (mVolumeReceiver != null) mContext.unregisterReceiver(mVolumeReceiver);
mOnVolumeChangeListener = null;
}
public VolumeChangeObserver setOnVolumeChangeListener(OnVolumeChangeListener listener) {
this.mOnVolumeChangeListener = listener;
return this;
}
public interface OnVolumeChangeListener {
void onVolumeChange(int volume);
}
private static class VolumeReceiver extends BroadcastReceiver {
private WeakReference<VolumeChangeObserver> mObserver;
VolumeReceiver(VolumeChangeObserver observer) {
mObserver = new WeakReference<>(observer);
}
@Override
public void onReceive(Context context, Intent intent) {
if (mObserver == null) return;
if (mObserver.get().mOnVolumeChangeListener == null) return;
if (isReceiveVolumeChange(intent)) {
OnVolumeChangeListener listener = mObserver.get().mOnVolumeChangeListener;
listener.onVolumeChange(mObserver.get().getCurrentVolume());
}
}
private boolean isReceiveVolumeChange(Intent intent) {
return intent.getAction() != null
&& intent.getAction().equals(ACTION_VOLUME_CHANGED)
&& intent.getIntExtra(EXTRA_VOLUME_STREAM_TYPE, -1) == AudioManager.STREAM_MUSIC;
}
}
}
AudioManager 控制音量
Android 扫描 SD 卡音乐
注意点
- 需要读 SD 卡权限
- query 时 projection 不要写具体的列名,因为不能的 ROM 可能有的列没有
- 设置过滤条件
- 弊端是依赖于 Android 系统媒体库,有时新增音乐后没有通知系统扫描,就无法获得该音乐的信息,不够灵活。
系统媒体扫描
当 android 的系统启动的时候,系统会自动扫描 sdcard 内的多媒体文件,并把获得的信息保存在一个系统数据库中,以后在其他程序中如果想要访问多媒体文件的信息,其实就是在这个数据库中进行的,而不是直接去 sdcard 中取,理解了这一点以后,问题也随着而来:如果我在开机状态下在 sdcard 内增加、删除一些多媒体文件,系统会不会自动扫描一次呢?答案是否定的,也就是说,当你改变 sdcard 内的多媒体文件时,保存多媒体信息的系统数据库文件是不会动态更新的。
android 系统开始扫描 sdcard 以及扫描完毕时都会发送一个系统广播来表示当前扫描的状态,这样我们就可以很方便通过判断当前的扫描状态加一些自己的逻辑操作
android 操作 sdcard 中的多媒体文件(二)——音乐列表的更
https://blog.csdn.net/MaximusKiang/article/details/31474477
系统媒体库更新
Android 系统每次开机的时候都会过一遍文件,然后根据文件的媒体类型做分类,主要就是视频、音频、图片、文件、安装包、压缩包等等类型的分类,例如视频、图片、音频等信息,手机在使用途中增删改的媒体,在媒体库中基本上是不会自动刷新的。
很多的软件都是在媒体库读取的,如果你的 app 生成的一些媒体,需要在别的地方用到,结果别的软件没有找到,这个就比较尴尬了,所以需要比较及时的更新相关的媒体信息。
媒体库何时更新?
在系统开机或 sdcard 卡被加载时,系统会自动扫描 sdcard,将扫描到的如音频、图片等媒体文件保存到媒体数据库中,通过 Android 提供的相应的 ContentProvider,我们可以获取这些媒体资源;但如果我们在开机状态下,在 sdcard 内增加或删除一些媒体文件时,系统并不会自动扫描,因此媒体库不会更新(除非自行向媒体数据库中添加或删除)
- qq 音乐,网易云音乐这些是监听本地 mp3 文件的变化来实现实时的音乐文件添加删除的。
如果让媒体库更新?
- 三种方法,刷新 Android 的 MediaStore!让你保存的图片立即出现在相册里!
https://juejin.im/post/5ae0541df265da0b9d77e45a#heading-6
扫描 SD 卡指定类型文件
FileScanner 是一个扫描 Android /storage/emulated/0/目录中指定格式的文件。扫描结果会保存在 FileScanner 数据库中
https://github.com/HayDar-Android/FileScanner
code
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
/**
*
<pre>
* author: yangchong
* blog : https://github.com/yangchong211
* time : 2018/01/22
* desc : 本地音乐扫描工具类
* revise: 参考链接:https://www.jianshu.com/p/498c9d06c193
* https://blog.csdn.net/chay_chan/article/details/76984665
* </pre>
*/
public class FileMusicScanManager {
private static FileMusicScanManager mInstance;
private static final long AUDIO_FILTER_SIZE = 5_1024; // 5K
private static final long AUDIO_FILTER_TIME = 1_000; // 1s
private static final Object mLock = new Object();
public static FileMusicScanManager getInstance() {
if (mInstance == null) {
synchronized (mLock) {
if (mInstance == null) {
mInstance = new FileMusicScanManager();
}
}
}
return mInstance;
}
public Observable<List<AudioBean>> scanMusicObservable(Context context) {
return Observable.create(new ObservableOnSubscribe<List<AudioBean>>() {
@Override
public void subscribe(ObservableEmitter<List<AudioBean>> emitter) throws Exception {
List<AudioBean> musicDatas = scanMusic(context);
if (ListUtils.isEmpty(musicDatas)) {
if (!emitter.isDisposed()) {
emitter.onError(new QbException("没有扫描到音乐"));
}
return;
} else {
if (!emitter.isDisposed()) {
emitter.onNext(musicDatas);
}
if (!emitter.isDisposed()) {
emitter.onComplete();
}
}
}
});
}
public int delete(Context context, String path) {
int rowsDel = context.getContentResolver().delete(
MediaStore.Audio.Media.EXTERNAL_CONTENT_URI, MediaStore.Audio.AudioColumns.DATA + " = ?", new String[]{path});
return rowsDel;
}
/**
* ----------------------------------扫描歌曲------------------------------------------------
**/
// 本地音乐过滤条件
private static final String SELECTION = MediaStore.Audio.AudioColumns.SIZE + " >= ? AND " +
MediaStore.Audio.AudioColumns.DURATION + " >= ?";
/**
* 扫描歌曲
*/
@NonNull
public List<AudioBean> scanMusic(Context context) {
List<AudioBean> musicList = new ArrayList<>();
Cursor cursor = context.getContentResolver().query(
MediaStore.Audio.Media.EXTERNAL_CONTENT_URI,
// new String[]{
// BaseColumns._ID,
// MediaStore.Audio.AudioColumns.IS_MUSIC,
// MediaStore.Audio.AudioColumns.TITLE,
// MediaStore.Audio.AudioColumns.ARTIST,
// MediaStore.Audio.AudioColumns.ALBUM,
// MediaStore.Audio.AudioColumns.ALBUM_ID,
// MediaStore.Audio.AudioColumns.DATA,
// MediaStore.Audio.AudioColumns.DISPLAY_NAME,
// MediaStore.Audio.AudioColumns.SIZE,
// MediaStore.Audio.AudioColumns.DURATION
// },
null, // 不为null的话,MIUI10.2查询不到数据
SELECTION,
new String[]{String.valueOf(AUDIO_FILTER_SIZE), String.valueOf(AUDIO_FILTER_TIME)},
MediaStore.Audio.Media.DEFAULT_SORT_ORDER);
if (cursor == null) {
return musicList;
}
int i = 0;
while (cursor.moveToNext()) {
// 是否为音乐,魅族手机上始终为0
int isMusic = cursor.getInt(cursor.getColumnIndex(MediaStore.Audio.AudioColumns.IS_MUSIC));
if (!isFly() && isMusic == 0) {
continue;
}
long id = cursor.getLong(cursor.getColumnIndex(BaseColumns._ID));
String title = cursor.getString((cursor.getColumnIndex(MediaStore.Audio.AudioColumns.TITLE)));
String artist = cursor.getString(cursor.getColumnIndex(MediaStore.Audio.AudioColumns.ARTIST));
String album = cursor.getString((cursor.getColumnIndex(MediaStore.Audio.AudioColumns.ALBUM)));
long albumId = cursor.getLong(cursor.getColumnIndex(MediaStore.Audio.AudioColumns.ALBUM_ID));
long duration = cursor.getLong(cursor.getColumnIndex(MediaStore.Audio.Media.DURATION));
String path = cursor.getString(cursor.getColumnIndex(MediaStore.Audio.AudioColumns.DATA));
String fileName = cursor.getString((cursor.getColumnIndex(MediaStore.Audio.AudioColumns.DISPLAY_NAME)));
long fileSize = cursor.getLong(cursor.getColumnIndex(MediaStore.Audio.Media.SIZE));
AudioBean music = new AudioBean();
music.setId(String.valueOf(id));
music.setType(AudioBean.Type.LOCAL);
music.setTitle(title);
music.setArtist(artist);
music.setAlbum(album);
music.setAlbumId(albumId);
music.setDuration(duration);
music.setPath(path);
music.setFileName(fileName);
music.setFileSize(fileSize);
if (++i <= 20) {
// 只加载前20首的缩略图
// CoverLoader.getInstance().loadThumbnail(music);
}
musicList.add(music);
}
cursor.close();
return musicList;
}
private boolean isFly() {
String flyFlag = getSystemProperty("ro.build.display.id");
return !TextUtils.isEmpty(flyFlag) && flyFlag.toLowerCase().contains("fly");
}
private String getSystemProperty(String key) {
try {
@SuppressLint("PrivateApi")
Class<?> classType = Class.forName("android.os.SystemProperties");
Method getMethod = classType.getDeclaredMethod("get", String.class);
return (String) getMethod.invoke(classType, key);
} catch (Throwable th) {
th.printStackTrace();
}
return null;
}
}
Ref
- 01.如何扫描本地音频或者视频
http://www.jcodecraeer.com/plus/view.php?aid=9305