Docs: Misc fixes for CDD.

Cherrypick of 512299 from oreo-dev

Bug: 67405273

Test: make_cdd.py --version 8.0 --branch "oc-dev"
Change-Id: Icee371d41284f56ef6d9ad90ab8992c94134d5bd

Merge "CDD: Proper MIDI support" into oc-mr1-dev

Merge "CDD: Strongly recommend predictable CPU performance mode in pro audio." into oc-mr1-dev

CDD: Strongly recommend predictable CPU performance mode in pro audio.

Predictable CPU performance mode maintains the CPU clock at a stable
rate while low-latency audio is active, permitting applications to have
more consistent CPU bandwidth available on short notice.  Without this
mode, if a low-latency audio task is not using high CPU load for a
moment, the governor can decrease the CPU bandwidth.  However, when the
audio task's CPU load increases, the governor may be unable to respond
quickly enough to meet the audio task's requirements, resulting in an
audible glitch. This mode solves that problem and so is recommended for
devices that claim the pro audio feature.

Bug: 32809154
Test: builds OK
Change-Id: I7006af18a614dca841527053b48a83dbf3dd7280

Docs: Minor fixes in section 5.10 Professional Audio and section 7.8.2
Audio Output.

Bug: 64042820
Test: builds OK
Change-Id: I112ef764596ddd2270e97ae55d29287439d5980c

CDD: Proper MIDI support

Device implementations exposing the MIDI capability to third-party
apps, MUST also have properly implemented MIDI support.

This will help app developers, as they would know that standard MIDI
APIs are supported on a device that declares MIDI support.

Bug: 36465422
Test: N/A
Change-Id: I1b1e63636a2bec1f0208d737dc1bc6253d7ec115

Docs: Move dev-specific reqs to Ch 2.

Test: python make_cdd.py --version <version-number>  --branch <mybranch>

Bug: 64164626
Merged-In: Ie091c0be79ad4a797f26a60e95ee2594f053f804
Change-Id: Ie091c0be79ad4a797f26a60e95ee2594f053f804
(cherry picked from commit 0ece682cb7f915f4289ba6d7b5c86957e6d5d276)
(cherry picked from commit d72cc3b7971126e352c0c8fd83693f458d3785ec)

Merge "Docs: Restructure Section 5.6" into oc-dev

Merge "Docs: Restructure Section 5.3" into oc-dev

Merge "Docs: Restructure Section 5.10" into oc-dev

Docs: Restructure Section 5.3

- Restructure with new ID rule.
- Move the requirements in the table footnotes in section 5.1
to the content body in this section for better readability.

Bug: 64811960

Change-Id: Icd11b6f73d74205565eaf41a7d5e551e9e7f2a04

Docs: Restructure Section 5.10

- Restructure with the new ID

Bug: 64811960

Change-Id: Ifc59abd8182956cfc307b3ee0b1ef5e0dc00f04c

Merge "Docs: Restructure Section 5.2" into oc-dev

Docs: Restructure Section 5.6

- Restructure with new ID rule
Bug: 64811960

Change-Id: I3ac0cc72c1a3addbad705d9492717ce34228cea2

Merge "Docs: Restructure Section 5.1" into oc-dev

Merge "Docs: Restructure Section 5.4" into oc-dev

Merge "Docs: Restructure Section 5.8" into oc-dev

Merge "Docs: Restructure Section 5.11" into oc-dev

Merge "Docs: Restructure Section 5.0" into oc-dev

Docs: Restructure Section 5.0

- Restructure with new ID rule
- Move section 5.1 to section 5

Bug: 64811960

Change-Id: I078ce470c3407fc491a3e419aa1f6b97fdae5db8

Docs: Restructure Section 5.2

- Restructure with new ID rule
- Move the requirements in the table footer in section 5.1 to the
content body in this section for better readability.

Bug: 64811960

Change-Id: I5d907aeead136dcc52f1933b57f1babaec317a98

Docs: Restructure Section 5.4

- Restructure with  new ID rule

Bug: 64811960
Change-Id: If59a99cafe2699ac3738d7535e56e688411db11d

Docs: Restructure Section 5.1

- Restructure with new ID rule.
- Moved video encoding and decoding requirements to 5.2 and 5.3
sections.

Bug: 64811960

Change-Id: I764407eb7c8c5dbb8c85422df8e790557741d583

Docs: Restructure Section 5.8

- Restructure with  new ID rule

Bug: 64811960
Change-Id: Ied34b3eff49b102ea8320a50ee097bef98f6daff

Docs: Restructure Section 5.11

