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

Este documento foi criado para ajudar fabricantes de equipamentos originais (OEMs) a implementar corretamente o suporte ao gerenciador de recursos de mídia do Android e às APIs relacionadas.

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

A interface CodecCapabilities.getMaxSupportedInstances retorna o número máximo de instâncias de codec simultâneas compatíveis.

O teste CTS testGetMaxSupportedInstances(android.media.cts.MediaCodecCapabilitiesTest) é usado para garantir que o máximo adequado seja definido em /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 o aprovam. Para fazer isto:

1. Execute o teste primeiro usando o cts-tradefed.
2. 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>
   

3. Adicione as linhas concurrent-instances sugeridas na mensagem de falha do teste ao arquivo /etc/media_codecs.xml.
4. Execute o teste novamente para verificar se ele foi bem-sucedido.

Frame rates possíveis para codecs de vídeo

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

Os OEMs podem usar os testes do CTS para gerar os arquivos XML que passam nos testes. Para fazer isto:

1. Primeiro, execute os testes usando o cts-tradefed. Devido à variabilidade da performance do Android, é recomendável executar os testes várias vezes para ter valores mínimos e máximos mais precisos.
2. Use o script get_achievable_rates.py fornecido para gerar o arquivo XML.
3. 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 adicionando uma linha PRODUCT_COPY_FILES a device.mk desta 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
   

4. Execute os testes de desempenho novamente para verificar se eles foram bem-sucedidos.

Coexistência de codec seguro e não seguro

• supports-secure-with-non-secure-codec: se a instância de codec seguro e a instância de codec não seguro não puderem coexistir ao mesmo tempo, isso deverá ser indicado como uma configuração global no arquivo media_codecs.xml.

  <MediaCodecs>
      <Settings>
          <Setting name="supports-secure-with-non-secure-codec" value="false" />
      </Settings>
      <Encoders>
  …
  

• supports-multiple-secure-codecs: se a coexistência de várias instâncias de codec seguro não for compatível, 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. Isso significa que, se elas forem compatíveis, não será necessário adicionar a linha de configuração ao media_codecs.xml.
• Os testes do CTS ResourceManagerTest podem falhar se essas duas configurações não forem definidas corretamente.