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, 51783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang }; 52783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang 53783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang struct SubSample { 54783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang uint32_t mNumBytesOfClearData; 55783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang uint32_t mNumBytesOfEncryptedData; 56783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang }; 57783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang 58783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang DescramblerPlugin() {} 59783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang virtual ~DescramblerPlugin() {} 60783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang 61783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang // If this method returns false, a non-secure decoder will be used to 62783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang // decode the data after decryption. The decrypt API below will have 63783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang // to support insecure decryption of the data (secure = false) for 64783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang // media data of the given mime type. 65783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang virtual bool requiresSecureDecoderComponent(const char *mime) const = 0; 66783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang 67783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang // A MediaCas session may be associated with a MediaCrypto session. The 68783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang // associated MediaCas session is used to load decryption keys 69783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang // into the crypto/cas plugin. The keys are then referenced by key-id 70783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang // in the 'key' parameter to the decrypt() method. 71783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang // Should return NO_ERROR on success, ERROR_DRM_SESSION_NOT_OPENED if 72783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang // the session is not opened and a code from MediaErrors.h otherwise. 73783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang virtual status_t setMediaCasSession(const CasSessionId& sessionId) = 0; 74783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang 75783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang // If the error returned falls into the range 76783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang // ERROR_DRM_VENDOR_MIN..ERROR_DRM_VENDOR_MAX, errorDetailMsg should be 77783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang // filled in with an appropriate string. 78783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang // At the java level these special errors will then trigger a 79783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang // MediaCodec.CryptoException that gives clients access to both 80783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang // the error code and the errorDetailMsg. 81783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang // Returns a non-negative result to indicate the number of bytes written 82783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang // to the dstPtr, or a negative result to indicate an error. 83783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang virtual ssize_t descramble( 84783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang bool secure, 85783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang ScramblingControl scramblingControl, 86783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang size_t numSubSamples, 87783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang const SubSample *subSamples, 88783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang const void *srcPtr, 89783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang int32_t srcOffset, 90783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang void *dstPtr, 91783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang int32_t dstOffset, 92783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang AString *errorDetailMsg) = 0; 93783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang 94783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhangprivate: 95783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang DescramblerPlugin(const DescramblerPlugin &); 96783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang DescramblerPlugin &operator=(const DescramblerPlugin &); 97783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang}; 98783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang 99783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang} // namespace android 100783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang 101783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhangextern "C" { 102783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang extern android::DescramblerFactory *createDescramblerFactory(); 103783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang} 104783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang 105783c33e19c81d1b4c23664060e8d3a0b59fa7961Chong Zhang#endif // DESCRAMBLER_API_H_ 106