- Restructure with new ID

Bug: 64811960

Change-Id: Iacf8457c9ef05391f0f14c13491003c1bb93f1bf

Merge "Docs: Restructure Section 5.5" into oc-dev

Merge "Docs: Restructure Section 5.7" into oc-dev

Docs: Restructure Section 5.5

- Restructure with new ID rule

Bug: 64811960
Change-Id: I2f655b1592cf4f6597cc4eeb4c57e3d48971d4e4

Docs: Restructure Section 5.7

- Restructure with  new ID rule
Bug: 64811960

Change-Id: I24b0c37d79046e89b03c11bbd99af5ed31e62dee

Docs: Restructure Section 5.9

- Restructure with  new ID

Bug: 64811960
Change-Id: I6d1ad5a5d4ba00fdb63c22b7235aff1744da9bfd

Merge "CDD: Clarified H.265/VP9 requirements." into oc-dev

Merge "CDD: Recommend simultaneous decoding of secure streams on Android Television devices." into oc-dev

Merge "CDD: Add requirements for AAudio native audio API" into oc-dev

CDD: Recommend simultaneous decoding of secure streams on Android
Television devices.

Video content providers would like to have 2 secure videos decoded
to improve the transition between titles video playback.
This can't be done today because most Android devices can only
instantiate a single secure decoder at a time.

The industry is not yet ready to adopt this universally but the
requirement is added in Android 8.0 as a STRONGLY RECOMMENDED clause
to signal the intention to introduce a more strict requirement in the
future.

Bug: 25978754
Test: N/A
Change-Id: Ide72f348dbf89b712d561a7cfd4bfb1382150cd6

CDD: Clarified H.265/VP9 requirements.

The new footnotes and existing requirements was confusing, so
made it more clearer.

Bug: 36459520
Test: N/A
Change-Id: I05592f13431d6dab61fc9df139636f2c363bf741

CDD: Add requirements for AAudio native audio API

Test: can build PDF
Bug: 34976501
Change-Id: I932f2325a984091bc7fda14968eab861893bd4af

Merge "CDD: Latency req. added for Pro audio when 3.5mm audio jack is omitted" into oc-dev

CDD: Updated missing footnotes for VP9/H.265.

REQUIRE atleast one of H.265 or VP9 decoding of the 720, 1080 and UHD
profiles for when the height as reported by the
`Display.getSupportedModes()` method is equal to or greater than the
video resolution.

Bug: 24915532
Test: N/A
Change-Id: I48084ea37c6d80b50196969c20f1e2329e6b6c06

CDD: Latency req. added for Pro audio when 3.5mm audio jack is omitted

We see some device makers omitting the 3.5mm audio jack, the interface
we have previously used to define the audio latency requirement for the
Pro Audio feature.

Hence we're updating the requirement to clarify that the audio latency
in this case should be measured on the USB host port interface.

Test: N/A
Bug: 35419299
Change-Id: I10d64ec7b9b4375d25b9438a583d87fb9963f70f

CDD: Relax H.265 1080p requirements from 10Mbps to 5Mbps

The 10Mbps was too strict for the industry to implement
widely enough.

http://r.android.com/209496 should have updated both VP9
and H.265 requirements but missed the H.265.

Bug: 27664397
Change-Id: I953b1f8534ee005e61971d866fea817e8ded9315
(cherry picked from commit 84b35c7bb6a3642a1ea06343d5b123b580bf86ec)

Merge "CDD: Fix typo in high frequency range for unprocessed audio" into nougat-mr1-dev

Docs: Final cleanup for CDD source.

   - Fix rowspan in table in section 2.1.
   - Put markdown links on a single line.
   - Escape parentheses in URLs.
   - Fix some internal links with dashes instead of underscores.
   - Replace tabs with spaces.
   - Other misc. cleanup.

Bug: 32070486
Change-Id: Ie44202b5a0bfe7133505880a0a9c74f08a9bac1f

CDD: Fix typo in high frequency range for unprocessed audio

Test: not applicable
Bug: 32645111
Change-Id: Ia35f0871b674976476358dd84d1ab019d19152fb
(cherry picked from commit 852dbf00119545bb398b2c9821d2b866d8a89bce)

Docs: Fix mdashes, remove comma, indent list..

Bug: 32070486
Change-Id: I35326874a7c6fae3d29548003a9dc3cfe7742558

CDD: Android TV video codec requirements change

Bug: 29640911

Change-Id: I494af22fcb29ae31aa523d034c2a7f00284ff03d

CDD: Remove detail from Raw image decoder requirement

