| <html devsite><head> |
| <title>交互序列示例</title> |
| <meta name="project_path" value="/_project.yaml"/> |
| <meta name="book_path" value="/_book.yaml"/> |
| </head> |
| |
| <body> |
| <!-- |
| Copyright 2018 The Android Open Source Project |
| |
| Licensed under the Apache License, Version 2.0 (the "License"); |
| you may not use this file except in compliance with the License. |
| You may obtain a copy of the License at |
| |
| http://www.apache.org/licenses/LICENSE-2.0 |
| |
| Unless required by applicable law or agreed to in writing, software |
| distributed under the License is distributed on an "AS IS" BASIS, |
| WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| See the License for the specific language governing permissions and |
| limitations under the License. |
| --> |
| |
| <p> |
| 在下列汽车音响示例中,汽车音响主机运行 Android 9,其中安装有收音机应用和导航应用。此外,车辆调谐器在外部布线,并通过扬声器播放。在实际使用场景中,采用如下做法可能会大有好处:将调谐器处理为 Android 的输入,让收音机应用从调谐器中读取数据并将其写入 <code>AudioTrack</code> 对象。 |
| </p> |
| |
| <h2 id="user-starts-radio">用户启动收音机</h2> |
| |
| <p> |
| 在此交互序列中,当用户对收音机应用中的某个预设频率按<strong>播放</strong>时,车辆内不播放任何媒体内容。收音机应用必须获得焦点,然后调谐器才能通过扬声器播放声音。 |
| </p> |
| |
| <p><img src="/devices/automotive/images/audio_auto_focus_radio.png"/></p> |
| <figcaption><strong>图 1.</strong> 收音机获得焦点,然后调谐器通过扬声器播放声音</figcaption> |
| |
| <ol> |
| <li>收音机:“调到 FM 96.5。”</li> |
| <li>收音机:请求焦点 GAIN。</li> |
| <li>AudioManager:授予 GAIN。</li> |
| <li>收音机:<code>createAudioPatch()</code></li> |
| <li>收音机:“播放调谐器输出。”</li> |
| <li>外部布线的调谐器:混音器使调谐器音频路由到放大器。 |
| </li> |
| </ol> |
| |
| <h2 id="radio-ducks-nav-prompt">收音机闪避导航提示</h2> |
| |
| <p> |
| 在此交互序列中,当导航应用为下一个转弯通知生成导航提示时,收音机正在播放内容。导航应用必须先从 <code>AudioManager</code> 获得瞬时焦点,然后才能播放导航提示。 |
| </p> |
| |
| <p><img src="/devices/automotive/images/audio_auto_radio_ducks.png"/></p> |
| <figcaption><strong>图 2.</strong> 收音机播放闪避导航提示</figcaption> |
| |
| <ol> |
| <li value="5">收音机:“播放调谐器输出。”</li> |
| <li>外部布线的调谐器:混音器使调谐器音频路由到放大器。 |
| </li> |
| <li>导航:从 <code>AudioManager</code> 请求焦点 GAIN TRANSIENT。 |
| </li> |
| <li>AudioManager:向导航提供 GAIN TRANSIENT。</li> |
| <li>导航:打开数据流,发送数据包。 |
| <ol> |
| <li>导航:在 bus1 上路由上下文 GUIDANCE。</li> |
| <li>混音器:闪避调谐器,以通过扬声器播放 bus1 GUIDANCE。</li> |
| </ol> |
| </li> |
| <li>导航:通知结束,关闭数据流。</li> |
| <li>导航:放弃焦点。</li> |
| </ol> |
| |
| <p> |
| <code>AudioManager</code> 认为收音机播放可以闪避,并且通常会在不通知收音机应用的情况下对音乐流应用一个闪避因子。不过,通过叠加 <code>framework/base/core/res/res/values/config.xml</code> 并将 <code>config_applyInternalDucking</code> 设置为 <code>false</code>,框架闪避被绕过了,因此,外部调谐器会继续提供声音,并且收音机应用未发现任何变化。混音器(位于 HAL 下游)负责合并这两个输入,并且可以选择是闪避收音机播放,还是将收音机播放移至后置扬声器。 |
| </p> |
| |
| <p> |
| 导航提示播放完毕后,导航应用将释放焦点,收音机播放将恢复。 |
| </p> |
| |
| <h2 id="user-launches-audio-book">用户启动有声读物应用</h2> |
| |
| <p> |
| 在此交互序列中,用户启动有声读物应用,导致收音机播放停止(按流式传输音乐应用中的“播放”是类似的触发器)。 |
| </p> |
| |
| <p><img src="/devices/automotive/images/audio_auto_focus_book.png"/></p> |
| <figcaption><strong>图 3.</strong> 有声读物从收音机播放处夺取焦点</figcaption> |
| |
| <ol> |
| <li value="12">有声读物:从 <code>AudioManager</code> 请求 GAIN 上下文 MEDIA。</li> |
| <li>收音机失去焦点: |
| <ol> |
| <li>AudioManager:LOSS。</li> |
| <li>收音机:<code>releaseAudioPatch()</code></li> |
| </ol> |
| </li> |
| <li>有声读物获得焦点: |
| <ol> |
| <li>授予 GAIN,在 bus0 上路由上下文 MEDIA</li> |
| <li>打开数据流,发送 MEDIA 数据包。</li> |
| </ol> |
| </li> |
| </ol> |
| |
| <p> |
| 有声读物应用发起的焦点请求不是瞬时的,因此上一个焦点持有者(收音机应用)将收到永久性焦点丢失信号;收音机应用会拆除连接到调谐器的补丁程序,以此作为响应。混音器停止接收调谐器信号,并开始处理通过音频 HAL 传输的音频(它还可以选择性地在从收音机过渡到有声读物的过程中执行交错淡出)。 |
| </p> |
| |
| <h2 id="nav-prompt-takes-focus">导航提示获得焦点</h2> |
| |
| <p> |
| 在此交互序列中,当导航应用生成导航提示时,系统正在播放有声读物。 |
| </p> |
| |
| <p><img src="/devices/automotive/images/audio_auto_focus_nav.png"/></p> |
| <figcaption><strong>图 4.</strong> 导航提示从有声读物处夺取焦点</figcaption> |
| |
| <ol> |
| <li value="15">有声读物:正在流式播放 MEDIA 数据包,焦点未并发。</li> |
| <li>导航:请求 GAIN TRANSIENT。</li> |
| <li>AudioManager:LOSS TRANSIENT。</li> |
| <li>有声读物:停止。</li> |
| <li>AudioManager:授予 GAIN TRANSIENT。</li> |
| <li>导航:打开数据流,发送数据包。 |
| <ol> |
| <li>导航:在 bus1 上路由上下文 GUIDANCE。</li> |
| <li>混音器:播放 bus1 (GUIDANCE)。</li> |
| </ol> |
| </li> |
| <li>导航:通知结束,关闭数据流。</li> |
| <li>导航:放弃焦点。</li> |
| <li>有声读物:GAIN。</li> |
| <li>有声读物:重新启动。</li> |
| </ol> |
| |
| <p> |
| 由于有声读物应用的原始 <code>AudioFocusRequest</code>(在启动 <code>AudioTrack</code> 时发送)包含 <code>AUDIOFOCUS_FLAG_PAUSES_ON_DUCKABLE_LOSS</code> 标记,因此 <code>AudioManager</code> 发现无法对有声读物应用进行闪避处理。取而代之的是,<code>AudioManager</code> 会向有声读物应用发送一条 <code>AUDIOFOCUS_LOSS_TRANSIENT</code> 消息,有声读物应用应该通过暂停播放来进行响应。 |
| </p> |
| |
| <p> 导航应用现在可以不间断地播放导航提示。导航提示播放完毕后,有声读物将重新获得焦点并恢复播放。 |
| </p> |
| |
| </body></html> |