O Google tem o compromisso de promover a igualdade racial para as comunidades negras. Saiba como.

Esta página foi traduzida pela API Cloud Translation.

Dependências de OEM para o gerenciador de recursos de mídia

O objetivo deste documento é ajudar os fabricantes de equipamentos originais (OEMs) implementar corretamente o suporte ao gerenciador de recursos de mídia do Android e às APIs relacionadas.

Máximo de instâncias simultâneas de codec

Interface CodecCapabilities.getMaxSupportedInstances retorna o número máximo de instâncias de codec simultâneas suportadas.

O teste CTS testGetMaxSupportedInstances(android.media.cts.MediaCodecCapabilitiesTest) é usado para aplicar o máximo adequado é definido no /etc/media_codecs.xml.

Confira um exemplo:

...
<MediaCodecs>
    ...
    <Encoders>
        <MediaCodec name="OMX.<vendor>.video.encoder.avc" type="video/avc" >
           ...
            <Limit name="concurrent-instances" max="13" />
        </MediaCodec>
        ...
    </Encoders>
    ...
</MediaCodecs>

Os OEMs podem usar esse teste para gerar os limites simultâneos que são aprovados no teste. Para fazer isto:

Execute o teste primeiro usando cts-tradefed.

Avalie a mensagem de falha resultante. Confira um exemplo:

There was 1 failure:
1) testGetMaxSupportedInstances(android.media.cts.MediaCodecCapabilitiesTest)
junit.framework.AssertionFailedError: In order to pass the test, please publish
following codecs' concurrent instances limit in /etc/media_codecs.xml:
<MediaCodec name="OMX.<vendor>.video.encoder.mpeg4" type="video/mp4v-es" >
    <Limit name="concurrent-instances" max="13" />
</MediaCodec>
<MediaCodec name="OMX.<vendor>.video.encoder.h263" type="video/3gpp" >
    <Limit name="concurrent-instances" max="13" />
</MediaCodec>
<MediaCodec name="OMX.<vendor>.video.encoder.avc" type="video/avc" >
    <Limit name="concurrent-instances" max="13" />
</MediaCodec>
<MediaCodec name="OMX.<vendor>.video.encoder.vp8" type="video/x-vnd.on2.vp8" >
    <Limit name="concurrent-instances" max="13" />
</MediaCodec>
<MediaCodec name="OMX.<vendor>.video.decoder.avc" type="video/avc" >
    <Limit name="concurrent-instances" max="13" />
</MediaCodec>
<MediaCodec name="OMX.<vendor>.video.decoder.avc.secure" type="video/avc" >
    <Limit name="concurrent-instances" max="4" />
</MediaCodec>
<MediaCodec name="OMX.<vendor>.video.decoder.mpeg4" type="video/mp4v-es" >
    <Limit name="concurrent-instances" max="12" />
</MediaCodec>
<MediaCodec name="OMX.<vendor>.video.decoder.h263" type="video/3gpp" >
    <Limit name="concurrent-instances" max="12" />
</MediaCodec>
<MediaCodec name="OMX.<vendor>.video.decoder.vp8" type="video/x-vnd.on2.vp8" >
    <Limit name="concurrent-instances" max="12" />
</MediaCodec>

Adicione as linhas concurrent-instances sugeridas no teste de falha para o arquivo /etc/media_codecs.xml.
Execute o teste novamente para verificar se o resultado foi bem-sucedido.

Frame rates possíveis para codecs de vídeo

Interface VideoCapabilities.getAchievableFrameRatesFor retorna o intervalo de frame rates possíveis para um tamanho de vídeo. Isso informações precisam ser fornecidas pelo OEM para cada dispositivo por meio de um arquivo XML colocado em /etc/media_codecs_performance.xml: Essas configurações são testadas os objetos com.android.cts.videoperf.VideoEncoderDecoderTest e android.media.cts.VideoDecoderPerfTest testes de CTS.

Os OEMs podem usar os testes de CTS para gerar os arquivos XML que são aprovados nos testes. Para fazer isto:

Execute os testes primeiro usando cts-tradefed. Considerando variabilidade do desempenho do Android, é recomendável executar os testes várias vezes para obter valores mínimos e máximos mais precisos.
Use as fornecidas get_achievable_rates.py para gerar o arquivo XML.
Coloque o arquivo XML em: /etc/media_codecs_performance.xml
Isso geralmente é feito colocando o arquivo XML no projeto do dispositivo (device/<vendor>/<product>) e adicionar um linha PRODUCT_COPY_FILES para device.mk da seguinte forma:
```
PRODUCT_COPY_FILES += \
...
   device/moto/shamu/media_codecs.xml:system/etc/media_codecs.xml \
+    device/moto/shamu/media_codecs_performance.xml:system/etc/media_codecs_performance.xml
```
Execute novamente os testes de desempenho para verificar se o resultado foi bem-sucedido.

Coexistência de codec seguro e codec não seguro

suporta-secure-with-non-secure-codec — Se a instância do codec seguro e a instância do codec não seguro não puderem coexistir ao mesmo tempo, isso deve ser indicado como um ambiente global no media_codecs.xml.
```
<MediaCodecs>
    <Settings>
        <Setting name="supports-secure-with-non-secure-codec" value="false" />
    </Settings>
    <Encoders>
…
```
suporta-multiple-secure-codecs — Se não houver suporte para a coexistência de várias instâncias de codec seguro, isso deverá ser indicado como uma configuração global no arquivo media_codecs.xml.
```
<MediaCodecs>
    <Settings>
        <Setting name="supports-multiple-secure-codecs" value="false" />
    </Settings>
    <Encoders>
…
```
As duas configurações são verdadeiras por padrão, ou seja, se forem compatíveis, não é necessário adicionar a linha de configuração ao media_codecs.xml.
Os testes CTS ResourceManagerTest podem falhar se essas duas configurações não forem definidas corretamente.