The AOSP provides an implementation of the Raw decoder in Skia
which will display the embedded JPEG (aka "preview") data --
if available in the image file -- or the DNG format data.

The change here removes this implementation detail from the
requirement, as the device implementations may have different
choices for how the Raw image file is decoded.

Bug: 27152493

Change-Id: I660198b12374f7050cfb49fdf11408589750ad5c

Merge "CDD: Updates to media codec section." into nyc-dev

CDD: Updates to media codec section.

Bug: 28070873

Change-Id: Idba71e7928be65fb935fc10d7a7b40e0275d01d6

Merge "CDD: Additions for AAC DRC metadata support" into nyc-dev

CDD: Additions for AAC DRC metadata support

Bug 29881814

Change-Id: I102d29878a24a88097980d10d8c2b79d6163bd75

Merge "CDD: Require AAC support 5.0/1 w/o downmixing." into nyc-dev

CDD: Require AAC support 5.0/1 w/o downmixing.

Bug: 28384221

Change-Id: Ief14f9aaa59008a8b099cdcaf99ce41224acaff2

CDD: Require one of 44.1, 48 kHz sampling rates for voice recognition

Bug: 27665223

Change-Id: If0ea2e494584c98539eecae5704da36ac953da98

Merge "CDD: Clarify media codec/protocol requirements" into nyc-dev

CDD: Add recommendations for pro audio feature

Bug: 30831170
Change-Id: I0c111a9ad79f71ab8cd8c52611a83d7b77e0f776

Merge "CDD: Add new section 5.11 for unprocessed audio capturing" into nyc-dev

Merge "CDD: Pro Audio requires OpenSL ES PCM buffer queue API for latency and USB audio" into nyc-dev

CDD: Pro Audio requires OpenSL ES PCM buffer queue API for latency and USB audio

Latencies and USB audio requirements MUST be met using the
OpenSL ES PCM buffer queue API.

Bug: 29618142

Change-Id: I68189cd4b1992f6fd8b24474cafc93403ebcf7b4

CDD: Recommend stream-specific adjustment of volume for automotive

Audio management including focus and volume attenuation for
stream ducking is often conducted by an off-board system in
automotive. Android should support individual stream volume
adjustment so that off board mixing and management is handled
correctly in these cases. For some car-specific cases the new
CAR_AUDIO_USAGE_* usages are provided in the android.car API
package.

Change-Id: I748d1ae5d3aa42112eaea1f2f8eae9022ca2a9f8

Merge "CDD: Update audio latency definitions" into nyc-dev

Merge "CDD: MIDI over BLE is now required to report android.software.midi" into nyc-dev

CDD: Update audio latency definitions

Clarify the definitions of audio latency, jitter, and lost input.

Bug: 30695402
Change-Id: I5fa79a5fdcd24f56e243a402b60439e66976d7b0

CDD: Add new section 5.11 for unprocessed audio capturing

Bug: 30695417

Change-Id: I05c53e24dad0ebcdd55ef4f87e6f5cfc7591e0d7

CDD: Clarify media codec/protocol requirements

Bug: 23104087

Change-Id: I01d80a35f1f6922ebf5333a1888b9e2234a55310

CDD: MIDI over BLE is now required to report android.software.midi

Rationale: BLE over MIDI is now published by MIDI.org and has a stable
Android implementation.

Bug: 29611793

Change-Id: I6904fcda7f2dbbc3fa683ff5594c7dda1c4afd03

Merge "CDD: Require support of rendering RAW images." into nyc-dev

CDD: Require support of rendering RAW images.

RAW image support is added in Android 7.0.

Bug: 27152493

Change-Id: Ice230501fddf895c100046c90e999758a8199a9a

Merge "CDD: H.263 codecs are not any more required." into nyc-dev

CDD: H.263 codecs are not any more required.

H.263 is not any more required, as the functionality is mostly replaced
by more modern codecs.

Bug: 27221674

Change-Id: I874ef1c18e549d5357a929c7faaea96036557bee

Docs: Increased readability of Video Codecs
Bug: 29640911

Change-Id: Ie49fb877b8cc205a9258f66d5b59279a916c7fb0

Docs: Fix external link to NDK docs

Change-Id: Ibcd063c22a60889f7fea93d42aac97ea1f9a29b1

Docs: Add CDD docs and the build script, and test examples

Bug: 25199595
This is based on the amended final CDD for M, hosted as commit
1846a9622485855d572705a7972116caf0be3669 on the AOSP master branch.

Change-Id: Ic3bd96cd652f7d7b13def03a4ca1f04645c34255