In this post, I am using H.264
as an example, but the solution(s) can be extended to support other codecs like MPEG-4
, VC-1
, VP8
etc. There are 2 possible solutions to solve your problem, which I am enlisting below, each with their own pros and cons to help you take an informed decision.
Solution 1: Extend the codec to support new mode
In JellyBean
, one could register the same OMX
component with same MIME
types as 2 different component names viz., OMX.ABC.XYZ
and OMX.ABC.XYZ.secure
. The former is used for normal playback and is the more commonly used component. The latter is used when the parser i.e. MediaExtractor
indicates the presence of secure content. In OMXCodec::Create
, after findMatchingCodecs
returns a list of codecs, we can observe the choice to select .secure
component as here.
Steps to follow:
In your platform, register another component with some new extension like OMX.H264.DECODER.decrypt
or something similar. Change is required only in media_codecs.xml
. The choice of whether to register a new factory method or have a common factory method is your choice.
From your parser, when you encounter the specific use-case, set a new flag like kKeyDecryptionRequired
. For this you will have to define a new flag in Metadata.h
and a corresponding quirk in OMXCodec.h
.
Modify the OMXCodec::create
method to append a .decrypt
suffix similar to the .secure
suffix as shown above.
With all changes in OMXCodec
, Metadata
, MediaExtractor
modules, you will have to rebuild only libstagefright.so
and replace the same on your platform.
Voila!! your integration should be complete. Now comes the main challenge inside the component. As part of the component implementation, you should be able to differentiate between an ordinary component creation and .decrypt
component creation.
From a runtime perspective, assuming that your component is aware of the fact that it is a .decrypt
component or not, you could handle the decryption
as part of the OMX_EmptyThisBuffer
call, where you could decrypt the data and then pass it to underlying codec.
Pros: Easy to integrate, Minimal changes in Android framework, Scalable to other codecs, No new MIME
type registration required.
Cons: You need to track the future revisions of android, specifically on the new quirks, flags and choice of .decrypt
extension. If Google decides to employ something similar, you will have to adapt / modify your solution accordingly.
Solution 2: Registration of new MIME Type
From your question, it is not clear if you were able to define the MIME
type or not and hence, I am capturing the steps for clarity.
Steps to follow:
Register a new MIME
type at MediaDefs
as shown here. For example, you could employ a new MIME
type as const char *MEDIA_MIMETYPE_VIDEO_AVC_ENCRYPT = "video/avc-encrypt";
Register your new component with this updated MIME
type in media_codecs.xml
. Please note that you will have to ensure that the component quirks are also handled accordingly.
In OMXCodec::setVideoOutputFormat
method implementation, you will have to introduce the support for handling your new MIME
type as shown for H.264
here. Please note that you will have to handle similar changes in OMXCodec
to support the new MIME
type.
In MediaExtractor
, you will have to signal the MIME
type for the video
track using the newly defined type. With these changes, your component will be selected and created.
However, the challenge still remains: Where to perform the decryption? For this, you could as well employ the same solution as described in the previous section i.e. handle the same as part of OMX_EmptyThisBuffer
call.
Pros: None that I can think of..
Cons: First, solution is not scalable. You will have to keep adding newer MIME
types and keep modifying the Stagefright
framework. Next, the changes in OMXCodec
will require corresponding changes in MediaExtractor
. Hence, even though your initial focus is on MP4
extractor, if you wish to extend the solution to other container formats like AVI
, MKV
, you will have to include the support for new MIME
types in these extractors.
Lastly, some notes.
As a preferred solution, I would recommend Solution 1 as it is easy and simple.
I haven't touched upon ACodec
based implementation of the codec. However, I do feel that Solution 1 would be a far more easier solution to implement even if such a support is required in future.
If you aren't modifying the OMX
core, you shouldn't require to modify the libstagefrighthw.so
. Just FYI, this is typically implemented by the vendors as part of their vendor specific modules as in vendor/<xyz>/hardware/...
. You need to check with your platform provider on the sources for libstagefrighthw.so
.