DataSource.h revision ee4e1b1a63758941460ae79a064249d3a5189443
120111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber/* 220111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber * Copyright (C) 2009 The Android Open Source Project 320111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber * 420111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber * Licensed under the Apache License, Version 2.0 (the "License"); 520111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber * you may not use this file except in compliance with the License. 620111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber * You may obtain a copy of the License at 720111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber * 820111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber * http://www.apache.org/licenses/LICENSE-2.0 920111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber * 1020111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber * Unless required by applicable law or agreed to in writing, software 1120111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber * distributed under the License is distributed on an "AS IS" BASIS, 1220111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 1320111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber * See the License for the specific language governing permissions and 1420111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber * limitations under the License. 1520111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber */ 1620111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber 1720111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber#ifndef DATA_SOURCE_H_ 1820111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber 1920111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber#define DATA_SOURCE_H_ 2020111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber 2120111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber#include <sys/types.h> 2220111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber 230683eba6b35c396c21f10e926709f2f8fc05f090Andreas Huber#include <media/stagefright/MediaErrors.h> 2420111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber#include <utils/Errors.h> 255561ccf4a8db88a2e44eac1b3ed13b4ff53a7f20Andreas Huber#include <utils/KeyedVector.h> 2620111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber#include <utils/List.h> 27693d271e62a3726689ff68f4505ba49228eb94b2Andreas Huber#include <utils/RefBase.h> 2820111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber#include <utils/threads.h> 29dcd25efb46c41c8d24a0a9cf61fb57f84149709eGloria Wang#include <drm/DrmManagerClient.h> 3020111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber 3120111aa043c5f404472bc63b90bc5aad906b1101Andreas Hubernamespace android { 3220111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber 335a1c3529e4fa2f8a11054181294e0ce79fff8dd3Andreas Huberstruct AMessage; 343de157dd8f9cd45bf9b0406268f5830887105ae1Chong Zhangstruct AString; 35ee4e1b1a63758941460ae79a064249d3a5189443Lajos Molnarclass IDataSource; 361b86fe063badb5f28c467ade39be0f4008688947Andreas Huberstruct IMediaHTTPService; 3720111aa043c5f404472bc63b90bc5aad906b1101Andreas Huberclass String8; 38360d6d0924f99b82ebacb5cfb6f7bca95e11b4eeRobert Shihstruct HTTPBase; 3920111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber 40693d271e62a3726689ff68f4505ba49228eb94b2Andreas Huberclass DataSource : public RefBase { 4120111aa043c5f404472bc63b90bc5aad906b1101Andreas Huberpublic: 4266b0a35c9a4136a84c3f73b1b25fcb5220138b95Andreas Huber enum Flags { 43acdd9d0f59c3d8bdc3de80664a609527ec3d21e2Andreas Huber kWantsPrefetching = 1, 44acdd9d0f59c3d8bdc3de80664a609527ec3d21e2Andreas Huber kStreamedFromLocalHost = 2, 45bff07d0b22a5ee2d9f044f6cb5e4be1532017ab0Andreas Huber kIsCachingDataSource = 4, 46b33d2ac90cfce0fe6db8c3e979e7ae2bbfc28163James Dong kIsHTTPBasedSource = 8, 4766b0a35c9a4136a84c3f73b1b25fcb5220138b95Andreas Huber }; 4866b0a35c9a4136a84c3f73b1b25fcb5220138b95Andreas Huber 495561ccf4a8db88a2e44eac1b3ed13b4ff53a7f20Andreas Huber static sp<DataSource> CreateFromURI( 501b86fe063badb5f28c467ade39be0f4008688947Andreas Huber const sp<IMediaHTTPService> &httpService, 515561ccf4a8db88a2e44eac1b3ed13b4ff53a7f20Andreas Huber const char *uri, 523de157dd8f9cd45bf9b0406268f5830887105ae1Chong Zhang const KeyedVector<String8, String8> *headers = NULL, 53360d6d0924f99b82ebacb5cfb6f7bca95e11b4eeRobert Shih String8 *contentType = NULL, 54360d6d0924f99b82ebacb5cfb6f7bca95e11b4eeRobert Shih HTTPBase *httpSource = NULL); 55360d6d0924f99b82ebacb5cfb6f7bca95e11b4eeRobert Shih 56360d6d0924f99b82ebacb5cfb6f7bca95e11b4eeRobert Shih static sp<DataSource> CreateMediaHTTP(const sp<IMediaHTTPService> &httpService); 5799f31604136d66ae10e20669fb6b5716f342bde0Chris Watkins static sp<DataSource> CreateFromIDataSource(const sp<IDataSource> &source); 58fc9ba09e3bb368f823d473f5e2bb9aa32dba6289Andreas Huber 5920111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber DataSource() {} 6020111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber 6134769bc913e9f6bb138e666d94a9d685bf3da217Andreas Huber virtual status_t initCheck() const = 0; 6234769bc913e9f6bb138e666d94a9d685bf3da217Andreas Huber 6399f31604136d66ae10e20669fb6b5716f342bde0Chris Watkins // Returns the number of bytes read, or -1 on failure. It's not an error if 6499f31604136d66ae10e20669fb6b5716f342bde0Chris Watkins // this returns zero; it just means the given offset is equal to, or 6599f31604136d66ae10e20669fb6b5716f342bde0Chris Watkins // beyond, the end of the source. 66c7fc37a3dab9bd1f96713649f351b5990e6316ffJames Dong virtual ssize_t readAt(off64_t offset, void *data, size_t size) = 0; 6720111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber 68693d271e62a3726689ff68f4505ba49228eb94b2Andreas Huber // Convenience methods: 69c7fc37a3dab9bd1f96713649f351b5990e6316ffJames Dong bool getUInt16(off64_t offset, uint16_t *x); 70ec77122351b4e78c1fe5b60a208f76baf8c67591Marco Nelissen bool getUInt24(off64_t offset, uint32_t *x); // 3 byte int, returned as a 32-bit int 7105f625c46b992ab66b8d1527a366fe2746b4e3c7Marco Nelissen bool getUInt32(off64_t offset, uint32_t *x); 7205f625c46b992ab66b8d1527a366fe2746b4e3c7Marco Nelissen bool getUInt64(off64_t offset, uint64_t *x); 73693d271e62a3726689ff68f4505ba49228eb94b2Andreas Huber 7420111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber // May return ERROR_UNSUPPORTED. 75c7fc37a3dab9bd1f96713649f351b5990e6316ffJames Dong virtual status_t getSize(off64_t *size); 7620111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber 7766b0a35c9a4136a84c3f73b1b25fcb5220138b95Andreas Huber virtual uint32_t flags() { 7866b0a35c9a4136a84c3f73b1b25fcb5220138b95Andreas Huber return 0; 7966b0a35c9a4136a84c3f73b1b25fcb5220138b95Andreas Huber } 8066b0a35c9a4136a84c3f73b1b25fcb5220138b95Andreas Huber 810683eba6b35c396c21f10e926709f2f8fc05f090Andreas Huber virtual status_t reconnectAtOffset(off64_t offset) { 820683eba6b35c396c21f10e926709f2f8fc05f090Andreas Huber return ERROR_UNSUPPORTED; 830683eba6b35c396c21f10e926709f2f8fc05f090Andreas Huber } 840683eba6b35c396c21f10e926709f2f8fc05f090Andreas Huber 8520111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber //////////////////////////////////////////////////////////////////////////// 8620111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber 875a1c3529e4fa2f8a11054181294e0ce79fff8dd3Andreas Huber bool sniff(String8 *mimeType, float *confidence, sp<AMessage> *meta); 8820111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber 895a1c3529e4fa2f8a11054181294e0ce79fff8dd3Andreas Huber // The sniffer can optionally fill in "meta" with an AMessage containing 905a1c3529e4fa2f8a11054181294e0ce79fff8dd3Andreas Huber // a dictionary of values that helps the corresponding extractor initialize 915a1c3529e4fa2f8a11054181294e0ce79fff8dd3Andreas Huber // its state without duplicating effort already exerted by the sniffer. 9220111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber typedef bool (*SnifferFunc)( 935a1c3529e4fa2f8a11054181294e0ce79fff8dd3Andreas Huber const sp<DataSource> &source, String8 *mimeType, 945a1c3529e4fa2f8a11054181294e0ce79fff8dd3Andreas Huber float *confidence, sp<AMessage> *meta); 9520111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber 9620111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber static void RegisterDefaultSniffers(); 9720111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber 98dcd25efb46c41c8d24a0a9cf61fb57f84149709eGloria Wang // for DRM 999d2f386dd2885eaffa11fd494ae258bb09fe6397James Dong virtual sp<DecryptHandle> DrmInitialization(const char *mime = NULL) { 100dcd25efb46c41c8d24a0a9cf61fb57f84149709eGloria Wang return NULL; 101dcd25efb46c41c8d24a0a9cf61fb57f84149709eGloria Wang } 102b5ce361d19e69fe156f7188c9ee0f4734b259874Gloria Wang virtual void getDrmInfo(sp<DecryptHandle> &handle, DrmManagerClient **client) {}; 103dcd25efb46c41c8d24a0a9cf61fb57f84149709eGloria Wang 104771b85d9245a24273497792a2515d88d31c99e1eGloria Wang virtual String8 getUri() { 105771b85d9245a24273497792a2515d88d31c99e1eGloria Wang return String8(); 106771b85d9245a24273497792a2515d88d31c99e1eGloria Wang } 107dcd25efb46c41c8d24a0a9cf61fb57f84149709eGloria Wang 1086511c9755c3a3360ba869772600c7aae048a7ffcAndreas Huber virtual String8 getMIMEType() const; 1096511c9755c3a3360ba869772600c7aae048a7ffcAndreas Huber 110693d271e62a3726689ff68f4505ba49228eb94b2Andreas Huberprotected: 111693d271e62a3726689ff68f4505ba49228eb94b2Andreas Huber virtual ~DataSource() {} 112693d271e62a3726689ff68f4505ba49228eb94b2Andreas Huber 11320111aa043c5f404472bc63b90bc5aad906b1101Andreas Huberprivate: 11420111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber static Mutex gSnifferMutex; 11520111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber static List<SnifferFunc> gSniffers; 116377fce69297a0e5b7c3b266a7602b17146785635Marco Nelissen static bool gSniffersRegistered; 117377fce69297a0e5b7c3b266a7602b17146785635Marco Nelissen 118377fce69297a0e5b7c3b266a7602b17146785635Marco Nelissen static void RegisterSniffer_l(SnifferFunc func); 11920111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber 12020111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber DataSource(const DataSource &); 12120111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber DataSource &operator=(const DataSource &); 12220111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber}; 12320111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber 12420111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber} // namespace android 12520111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber 12620111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber#endif // DATA_SOURCE_H_ 127