Clarify that MediaCrypto.setMediaDrmSession cannot switch DRM schemes

Bug: 244832508
Change-Id: I88cf4936554731354e326890ea7b66143c8d7c15
This commit is contained in:
Ian Baker
2022-10-18 17:03:26 +00:00
parent 14e32e179e
commit 07f35e7e2b

View File

@@ -75,14 +75,17 @@ public final class MediaCrypto {
public final native boolean requiresSecureDecoderComponent(@NonNull String mime);
/**
* Associate a MediaDrm session with this MediaCrypto instance. The
* MediaDrm session is used to securely load decryption keys for a
* crypto scheme. The crypto keys loaded through the MediaDrm session
* Associate a new MediaDrm session with this MediaCrypto instance.
*
* <p>The MediaDrm session is used to securely load decryption keys for a
* crypto scheme. The crypto keys loaded through the MediaDrm session
* may be selected for use during the decryption operation performed
* by {@link android.media.MediaCodec#queueSecureInputBuffer} by specifying
* their key ids in the {@link android.media.MediaCodec.CryptoInfo#key} field.
* @param sessionId the MediaDrm sessionId to associate with this
* MediaCrypto instance
* their key IDs in the {@link android.media.MediaCodec.CryptoInfo#key} field.
*
* @param sessionId The MediaDrm sessionId to associate with this MediaCrypto
* instance. The session's scheme must match the scheme UUID used when
* constructing this MediaCrypto instance.
* @throws MediaCryptoException on failure to set the sessionId
*/
public final native void setMediaDrmSession(@NonNull byte[] sessionId)