Home | History | Annotate | Download | only in include
      1 /*
      2  * Copyright (C) 2010 The Android Open Source Project
      3  *
      4  * Licensed under the Apache License, Version 2.0 (the "License");
      5  * you may not use this file except in compliance with the License.
      6  * You may obtain a copy of the License at
      7  *
      8  *      http://www.apache.org/licenses/LICENSE-2.0
      9  *
     10  * Unless required by applicable law or agreed to in writing, software
     11  * distributed under the License is distributed on an "AS IS" BASIS,
     12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
     13  * See the License for the specific language governing permissions and
     14  * limitations under the License.
     15  */
     16 
     17 #ifndef __DRM_MANAGER_H__
     18 #define __DRM_MANAGER_H__
     19 
     20 #include <utils/Errors.h>
     21 #include <utils/threads.h>
     22 #include <drm/drm_framework_common.h>
     23 #include "IDrmEngine.h"
     24 #include "PlugInManager.h"
     25 #include "IDrmServiceListener.h"
     26 
     27 namespace android {
     28 
     29 class IDrmManager;
     30 class DrmRegistrationInfo;
     31 class DrmUnregistrationInfo;
     32 class DrmRightsAcquisitionInfo;
     33 class DrmConstraints;
     34 class DrmMetadata;
     35 class DrmRights;
     36 class DrmInfo;
     37 class DrmInfoStatus;
     38 class DrmConvertedStatus;
     39 class DrmInfoRequest;
     40 class DrmSupportInfo;
     41 class ActionDescription;
     42 
     43 /**
     44  * This is implementation class for DRM Manager. This class delegates the
     45  * functionality to corresponding DRM Engine.
     46  *
     47  * The DrmManagerService class creates an instance of this class.
     48  *
     49  */
     50 class DrmManager : public IDrmEngine::OnInfoListener {
     51 public:
     52     DrmManager();
     53     virtual ~DrmManager();
     54 
     55 public:
     56     int addUniqueId(bool isNative);
     57 
     58     void removeUniqueId(int uniqueId);
     59 
     60     void addClient(int uniqueId);
     61 
     62     void removeClient(int uniqueId);
     63 
     64     status_t loadPlugIns();
     65 
     66     status_t loadPlugIns(const String8& plugInDirPath);
     67 
     68     status_t unloadPlugIns();
     69 
     70     status_t setDrmServiceListener(
     71             int uniqueId, const sp<IDrmServiceListener>& drmServiceListener);
     72 
     73     status_t installDrmEngine(int uniqueId, const String8& drmEngineFile);
     74 
     75     DrmConstraints* getConstraints(int uniqueId, const String8* path, const int action);
     76 
     77     DrmMetadata* getMetadata(int uniqueId, const String8* path);
     78 
     79     bool canHandle(int uniqueId, const String8& path, const String8& mimeType);
     80 
     81     DrmInfoStatus* processDrmInfo(int uniqueId, const DrmInfo* drmInfo);
     82 
     83     DrmInfo* acquireDrmInfo(int uniqueId, const DrmInfoRequest* drmInfoRequest);
     84 
     85     status_t saveRights(int uniqueId, const DrmRights& drmRights,
     86             const String8& rightsPath, const String8& contentPath);
     87 
     88     String8 getOriginalMimeType(int uniqueId, const String8& path);
     89 
     90     int getDrmObjectType(int uniqueId, const String8& path, const String8& mimeType);
     91 
     92     int checkRightsStatus(int uniqueId, const String8& path, int action);
     93 
     94     status_t consumeRights(int uniqueId, DecryptHandle* decryptHandle, int action, bool reserve);
     95 
     96     status_t setPlaybackStatus(
     97             int uniqueId, DecryptHandle* decryptHandle, int playbackStatus, int64_t position);
     98 
     99     bool validateAction(
    100             int uniqueId, const String8& path, int action, const ActionDescription& description);
    101 
    102     status_t removeRights(int uniqueId, const String8& path);
    103 
    104     status_t removeAllRights(int uniqueId);
    105 
    106     int openConvertSession(int uniqueId, const String8& mimeType);
    107 
    108     DrmConvertedStatus* convertData(int uniqueId, int convertId, const DrmBuffer* inputData);
    109 
    110     DrmConvertedStatus* closeConvertSession(int uniqueId, int convertId);
    111 
    112     status_t getAllSupportInfo(int uniqueId, int* length, DrmSupportInfo** drmSupportInfoArray);
    113 
    114     DecryptHandle* openDecryptSession(int uniqueId, int fd, off64_t offset, off64_t length);
    115 
    116     DecryptHandle* openDecryptSession(int uniqueId, const char* uri);
    117 
    118     status_t closeDecryptSession(int uniqueId, DecryptHandle* decryptHandle);
    119 
    120     status_t initializeDecryptUnit(int uniqueId, DecryptHandle* decryptHandle,
    121             int decryptUnitId, const DrmBuffer* headerInfo);
    122 
    123     status_t decrypt(int uniqueId, DecryptHandle* decryptHandle, int decryptUnitId,
    124             const DrmBuffer* encBuffer, DrmBuffer** decBuffer, DrmBuffer* IV);
    125 
    126     status_t finalizeDecryptUnit(int uniqueId, DecryptHandle* decryptHandle, int decryptUnitId);
    127 
    128     ssize_t pread(int uniqueId, DecryptHandle* decryptHandle,
    129             void* buffer, ssize_t numBytes, off64_t offset);
    130 
    131     void onInfo(const DrmInfoEvent& event);
    132 
    133 private:
    134     String8 getSupportedPlugInId(int uniqueId, const String8& path, const String8& mimeType);
    135 
    136     String8 getSupportedPlugInId(const String8& mimeType);
    137 
    138     String8 getSupportedPlugInIdFromPath(int uniqueId, const String8& path);
    139 
    140     bool canHandle(int uniqueId, const String8& path);
    141 
    142 private:
    143     Vector<int> mUniqueIdVector;
    144     static const String8 EMPTY_STRING;
    145 
    146     int mDecryptSessionId;
    147     int mConvertId;
    148     Mutex mLock;
    149     Mutex mListenerLock;
    150     Mutex mDecryptLock;
    151     Mutex mConvertLock;
    152     TPlugInManager<IDrmEngine> mPlugInManager;
    153     KeyedVector< DrmSupportInfo, String8 > mSupportInfoToPlugInIdMap;
    154     KeyedVector< int, IDrmEngine*> mConvertSessionMap;
    155     KeyedVector< int, sp<IDrmServiceListener> > mServiceListeners;
    156     KeyedVector< int, IDrmEngine*> mDecryptSessionMap;
    157 };
    158 
    159 };
    160 
    161 #endif /* __DRM_MANAGER_H__ */
    162 
    163