diff options
| author | Android Partner Docs <noreply@android.com> | 2017-04-06 19:19:47 +0000 |
|---|---|---|
| committer | Billy Lamberta <blamb@google.com> | 2017-04-06 20:55:22 +0000 |
| commit | 57543d44f076d1c15dac45c46158894aabaf9a82 (patch) | |
| tree | 6b91f86e2c8c22452bd3f9761455e9e775d3fd12 /en/devices/audio | |
| parent | 126616c1a409b70b4eeef1db490b62b67286b97c (diff) | |
| download | source.android.com-57543d44f076d1c15dac45c46158894aabaf9a82.tar.gz | |
Docs: Changes to source.android.com
- 152411974 Docs: Update README for external contributors. by blamb <blamb@google.com>
- 152401265 Mention full OTA images and Pixel devices. While I'm the... by Android Partner Docs <noreply@android.com>
- 152397484 Docs: Updated March bulletin with researcher attribution by daroberts <daroberts@google.com>
- 152302149 Docs: Update the April 2017 security bulletin with AOSP l... by daroberts <daroberts@google.com>
- 152301640 Add tags for April Security Release and Nougat MR2 Release. by Android Partner Docs <noreply@android.com>
- 152291247 Docs: Add reports directory and its contents to SAC by daroberts <daroberts@google.com>
- 152205728 Docs: Remove summary table from all security bulletins by daroberts <daroberts@google.com>
- 152203208 Docs: Fixes and updates to A/B System Updates page. by blamb <blamb@google.com>
- 152190600 Update CTS download page for new releases. by mheco <mheco@google.com>
- 152185401 Docs: Update April bulletin to remove the summary table a... by daroberts <daroberts@google.com>
- 152164401 Docs: Update TradeFed setup instructions. Remove sections by blamb <blamb@google.com>
- 152155438 Docs: Update CTS docs to add subplans. by gdimino <gdimino@google.com>
- 152068791 Moves some google3 files in place to sync SAC to AOSP by blamb <blamb@google.com>
- 152053072 Docs: Updating namespace image, removing extra </a> tag by hvm <hvm@google.com>
- 152038148 Add April 2017 bulletin to 2017 index page by daroberts <daroberts@google.com>
- 152023759 Docs: Publish April 2017 Android Security Bulletin by daroberts <daroberts@google.com>
- 151766077 Docs: Update researcher credit in March 2017 security bul... by daroberts <daroberts@google.com>
- 151766001 Docs: Replace developer preview link in APK signing docs by daroberts <daroberts@google.com>
- 151765965 Docs: Add Pixel help center link to Security overview. by daroberts <daroberts@google.com>
- 151765930 Docs: Hyphenate full-disk encryption by daroberts <daroberts@google.com>
- 151765822 Update link on August 2015 bulletin by daroberts <daroberts@google.com>
- 151656779 Docs: Draft article explaining changes to site, link from... by claym <claym@google.com>
- 151594548 Create script to easily update tradefed reference docs. by blamb <blamb@google.com>
- 151494072 Docs: Updating block number image by hvm <hvm@google.com>
- 151490518 Docs: Added ref. to "seamless updates." by gdimino <gdimino@google.com>
- 151470674 Docs: Restore three-column formatting for resources. by gdimino <gdimino@google.com>
- 151469370 Docs: Removing unnecessary introduction header, changing ... by hvm <hvm@google.com>
- 151469335 Docs: Removing unnecessary Introduction header, tweaked o... by hvm <hvm@google.com>
- 151467567 Docs: Fixing minor HTML errors, adding "and later" for An... by hvm <hvm@google.com>
- 151466843 Docs: Several tweaks to fix html errors, code examples, c... by hvm <hvm@google.com>
- 151466070 Docs: Fixing sentence casing on header by hvm <hvm@google.com>
- 151466032 Docs: Adding "and later" to Android 7.0 by hvm <hvm@google.com>
- 151451199 Docs: Adding "and later" for Android 7.0, minor sentence ... by hvm <hvm@google.com>
- 151451181 Docs: Adding "and later" for Android 7.0, removing unnece... by hvm <hvm@google.com>
- 151389549 Docs: Adding the stub pages for config and connect back t... by gdimino <gdimino@google.com>
- 151388944 Docs: Fix link to rules file with new file extension by claym <claym@google.com>
- 151384072 Docs: tweaking Android 7.0 references by hvm <hvm@google.com>
- 151384049 Docs: Android "and later" fixes, eMMc fix by hvm <hvm@google.com>
- 151373905 Docs: Fixing code example, tweaking Android 6.0 requireme... by hvm <hvm@google.com>
- 151373871 Docs: Adding caution class to Important note by hvm <hvm@google.com>
- 151373823 Docs: Removing unnecessary Introduction heading and tweak... by hvm <hvm@google.com>
- 151372009 Format code strings as <code> by mheco <mheco@google.com>
- 151343808 Add redirects for reference material. by gdimino <gdimino@google.com>
- 151339034 Update tradefed reference using latest templates. by blamb <blamb@google.com>
- 151149894 Added prettyprint to code sample <pre> tags. by gdimino <gdimino@google.com>
- 151066250 Docs: Add Jack deprecation notice. by gdimino <gdimino@google.com>
- 151054182 Docs: fixing bad break in the note (commands need to be p... by hvm <hvm@google.com>
- 151054160 Docs: Removed space before period. by hvm <hvm@google.com>
- 151050483 Docs: Compress new graphic. by gdimino <gdimino@google.com>
- 151037146 Final transfer of content for the Devices (Porting) tab. by gdimino <gdimino@google.com>
- 150941507 Docs: Add Security YIR 2016 link to updates and resources by daroberts <daroberts@google.com>
- 150934390 docs: Add code formating to class names. by blamb <blamb@google.com>
- 150932627 Removing unnecessary dessert name by hvm <hvm@google.com>
- 150915298 Docs: Fix path to Audio Latency Measurements by appending... by claym <claym@google.com>
- 150712855 Docs: Reduce size of landing page images to better fit on... by claym <claym@google.com>
- 150692205 Add png to replace Google chart, which is not working in ... by gdimino <gdimino@google.com>
- 150676489 Final transfer content for the Security tab. by gdimino <gdimino@google.com>
- 150674990 Final transfer of content for Devices > Tech (now Tuning)... by gdimino <gdimino@google.com>
- 150666311 Final transfer of legal and license info. by gdimino <gdimino@google.com>
- 150661775 Typo fixes to the Devices > Tech (Tuning) nav. by gdimino <gdimino@google.com>
- 150652579 Final transfer of content for the Source tab. by gdimino <gdimino@google.com>
- 150498952 Docs: Begin improvements to SAC landing page in DevSite by claym <claym@google.com>
- 150490567 Fix: Bluetooth directory shouldn't be in reference/ by blamb <blamb@google.com>
- 150484362 TradeFed javadocs building with doclava-on-devsite. by blamb <blamb@google.com>
- 150477923 Nav typo fixes for Security tab. by gdimino <gdimino@google.com>
- 150466023 SAC-on-devsite landing page for /reference. by blamb <blamb@google.com>
- 150394084 Adds a CSS style to doclava-devsite.css to fix indention ... by blamb <blamb@google.com>
- 150332749 Nav typo fixes. by gdimino <gdimino@google.com>
- 150332594 Final transfer of /images directory. by gdimino <gdimino@google.com>
- 150237391 Another typo fix in a _toc.yaml file. by gdimino <gdimino@google.com>
- 150227248 Create robots.txt files for source.android.com, developer... by Android Partner Docs <noreply@android.com>
- 150127703 Docs: Fix typo by gdimino <gdimino@google.com>
- 150117532 Docs: Changing name of two upper tabs. by gdimino <gdimino@google.com>
- 150080135 First cut at navs for source.android.com on devsite. by gdimino <gdimino@google.com>
- 149483579 Converting existing HAL reference html files generated fr... by blamb <blamb@google.com>
- 148786494 Switch DAC and SAC to the new Android-green favicon. www.... by Android Partner Docs <noreply@android.com>
- 147614869 Update favicons for developer.android.com and source.andr... by Android Partner Docs <noreply@android.com>
- 147188667 Create a color scheme for android sites using the Android... by Android Partner Docs <noreply@android.com>
- 146299182 Add basic toc skeleton that mirrors existing SAC toc. Mos... by blamb <blamb@google.com>
PiperOrigin-RevId: 152411974
Change-Id: Ibe0e9020dc3035ff4db893be332e8f63d08bde04
Diffstat (limited to 'en/devices/audio')
41 files changed, 649 insertions, 647 deletions
diff --git a/en/devices/audio/attributes.html b/en/devices/audio/attributes.html index 0f4beefe..b685e8bf 100644 --- a/en/devices/audio/attributes.html +++ b/en/devices/audio/attributes.html @@ -1,28 +1,27 @@ -page.title=Audio Attributes -@jd:body - -<!-- - Copyright 2014 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. ---> -<div id="qv-wrapper"> - <div id="qv"> - <h2>In this document</h2> - <ol id="auto-toc"> - </ol> - </div> -</div> +<html devsite> + <head> + <title>Audio Attributes</title> + <meta name="project_path" value="/_project.yaml" /> + <meta name="book_path" value="/_book.yaml" /> + </head> + <body> + <!-- + Copyright 2017 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>Audio players support attributes that define how the audio system handles routing, volume, and focus decisions for the specified source. Applications can attach attributes to an audio playback @@ -255,3 +254,6 @@ releases.</p> <p class="note"><strong>Note:</strong> @hide streams are used internally by the framework but are not part of the public API.</p> + + </body> +</html> diff --git a/en/devices/audio/avoiding_pi.html b/en/devices/audio/avoiding_pi.html index 602c545b..26a68b07 100644 --- a/en/devices/audio/avoiding_pi.html +++ b/en/devices/audio/avoiding_pi.html @@ -1,28 +1,27 @@ -page.title=Avoiding Priority Inversion -@jd:body - -<!-- - Copyright 2013 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. ---> -<div id="qv-wrapper"> - <div id="qv"> - <h2>In this document</h2> - <ol id="auto-toc"> - </ol> - </div> -</div> +<html devsite> + <head> + <title>Avoiding Priority Inversion</title> + <meta name="project_path" value="/_project.yaml" /> + <meta name="book_path" value="/_book.yaml" /> + </head> + <body> + <!-- + Copyright 2017 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> This article explains how the Android's audio system attempts to avoid @@ -336,3 +335,6 @@ in ordinary non-time-critical use cases. But between high- and low-priority tasks and in time-sensitive systems mutexes are more likely to cause trouble. </p> + + </body> +</html> diff --git a/en/devices/audio/data_formats.html b/en/devices/audio/data_formats.html index b04f85bc..e11a1abf 100644 --- a/en/devices/audio/data_formats.html +++ b/en/devices/audio/data_formats.html @@ -1,29 +1,27 @@ -page.title=Data Formats -@jd:body +<html devsite> + <head> + <title>Data Formats</title> + <meta name="project_path" value="/_project.yaml" /> + <meta name="book_path" value="/_book.yaml" /> + </head> + <body> + <!-- + Copyright 2017 The Android Open Source Project -<!-- - Copyright 2015 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 - 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 - 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. + --> - 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. ---> -<div id="qv-wrapper"> - <div id="qv"> - <h2>In this document</h2> - <ol id="auto-toc"> - </ol> - </div> -</div> <p> Android uses a wide variety of audio @@ -187,7 +185,7 @@ The major Android formats for audio are listed in the table below: <tr> <th></th> - <th colspan="5"><center>Notation</center></th> + <th colspan="6"><center>Notation</center></th> </tr> <tr> @@ -403,3 +401,6 @@ Lossless conversions permit Conversions from fixed point representation with 25 or fewer significant bits to floating point are lossless. Conversions from floating point to any common fixed point representation are lossy. </p> + + </body> +</html> diff --git a/en/devices/audio/debugging.html b/en/devices/audio/debugging.html index 3568f4cf..9f8efb79 100644 --- a/en/devices/audio/debugging.html +++ b/en/devices/audio/debugging.html @@ -1,28 +1,27 @@ -page.title=Audio Debugging -@jd:body +<html devsite> + <head> + <title>Audio Debugging</title> + <meta name="project_path" value="/_project.yaml" /> + <meta name="book_path" value="/_book.yaml" /> + </head> + <body> + <!-- + Copyright 2017 The Android Open Source Project -<!-- - Copyright 2013 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 - 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. + --> - 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. ---> -<div id="qv-wrapper"> - <div id="qv"> - <h2>In this document</h2> - <ol id="auto-toc"> - </ol> - </div> -</div> <p> This article describes some tips and tricks for debugging Android audio. @@ -447,3 +446,6 @@ in the main <code>logcat</code>, showing all the logs leading up to the crash. <pre> $ dumpsys media.log </pre> + + </body> +</html> diff --git a/en/devices/audio/images/ape_audio_tv_hdmi_tuner.png b/en/devices/audio/images/ape_audio_tv_hdmi_tuner.png Binary files differindex 3a5d8324..605c3b88 100644 --- a/en/devices/audio/images/ape_audio_tv_hdmi_tuner.png +++ b/en/devices/audio/images/ape_audio_tv_hdmi_tuner.png diff --git a/en/devices/audio/images/ape_audio_tv_tif.png b/en/devices/audio/images/ape_audio_tv_tif.png Binary files differindex cfdf97f6..79e557cb 100644 --- a/en/devices/audio/images/ape_audio_tv_tif.png +++ b/en/devices/audio/images/ape_audio_tv_tif.png diff --git a/en/devices/audio/images/ape_audio_tv_tuner.png b/en/devices/audio/images/ape_audio_tv_tuner.png Binary files differindex 96fb5441..82407914 100644 --- a/en/devices/audio/images/ape_audio_tv_tuner.png +++ b/en/devices/audio/images/ape_audio_tv_tuner.png diff --git a/en/devices/audio/images/ape_fwk_audio.png b/en/devices/audio/images/ape_fwk_audio.png Binary files differindex 9059a623..463b5a44 100644 --- a/en/devices/audio/images/ape_fwk_audio.png +++ b/en/devices/audio/images/ape_fwk_audio.png diff --git a/en/devices/audio/images/ape_fwk_hal_audio.png b/en/devices/audio/images/ape_fwk_hal_audio.png Binary files differindex fa6c47a6..1b1ec95c 100644 --- a/en/devices/audio/images/ape_fwk_hal_audio.png +++ b/en/devices/audio/images/ape_fwk_hal_audio.png diff --git a/en/devices/audio/images/audio_hal.png b/en/devices/audio/images/audio_hal.png Binary files differindex 273ac815..4f519aad 100644 --- a/en/devices/audio/images/audio_hal.png +++ b/en/devices/audio/images/audio_hal.png diff --git a/en/devices/audio/images/dac.png b/en/devices/audio/images/dac.png Binary files differindex a13027cc..068d8ae7 100644 --- a/en/devices/audio/images/dac.png +++ b/en/devices/audio/images/dac.png diff --git a/en/devices/audio/images/loopback_circuit.png b/en/devices/audio/images/loopback_circuit.png Binary files differindex 4c47e53a..48cb86b1 100644 --- a/en/devices/audio/images/loopback_circuit.png +++ b/en/devices/audio/images/loopback_circuit.png diff --git a/en/devices/audio/images/medialog_after.png b/en/devices/audio/images/medialog_after.png Binary files differindex 0c162252..c9fd3f56 100644 --- a/en/devices/audio/images/medialog_after.png +++ b/en/devices/audio/images/medialog_after.png diff --git a/en/devices/audio/images/medialog_before.png b/en/devices/audio/images/medialog_before.png Binary files differindex 928d2f3c..be523c94 100644 --- a/en/devices/audio/images/medialog_before.png +++ b/en/devices/audio/images/medialog_before.png diff --git a/en/devices/audio/images/round-trip-latencies.png b/en/devices/audio/images/round-trip-latencies.png Binary files differnew file mode 100644 index 00000000..4aaa3186 --- /dev/null +++ b/en/devices/audio/images/round-trip-latencies.png diff --git a/en/devices/audio/images/round_trip.png b/en/devices/audio/images/round_trip.png Binary files differindex 663552c4..38ebd4e5 100644 --- a/en/devices/audio/images/round_trip.png +++ b/en/devices/audio/images/round_trip.png diff --git a/en/devices/audio/images/round_trip_bar_graph.png b/en/devices/audio/images/round_trip_bar_graph.png Binary files differindex 3dc24843..915f1eaf 100644 --- a/en/devices/audio/images/round_trip_bar_graph.png +++ b/en/devices/audio/images/round_trip_bar_graph.png diff --git a/en/devices/audio/images/round_trip_on_device.png b/en/devices/audio/images/round_trip_on_device.png Binary files differindex e1cf0a2a..94c03c40 100644 --- a/en/devices/audio/images/round_trip_on_device.png +++ b/en/devices/audio/images/round_trip_on_device.png diff --git a/en/devices/audio/images/round_trip_via_headset_connector.png b/en/devices/audio/images/round_trip_via_headset_connector.png Binary files differindex 5791cf51..bf3e8834 100644 --- a/en/devices/audio/images/round_trip_via_headset_connector.png +++ b/en/devices/audio/images/round_trip_via_headset_connector.png diff --git a/en/devices/audio/images/venn.png b/en/devices/audio/images/venn.png Binary files differindex 1db4f53a..148cb4d5 100644 --- a/en/devices/audio/images/venn.png +++ b/en/devices/audio/images/venn.png diff --git a/en/devices/audio/implement-policy.html b/en/devices/audio/implement-policy.html index ae6ede2a..16cd0820 100644 --- a/en/devices/audio/implement-policy.html +++ b/en/devices/audio/implement-policy.html @@ -1,28 +1,27 @@ -page.title=Configuring Audio Policies -@jd:body - -<!-- - Copyright 2016 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. ---> -<div id="qv-wrapper"> - <div id="qv"> - <h2>In this document</h2> - <ol id="auto-toc"> - </ol> - </div> -</div> +<html devsite> + <head> + <title>Configuring Audio Policies</title> + <meta name="project_path" value="/_project.yaml" /> + <meta name="book_path" value="/_book.yaml" /> + </head> + <body> + <!-- + Copyright 2017 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 7.0 introduces a new audio policy configuration file format (XML) for describing your audio topology.</p> @@ -77,16 +76,9 @@ shows many of these features in use.</p> XML file format, view the example below.</p> <p> -<div class="toggle-content closed"> - <p><a href="#" onclick="return toggleContent(this)"> - <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-content-img" /> - <strong><span class="toggle-content-text">Show audio policy example</span> - <span class="toggle-content-text" style="display:none;">Hide audio policy - example</span></strong> - </a></p> - - <div class="toggle-content-toggleme"> -<pre class="prettyprint"> + <section class="expandable"> + <h4 class="showalways">Show audio policy example</h4> +<pre> <?xml version="1.0" encoding="UTF-8" standalone="yes"?> <audioPolicyConfiguration version="1.0" xmlns:xi="http://www.w3.org/2001/XInclude"> <globalConfiguration speaker_drc_enabled="true"/> @@ -146,7 +138,7 @@ XML file format, view the example below.</p> <xi:include href="audio_policy_volumes.xml"/> <xi:include href="default_volume_tables.xml"/> </audioPolicyConfiguration> -</pre></div></div> +</pre></section> </p> <p>The top level structure contains modules that correspond to each audio HAL @@ -166,15 +158,8 @@ form a UI index to a volume in dB. A separate include file provides default curves, but each curve for a given use case and device category can be overwritten.</p> -<div class="toggle-content closed"> - <p><a href="#" onclick="return toggleContent(this)"> - <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-content-img" /> - <strong><span class="toggle-content-text">Show volume table example</span> - <span class="toggle-content-text" style="display:none;">Hide volume table - example</span></strong> - </a></p> - - <div class="toggle-content-toggleme"> + <section class="expandable"> + <h4 class="showalways">Show volume table example</h4> <p><pre> <?xml version="1.0" encoding="UTF-8"?> <volumes> @@ -193,17 +178,10 @@ overwritten.</p> <point>100,0</point> </reference> </volumes> -</pre></p></div></div> +</pre></p></section> -<div class="toggle-content closed"> - <p><a href="#" onclick="return toggleContent(this)"> - <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-content-img" /> - <strong><span class="toggle-content-text">Show volumes example</span> - <span class="toggle-content-text" style="display:none;">Hide volumes - example</span></strong> - </a></p> - - <div class="toggle-content-toggleme"> + <section class="expandable"> + <h4 class="showalways">Show volumes example</h4> <p><pre> <?xml version="1.0" encoding="UTF-8"?> <volumes> @@ -277,7 +255,7 @@ overwritten.</p> <volume stream="AUDIO_STREAM_PATCH" deviceCategory="DEVICE_CATEGORY_EARPIECE" ref="FULL_SCALE_VOLUME_CURVE"/> <volume stream="AUDIO_STREAM_PATCH" deviceCategory="DEVICE_CATEGORY_EXT_MEDIA" ref="FULL_SCALE_VOLUME_CURVE"/> </volumes> -</pre></p></div></div> +</pre></p></section> <h2 id=file_inclusions>File inclusions</h2> <p>The XML Inclusions (XInclude) method can be used to include audio policy @@ -442,5 +420,8 @@ support multichannel audio.</p> <p>Ensure the audio codecs your hardware and drivers support are properly declared for your product. For details, see -<a href="{@docRoot}devices/media/index.html#expose">Exposing Codecs to the +<a href="/devices/media/index.html#expose">Exposing Codecs to the Framework</a>.</p> + + </body> +</html> diff --git a/en/devices/audio/implement-pre-processing.html b/en/devices/audio/implement-pre-processing.html index ab6cfa9b..e42dfc1c 100644 --- a/en/devices/audio/implement-pre-processing.html +++ b/en/devices/audio/implement-pre-processing.html @@ -1,28 +1,27 @@ -page.title=Configuring Pre-Processing Effects -@jd:body - -<!-- - Copyright 2016 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. ---> -<div id="qv-wrapper"> - <div id="qv"> - <h2>In this document</h2> - <ol id="auto-toc"> - </ol> - </div> -</div> +<html devsite> + <head> + <title>Configuring Pre-Processing Effects</title> + <meta name="project_path" value="/_project.yaml" /> + <meta name="book_path" value="/_book.yaml" /> + </head> + <body> + <!-- + Copyright 2017 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>The Android platform provides audio effects on supported devices in the <a href="http://developer.android.com/reference/android/media/audiofx/package-summary.html">audiofx</a> @@ -75,7 +74,7 @@ duration of the session.</p> pre-processing effect. It should not be turned on by default when recording from this audio source, and you should not enable it in your own audio_effects.conf file. Turning on the effect by default will cause the device to fail the -<a href="{@docRoot}compatibility/index.html"> compatibility requirement</a> +<a href="/compatibility/index.html"> compatibility requirement</a> regardless of whether this was on by default due to configuration file , or the audio HAL implementation's default behavior.</p> @@ -108,7 +107,7 @@ gain or audio processing with the exception of voice recognition <li>Level tracks linearly from -18dB to +12dB relative to 90dB SPL</li> <li>THD < 1% (90dB SPL in 100 to 4000Hz range)</li> <li>Near-ultrasound requirements (for testing, see -<a href="{@docRoot}compatibility/cts/near-ultrasound.html">Near Ultrasound +<a href="/compatibility/cts/near-ultrasound.html">Near Ultrasound Tests</a>): <ul> <li>Support for SUPPORT_PROPERTY_MIC_NEAR_ULTRASOUND as defined in section 7.8.3 @@ -152,3 +151,6 @@ Suppression audio effect</a></li> <li><code>device/samsung/manta/audio_effects.conf</code> file for the Nexus 10</li> </ul> + + </body> +</html> diff --git a/en/devices/audio/implement-shared-library.html b/en/devices/audio/implement-shared-library.html index f9539a9e..0c999c81 100644 --- a/en/devices/audio/implement-shared-library.html +++ b/en/devices/audio/implement-shared-library.html @@ -1,24 +1,30 @@ -page.title=Configuring a Shared Library -@jd:body +<html devsite> + <head> + <title>Configuring a Shared Library</title> + <meta name="project_path" value="/_project.yaml" /> + <meta name="book_path" value="/_book.yaml" /> + </head> + <body> + <!-- + Copyright 2017 The Android Open Source Project -<!-- - Copyright 2016 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 - 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. + --> - 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>After creating an -<a href="{@docRoot}devices/audio/implement-policy.html">audio policy +<a href="/devices/audio/implement-policy.html">audio policy configuration</a>, you must package the HAL implementation into a shared library and copy it to the appropriate location:</p> @@ -93,3 +99,6 @@ PRODUCT_PACKAGES += \ </pre> </li> </ol> + + </body> +</html> diff --git a/en/devices/audio/implement.html b/en/devices/audio/implement.html index 31e795b0..1538f145 100644 --- a/en/devices/audio/implement.html +++ b/en/devices/audio/implement.html @@ -1,28 +1,27 @@ -page.title=Audio Implementation -@jd:body - -<!-- - Copyright 2015 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. ---> -<div id="qv-wrapper"> - <div id="qv"> - <h2>In this document</h2> - <ol id="auto-toc"> - </ol> - </div> -</div> +<html devsite> + <head> + <title>Audio Implementation</title> + <meta name="project_path" value="/_project.yaml" /> + <meta name="book_path" value="/_book.yaml" /> + </head> + <body> + <!-- + Copyright 2017 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>This section explains how to implement the audio Hardware Abstraction Layer (HAL), provides details about configuring an audio policy (file formats, code @@ -60,10 +59,13 @@ files:</p> <h2 id=next-steps>Next steps</h2> <p>In addition to implementing the audio HAL, you must also create an -<a href="{@docRoot}devices/audio/implement-policy.html">audio policy +<a href="/devices/audio/implement-policy.html">audio policy configuration file</a> that describes your audio topology and package the HAL implementation into a -<a href="{@docRoot}devices/audio/implement-shared-library.html">shared +<a href="/devices/audio/implement-shared-library.html">shared library</a>. You can also configure -<a href="{@docRoot}devices/audio/implement-pre-processing.html">pre-processing +<a href="/devices/audio/implement-pre-processing.html">pre-processing effects</a> such as automatic gain control and noise suppression.</p> + + </body> +</html> diff --git a/en/devices/audio/index.html b/en/devices/audio/index.html index 82a3886d..77aba3bf 100644 --- a/en/devices/audio/index.html +++ b/en/devices/audio/index.html @@ -1,21 +1,27 @@ -page.title=Audio -@jd:body +<html devsite> + <head> + <title>Audio</title> + <meta name="project_path" value="/_project.yaml" /> + <meta name="book_path" value="/_book.yaml" /> + </head> + <body> + <!-- + Copyright 2017 The Android Open Source Project -<!-- - Copyright 2015 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 - 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. + --> - 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. ---> <img style="float: right; margin: 0px 15px 15px 15px;" src="images/ape_fwk_hal_audio.png" alt="Android Audio HAL icon"/> @@ -94,7 +100,7 @@ The HAL defines the standard interface that audio services call into and that you must implement for your audio hardware to function correctly. The audio HAL interfaces are located in <code>hardware/libhardware/include/hardware</code>. For details, see <a -href="{@docRoot}devices/halref/audio_8h_source.html">hardware/audio.h</a>. +href="/devices/halref/audio_8h_source.html">hardware/audio.h</a>. </dd> <dt> @@ -120,3 +126,6 @@ and is at the same architecture level as </dd> </dl> + + </body> +</html> diff --git a/en/devices/audio/latency.html b/en/devices/audio/latency.html index a45bf203..151c4c6a 100644 --- a/en/devices/audio/latency.html +++ b/en/devices/audio/latency.html @@ -1,21 +1,27 @@ -page.title=Audio Latency -@jd:body +<html devsite> + <head> + <title>Audio Latency</title> + <meta name="project_path" value="/_project.yaml" /> + <meta name="book_path" value="/_book.yaml" /> + </head> + <body> + <!-- + Copyright 2017 The Android Open Source Project -<!-- - Copyright 2013 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 - 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. + --> - 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>Audio latency is the time delay as an audio signal passes through a system. </p> @@ -28,7 +34,7 @@ page.title=Audio Latency </tr> <tr> <td>Description of audio latency for purposes of Android compatibility</td> - <td><a href="{@docRoot}compatibility/android-cdd.pdf">Android CDD</a><br /><em>section 5.5 Audio Latency</em></td> + <td><a href="/compatibility/android-cdd.pdf">Android CDD</a><br /><em>section 5.5 Audio Latency</em></td> </tr> <tr> <td>Common causes of audio latency</td> @@ -55,3 +61,6 @@ page.title=Audio Latency <td><a href="latency_app.html">Audio Latency for App Developers</a></td> </tr> </table> + + </body> +</html> diff --git a/en/devices/audio/latency_app.html b/en/devices/audio/latency_app.html index 9505f9b0..b4e7495b 100644 --- a/en/devices/audio/latency_app.html +++ b/en/devices/audio/latency_app.html @@ -1,29 +1,27 @@ -page.title=Audio Latency for App Developers -@jd:body +<html devsite> + <head> + <title>Audio Latency for App Developers</title> + <meta name="project_path" value="/_project.yaml" /> + <meta name="book_path" value="/_book.yaml" /> + </head> + <body> + <!-- + Copyright 2017 The Android Open Source Project -<!-- - Copyright 2015 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 - 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 - 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. + --> - 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. ---> -<div id="qv-wrapper"> - <div id="qv"> - <h2>In this document</h2> - <ol id="auto-toc"> - </ol> - </div> -</div> <p>For the lowest audio latency possible, we recommend you use Android native audio based on OpenSL ES 1.0.1.</p> @@ -143,7 +141,7 @@ Android native audio and OpenSL ES 1.0.1. <h3 id="source_android_com">source.android.com</h3> <p> -The site <a href="{@docRoot}">source.android.com</a> +The site <a href="/">source.android.com</a> is primarily designed for OEMs building Android devices, and the SoC vendors who supply components to these OEMs. </p> @@ -178,3 +176,6 @@ If you have questions about how to use Android native audio, you can ask at the <dd>Describes the relationship between audio latency, buffer sizes, and task scheduling.</dd> </dl> + + </body> +</html> diff --git a/en/devices/audio/latency_contrib.html b/en/devices/audio/latency_contrib.html index 2969ba20..62fce5c2 100644 --- a/en/devices/audio/latency_contrib.html +++ b/en/devices/audio/latency_contrib.html @@ -1,28 +1,27 @@ -page.title=Contributors to Audio Latency -@jd:body +<html devsite> + <head> + <title>Contributors to Audio Latency</title> + <meta name="project_path" value="/_project.yaml" /> + <meta name="book_path" value="/_book.yaml" /> + </head> + <body> + <!-- + Copyright 2017 The Android Open Source Project -<!-- - Copyright 2013 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 - 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. + --> - 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. ---> -<div id="qv-wrapper"> - <div id="qv"> - <h2>In this document</h2> - <ol id="auto-toc"> - </ol> - </div> -</div> <p> This page focuses on the contributors to output latency, @@ -218,3 +217,6 @@ page.title=Contributors to Audio Latency yet cannot be observed. Security kernels should be designed for an acceptable worst-case work stoppage while audio is active. </p> + + </body> +</html> diff --git a/en/devices/audio/latency_design.html b/en/devices/audio/latency_design.html index c931fba2..f777c8ab 100644 --- a/en/devices/audio/latency_design.html +++ b/en/devices/audio/latency_design.html @@ -1,28 +1,27 @@ -page.title=Design For Reduced Latency -@jd:body +<html devsite> + <head> + <title>Design For Reduced Latency</title> + <meta name="project_path" value="/_project.yaml" /> + <meta name="book_path" value="/_book.yaml" /> + </head> + <body> + <!-- + Copyright 2017 The Android Open Source Project -<!-- - Copyright 2013 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 - 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. + --> - 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. ---> -<div id="qv-wrapper"> - <div id="qv"> - <h2>In this document</h2> - <ol id="auto-toc"> - </ol> - </div> -</div> <p> The Android 4.1 release introduced internal framework changes for @@ -234,3 +233,6 @@ in server. <p> <code>TRACK_FAST</code> is a client -> server concept. </p> + + </body> +</html> diff --git a/en/devices/audio/latency_measure.html b/en/devices/audio/latency_measure.html index cf974bd2..691502e6 100644 --- a/en/devices/audio/latency_measure.html +++ b/en/devices/audio/latency_measure.html @@ -1,28 +1,27 @@ -page.title=Measuring Audio Latency -@jd:body - -<!-- - Copyright 2013 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. ---> -<div id="qv-wrapper"> - <div id="qv"> - <h2>In this document</h2> - <ol id="auto-toc"> - </ol> - </div> -</div> +<html devsite> + <head> + <title>Measuring Audio Latency</title> + <meta name="project_path" value="/_project.yaml" /> + <meta name="book_path" value="/_book.yaml" /> + </head> + <body> + <!-- + Copyright 2017 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> This page describes common methods for measuring input and output latency. @@ -237,3 +236,6 @@ overall. disable time. The <i>tail</i> part of the output is especially helpful, as it highlights the variability beyond +/- 3 standard deviations. </p> + + </body> +</html> diff --git a/en/devices/audio/latency_measurements.html b/en/devices/audio/latency_measurements.html index 2811ae00..66a97925 100644 --- a/en/devices/audio/latency_measurements.html +++ b/en/devices/audio/latency_measurements.html @@ -1,28 +1,27 @@ -page.title=Audio Latency Measurements -@jd:body - -<!-- - Copyright 2015 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. ---> -<div id="qv-wrapper"> - <div id="qv"> - <h2>In this document</h2> - <ol id="auto-toc"> - </ol> - </div> -</div> +<html devsite> + <head> + <title>Audio Latency Measurements</title> + <meta name="project_path" value="/_project.yaml" /> + <meta name="book_path" value="/_book.yaml" /> + </head> + <body> + <!-- + Copyright 2017 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> This article gives round-trip audio latency measurements for select devices and @@ -125,7 +124,7 @@ and <p> The measurements shown are specific to a -<a href="{@docRoot}source/build-numbers.html">build number</a>. +<a href="/source/build-numbers.html">build number</a>. Devices are listed in approximate order of initial release and within device by platform version. The test application uses the Android native audio API based on OpenSL ES. </p> @@ -426,49 +425,9 @@ The test application uses the Android native audio API based on OpenSL ES. <p></p> <p></p> -<script type="text/javascript" src="https://www.google.com/jsapi?autoload={'modules':[{'name':'visualization','version':'1.1','packages':['bar']}]}"></script> - <script type="text/javascript"> - - -google.setOnLoadCallback(drawChart); - function drawChart() { - var data = google.visualization.arrayToDataTable([ - ['Device', '2.3', '4.0', '4.1', '4.2', '4.3', '4.4', '5.0', '5.1', '6.0'], - ['Nexus One', 345, null, null, null, null, null, null, null, null,], - ['Nexus S', 260, 260, 210, null, null, null, null, null, null,], - ['Galaxy Nexus', null, 270, null, null, 130, null, null, null, null,], - ['Nexus 4', null, null, null, 195, null, null, null, 58, null,], - ['Nexus 10', null, null, null, null, null, null, 36, 35, null,], - ['Nexus 7 2013', null, null, null, null, 149, 85, 64, 55, 55,], - ['Nexus 5', null, null, null, null, null, 95, 47, 42, 38,], - ['Nexus 9', null, null, null, null, null, null, 38, 32, 15,], - ['Nexus 6', null, null, null, null, null, null, 65, 42, 33,], - ['Nexus 5X', null, null, null, null, null, null, null, null, 18,], - ['Nexus 6P', null, null, null, null, null, null, null, null, 18,] - ]); - - var options = { - chart: { - title: 'Round Trip Audio Latency', - subtitle: 'Over headset, using native APIs', - }, - bars: 'horizontal', // Required for Material Bar Charts. - bar: {groupWidth: '100%'}, - hAxis: { - title: 'Milliseconds' - }, - height: 800, - width: 600 - }; - - var chart = new google.charts.Bar(document.getElementById('chart_div')); - - chart.draw(data, google.charts.Bar.convertOptions(options)); - - } -</script> - - <div id="chart_div"></div> <p></p> + <img src="/devices/audio/images/round-trip-latencies.png" /> <p class="img-caption"> -<strong>Figure 3.</strong> Round trip latencies.</p>
\ No newline at end of file +<strong>Figure 3.</strong> Round trip latencies.</p> + </body> +</html> diff --git a/en/devices/audio/loopback.html b/en/devices/audio/loopback.html index 933972f1..359f45a5 100644 --- a/en/devices/audio/loopback.html +++ b/en/devices/audio/loopback.html @@ -1,28 +1,27 @@ -page.title=Audio Loopback Dongle -@jd:body - -<!-- - Copyright 2014 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. ---> -<div id="qv-wrapper"> - <div id="qv"> - <h2>In this document</h2> - <ol id="auto-toc"> - </ol> - </div> -</div> +<html devsite> + <head> + <title>Audio Loopback Dongle</title> + <meta name="project_path" value="/_project.yaml" /> + <meta name="book_path" value="/_book.yaml" /> + </head> + <body> + <!-- + Copyright 2017 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> The diagram and photo below show an audio loopback @@ -56,3 +55,6 @@ the audio loopback dongle is a US/CTIA pinout Tip Ring Ring Shield (TRRS) plug. <p class="img-caption"> <strong>Figure 2.</strong> Assembled </p> + + </body> +</html> diff --git a/en/devices/audio/midi.html b/en/devices/audio/midi.html index 94dbee21..31b55182 100644 --- a/en/devices/audio/midi.html +++ b/en/devices/audio/midi.html @@ -1,29 +1,27 @@ -page.title=MIDI -@jd:body +<html devsite> + <head> + <title>MIDI</title> + <meta name="project_path" value="/_project.yaml" /> + <meta name="book_path" value="/_book.yaml" /> + </head> + <body> + <!-- + Copyright 2017 The Android Open Source Project -<!-- - Copyright 2015 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 - 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 - 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. + --> - 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. ---> -<div id="qv-wrapper"> - <div id="qv"> - <h2>In this document</h2> - <ol id="auto-toc"> - </ol> - </div> -</div> <p> <a href="http://en.wikipedia.org/wiki/MIDI">MIDI</a> (Musical Instrument Digital Interface) @@ -90,7 +88,7 @@ ALSA is not used for the BLE and virtual transports. <p> To enable MIDI for USB host mode, first support USB host mode in general, and then enable <code>CONFIG_SND_RAWMIDI</code> and <code>CONFIG_SND_USB_MIDI</code> in your kernel configuration. -See <a href="{@docRoot}devices/tech/config/kernel.html">Android Kernel Configuration.</a> +See <a href="/devices/tech/config/kernel.html">Android Kernel Configuration.</a> </p> <p> @@ -162,7 +160,7 @@ frameworks/native/data/etc/android.software.midi.xml:system/etc/permissions/andr <p> See the -<a href="{@docRoot}compatibility/android-cdd.pdf">Android Compatibility Definition Document (CDD)</a> +<a href="/compatibility/android-cdd.pdf">Android Compatibility Definition Document (CDD)</a> for information on requirements to claim the feature. </p> @@ -176,3 +174,6 @@ of <a href="http://developer.android.com/tools/help/adb.html">Android Debug Bridge</a> for an alternative. </p> + + </body> +</html> diff --git a/en/devices/audio/midi_arch.html b/en/devices/audio/midi_arch.html index 816449d6..b8ea1a99 100644 --- a/en/devices/audio/midi_arch.html +++ b/en/devices/audio/midi_arch.html @@ -1,29 +1,27 @@ -page.title=MIDI Architecture -@jd:body +<html devsite> + <head> + <title>MIDI Architecture</title> + <meta name="project_path" value="/_project.yaml" /> + <meta name="book_path" value="/_book.yaml" /> + </head> + <body> + <!-- + Copyright 2017 The Android Open Source Project -<!-- - Copyright 2015 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 - 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 - 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. + --> - 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. ---> -<div id="qv-wrapper"> - <div id="qv"> - <h2>In this document</h2> - <ol id="auto-toc"> - </ol> - </div> -</div> <p> This article describes the generic MIDI architecture, independent of @@ -229,3 +227,6 @@ platform, see the <a href="http://developer.android.com/reference/android/media/midi/package-summary.html"> Android MIDI User Guide for <code>android.media.midi</code></a>. </p> + + </body> +</html> diff --git a/en/devices/audio/midi_test.html b/en/devices/audio/midi_test.html index e5188b9e..303f0980 100644 --- a/en/devices/audio/midi_test.html +++ b/en/devices/audio/midi_test.html @@ -1,29 +1,27 @@ -page.title=MIDI Test Procedure -@jd:body +<html devsite> + <head> + <title>MIDI Test Procedure</title> + <meta name="project_path" value="/_project.yaml" /> + <meta name="book_path" value="/_book.yaml" /> + </head> + <body> + <!-- + Copyright 2017 The Android Open Source Project -<!-- - Copyright 2015 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 - 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 - 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. + --> - 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. ---> -<div id="qv-wrapper"> - <div id="qv"> - <h2>In this document</h2> - <ol id="auto-toc"> - </ol> - </div> -</div> <p>These tests may be used to validate the MIDI feature on Android devices. Successful execution of these tests is a prerequisite to @@ -265,3 +263,6 @@ the C.24 to indicate paired mode.</li> <li> You should be able to press keys on the BLE keyboard and hear notes on Android.</li> </ol> + + </body> +</html> diff --git a/en/devices/audio/src.html b/en/devices/audio/src.html index ab70fee5..8bbf5560 100644 --- a/en/devices/audio/src.html +++ b/en/devices/audio/src.html @@ -1,28 +1,27 @@ -page.title=Sample Rate Conversion -@jd:body - -<!-- - Copyright 2013 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. ---> -<div id="qv-wrapper"> - <div id="qv"> - <h2>In this document</h2> - <ol id="auto-toc"> - </ol> - </div> -</div> +<html devsite> + <head> + <title>Sample Rate Conversion</title> + <meta name="project_path" value="/_project.yaml" /> + <meta name="book_path" value="/_book.yaml" /> + </head> + <body> + <!-- + Copyright 2017 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. + --> + + <h2 id="srcIntro">Introduction</h2> @@ -116,3 +115,6 @@ the use case, load, and the value of system property <code>af.resampler.quality</code>. For details, consult the audio resampler source code in AudioFlinger. </p> + + </body> +</html> diff --git a/en/devices/audio/terminology.html b/en/devices/audio/terminology.html index ae07d0d4..f84fa88b 100644 --- a/en/devices/audio/terminology.html +++ b/en/devices/audio/terminology.html @@ -1,28 +1,27 @@ -page.title=Audio Terminology -@jd:body - -<!-- - Copyright 2015 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. ---> -<div id="qv-wrapper"> - <div id="qv"> - <h2>In this document</h2> - <ol id="auto-toc"> - </ol> - </div> -</div> +<html devsite> + <head> + <title>Audio Terminology</title> + <meta name="project_path" value="/_project.yaml" /> + <meta name="book_path" value="/_book.yaml" /> + </head> + <body> + <!-- + Copyright 2017 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> This glossary of audio-related terminology includes widely-used generic terms @@ -738,7 +737,7 @@ triggering UI feedback, game sounds, etc. The API is defined at <dt>Stagefright</dt> <dd> -See <a href="{@docRoot}devices/media.html">Media</a>. +See <a href="/devices/media.html">Media</a>. </dd> <dt>StateQueue</dt> @@ -801,3 +800,6 @@ operate in volume indices rather than absolute attenuation factors. </dd> </dl> + + </body> +</html> diff --git a/en/devices/audio/testing_circuit.html b/en/devices/audio/testing_circuit.html index 1881e0c8..118fc09a 100644 --- a/en/devices/audio/testing_circuit.html +++ b/en/devices/audio/testing_circuit.html @@ -1,28 +1,27 @@ -page.title=Light Testing Circuit -@jd:body - -<!-- - Copyright 2014 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. ---> -<div id="qv-wrapper"> - <div id="qv"> - <h2>In this document</h2> - <ol id="auto-toc"> - </ol> - </div> -</div> +<html devsite> + <head> + <title>Light Testing Circuit</title> + <meta name="project_path" value="/_project.yaml" /> + <meta name="book_path" value="/_book.yaml" /> + </head> + <body> + <!-- + Copyright 2017 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> The file <a href="http://developer.android.com/downloads/partner/audio/av_sync_board.zip">av_sync_board.zip</a> @@ -92,3 +91,6 @@ This <a href="http://www.youtube.com/watch?v=f95S2IILBJY">Youtube video</a> shows the breadboard version testing circuit in operation. Skip ahead to 1:00 to see the circuit. </p> + + </body> +</html> diff --git a/en/devices/audio/tv.html b/en/devices/audio/tv.html index 9f7afc81..29c95bb5 100644 --- a/en/devices/audio/tv.html +++ b/en/devices/audio/tv.html @@ -1,28 +1,27 @@ -page.title=TV Audio -@jd:body - -<!-- - Copyright 2015 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. ---> -<div id="qv-wrapper"> - <div id="qv"> - <h2>In this document</h2> - <ol id="auto-toc"> - </ol> - </div> -</div> +<html devsite> + <head> + <title>TV Audio</title> + <meta name="project_path" value="/_project.yaml" /> + <meta name="book_path" value="/_book.yaml" /> + </head> + <body> + <!-- + Copyright 2017 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>The TV Input Framework (TIF) manager works with the audio routing API to support flexible audio path changes. When a System on Chip (SoC) implements the TV hardware abstraction layer (HAL), each @@ -300,3 +299,6 @@ the sink port of the existing tuner audio patch to the HDMI_OUT port.</p> <img src="images/ape_audio_tv_hdmi_tuner.png" alt="Android TV HDMI-OUT Audio Patch" /> <p class="img-caption"> <strong>Figure 3.</strong> Audio Patch for HDMI OUT from live TV.</p> + + </body> +</html> diff --git a/en/devices/audio/usb.html b/en/devices/audio/usb.html index bb0bb69e..e3d5fce7 100644 --- a/en/devices/audio/usb.html +++ b/en/devices/audio/usb.html @@ -1,28 +1,27 @@ -page.title=USB Digital Audio -@jd:body +<html devsite> + <head> + <title>USB Digital Audio</title> + <meta name="project_path" value="/_project.yaml" /> + <meta name="book_path" value="/_book.yaml" /> + </head> + <body> + <!-- + Copyright 2017 The Android Open Source Project -<!-- - Copyright 2014 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 - 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. + --> - 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. ---> -<div id="qv-wrapper"> - <div id="qv"> - <h2>In this document</h2> - <ol id="auto-toc"> - </ol> - </div> -</div> <p> This article reviews Android support for USB digital audio and related @@ -555,7 +554,7 @@ In order to support USB digital audio, device OEMs and SoC vendors should: <li>enable generic USB host support at the framework level via the <code>android.hardware.usb.host.xml</code> feature flag</li> <li>enable all kernel features needed: USB host mode, USB audio, isochronous transfer mode; -see <a href="{@docRoot}devices/tech/kernel.html">Android Kernel Configuration</a></li> +see <a href="/devices/tech/kernel.html">Android Kernel Configuration</a></li> <li>keep up-to-date with recent kernel releases and patches; despite the noble goal of class compliance, there are extant audio peripherals with <a href="http://en.wiktionary.org/wiki/quirk">quirks</a>, @@ -630,3 +629,6 @@ this is abstracted away by the ALSA implementation. So the USB audio HAL and tinyalsa do not need to concern themselves with this part of USB protocol. </p> + + </body> +</html> diff --git a/en/devices/audio/warmup.html b/en/devices/audio/warmup.html index 1dec8342..e139e2f4 100644 --- a/en/devices/audio/warmup.html +++ b/en/devices/audio/warmup.html @@ -1,28 +1,27 @@ -page.title=Audio Warmup -@jd:body - -<!-- - Copyright 2013 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. ---> -<div id="qv-wrapper"> - <div id="qv"> - <h2>In this document</h2> - <ol id="auto-toc"> - </ol> - </div> -</div> +<html devsite> + <head> + <title>Audio Warmup</title> + <meta name="project_path" value="/_project.yaml" /> + <meta name="book_path" value="/_book.yaml" /> + </head> + <body> + <!-- + Copyright 2017 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>Audio warmup is the time it takes for the audio amplifier circuit in your device to be fully powered and reach its normal operation state. The major contributors @@ -112,3 +111,6 @@ sampleRate=44100 frameCount=256 measuredWarmup=X ms, warmupCycles=X need to tradeoff between low warmup time versus lack of popping at power transitions. </p> + + </body> +</html> |
