blob: 3aa2d8809e8821e1c9af8ec0c928e8f772a72719 [file] [log] [blame]
Scott Main7736f962011-12-15 15:40:25 -08001page.title=Managing Audio Playback
Scott Main604e4ed2011-12-13 18:24:34 -08002
3trainingnavtop=true
4startpage=true
5next.title=Controlling Your App's Volume and Playback
6next.link=volume-playback.html
7
8@jd:body
9
10<div id="tb-wrapper">
11<div id="tb">
12
13<h2>Dependencies and prerequisites</h2>
14<ul>
15 <li>Android 2.0 (API level 5) or higher</li>
16 <li>Experience with <a href="{@docRoot}guide/topics/media/mediaplayer.html">Media
17Playback</a></li>
18</ul>
19
20<h2>You should also read</h2>
21<ul>
22 <li><a href="{@docRoot}guide/topics/fundamentals/services.html">Services</a></li>
23</ul>
24
25</div>
26</div>
27
28
29<p>If your app plays audio, it’s important that your users can control the audio in a predictable
30manner. To ensure a great user experience, it’s also important that your app manages the audio focus
31to ensure multiple apps aren’t playing audio at the same time.</p>
32
33<p>After this class, you will be able to build apps that respond to hardware audio key presses,
34which request audio focus when playing audio, and which respond appropriately to changes in audio
35focus caused by the system or other applications.</p>
36
37
38
39
40<h2>Lessons</h2>
41
42<!-- Create a list of the lessons in this class along with a short description of each lesson.
43These should be short and to the point. It should be clear from reading the summary whether someone
44will want to jump to a lesson or not.-->
45
46<dl>
47 <dt><b><a href="volume-playback.html">Controlling Your App’s Volume and
48Playback</a></b></dt>
49 <dd>Learn how to ensure your users can control the volume of your app using the hardware or
50software volume controls and where available the play, stop, pause, skip, and previous media
51playback keys.</dd>
52
53 <dt><b><a href="audio-focus.html">Managing Audio Focus</a></b></dt>
54 <dd>With multiple apps potentially playing audio it's important to think about how they should
55interact. To avoid every music app playing at the same time, Android uses audio focus to moderate
56audio playback. Learn how to request the audio focus, listen for a loss of audio focus, and how to
57respond when that happens.</dd>
58
59 <dt><b><a href="audio-output.html">Dealing with Audio Output Hardware</a></b></dt>
60 <dd>Audio can be played from a number of sources. Learn how to find out where the audio is being
61played and how to handle a headset being disconnected during playback.</dd>
62 </dl>