1783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang/* 2783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang * Copyright (C) 2017 The Android Open Source Project 3783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang * 4783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang * Licensed under the Apache License, Version 2.0 (the "License"); 5783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang * you may not use this file except in compliance with the License. 6783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang * You may obtain a copy of the License at 7783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang * 8783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang * http://www.apache.org/licenses/LICENSE-2.0 9783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang * 10783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang * Unless required by applicable law or agreed to in writing, software 11783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang * distributed under the License is distributed on an "AS IS" BASIS, 12783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang * See the License for the specific language governing permissions and 14783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang * limitations under the License. 15783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang */ 16783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang 17783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang#ifndef DESCRAMBLER_API_H_ 18783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang#define DESCRAMBLER_API_H_ 19783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang 20783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang#include <media/stagefright/MediaErrors.h> 21783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang#include <media/cas/CasAPI.h> 22783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang 23783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhangnamespace android { 24783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang 25783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhangstruct AString; 26783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhangstruct DescramblerPlugin; 27783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang 28783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhangstruct DescramblerFactory { 29783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang DescramblerFactory() {} 30783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang virtual ~DescramblerFactory() {} 31783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang 32783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang // Determine if the plugin can handle the CA scheme identified by CA_system_id. 33783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang virtual bool isSystemIdSupported( 34783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang int32_t CA_system_id) const = 0; 35783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang 36783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang // Construct a new instance of a DescramblerPlugin given a CA_system_id 37783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang virtual status_t createPlugin( 38783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang int32_t CA_system_id, DescramblerPlugin **plugin) = 0; 39783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang 40783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhangprivate: 41783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang DescramblerFactory(const DescramblerFactory &); 42783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang DescramblerFactory &operator=(const DescramblerFactory &); 43783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang}; 44783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang 45783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhangstruct DescramblerPlugin { 46783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang enum ScramblingControl { 47783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang kScrambling_Unscrambled = 0, 48783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang kScrambling_Reserved = 1, 49783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang kScrambling_EvenKey = 2, 50783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang kScrambling_OddKey = 3, 5103ea4fe1ce458cb7b0721af1dda24e901dd70b69Chong Zhang kScrambling_Mask_Key = 0x3, 5203ea4fe1ce458cb7b0721af1dda24e901dd70b69Chong Zhang 5303ea4fe1ce458cb7b0721af1dda24e901dd70b69Chong Zhang // Hint that the descrambling request is for a PES header only 5403ea4fe1ce458cb7b0721af1dda24e901dd70b69Chong Zhang kScrambling_Flag_PesHeader = (1 << 31), 55783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang }; 56783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang 57783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang struct SubSample { 58783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang uint32_t mNumBytesOfClearData; 59783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang uint32_t mNumBytesOfEncryptedData; 60783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang }; 61783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang 62783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang DescramblerPlugin() {} 63783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang virtual ~DescramblerPlugin() {} 64783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang 65783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang // If this method returns false, a non-secure decoder will be used to 66783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang // decode the data after decryption. The decrypt API below will have 67783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang // to support insecure decryption of the data (secure = false) for 68783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang // media data of the given mime type. 69783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang virtual bool requiresSecureDecoderComponent(const char *mime) const = 0; 70783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang 71783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang // A MediaCas session may be associated with a MediaCrypto session. The 72783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang // associated MediaCas session is used to load decryption keys 73783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang // into the crypto/cas plugin. The keys are then referenced by key-id 74783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang // in the 'key' parameter to the decrypt() method. 75783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang // Should return NO_ERROR on success, ERROR_DRM_SESSION_NOT_OPENED if 76783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang // the session is not opened and a code from MediaErrors.h otherwise. 77783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang virtual status_t setMediaCasSession(const CasSessionId& sessionId) = 0; 78783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang 79783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang // If the error returned falls into the range 80783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang // ERROR_DRM_VENDOR_MIN..ERROR_DRM_VENDOR_MAX, errorDetailMsg should be 81783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang // filled in with an appropriate string. 82783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang // At the java level these special errors will then trigger a 83783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang // MediaCodec.CryptoException that gives clients access to both 84783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang // the error code and the errorDetailMsg. 85783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang // Returns a non-negative result to indicate the number of bytes written 86783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang // to the dstPtr, or a negative result to indicate an error. 87783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang virtual ssize_t descramble( 88783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang bool secure, 89783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang ScramblingControl scramblingControl, 90783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang size_t numSubSamples, 91783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang const SubSample *subSamples, 92783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang const void *srcPtr, 93783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang int32_t srcOffset, 94783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang void *dstPtr, 95783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang int32_t dstOffset, 96783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang AString *errorDetailMsg) = 0; 97783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang 98783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhangprivate: 99783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang DescramblerPlugin(const DescramblerPlugin &); 100783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang DescramblerPlugin &operator=(const DescramblerPlugin &); 101783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang}; 102783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang 103783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang} // namespace android 104783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang 105783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhangextern "C" { 106783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang extern android::DescramblerFactory *createDescramblerFactory(); 107783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang} 108783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang 109783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang#endif // DESCRAMBLER_API_H_ 110