DataSource.h revision b33d2ac90cfce0fe6db8c3e979e7ae2bbfc28163
1/* 2 * Copyright (C) 2009 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 DATA_SOURCE_H_ 18 19#define DATA_SOURCE_H_ 20 21#include <sys/types.h> 22 23#include <utils/Errors.h> 24#include <utils/KeyedVector.h> 25#include <utils/List.h> 26#include <utils/RefBase.h> 27#include <utils/threads.h> 28#include <drm/DrmManagerClient.h> 29 30namespace android { 31 32struct AMessage; 33class String8; 34 35class DataSource : public RefBase { 36public: 37 enum Flags { 38 kWantsPrefetching = 1, 39 kStreamedFromLocalHost = 2, 40 kIsCachingDataSource = 4, 41 kIsHTTPBasedSource = 8, 42 }; 43 44 static sp<DataSource> CreateFromURI( 45 const char *uri, 46 const KeyedVector<String8, String8> *headers = NULL); 47 48 DataSource() {} 49 50 virtual status_t initCheck() const = 0; 51 52 virtual ssize_t readAt(off64_t offset, void *data, size_t size) = 0; 53 54 // Convenience methods: 55 bool getUInt16(off64_t offset, uint16_t *x); 56 57 // May return ERROR_UNSUPPORTED. 58 virtual status_t getSize(off64_t *size); 59 60 virtual uint32_t flags() { 61 return 0; 62 } 63 64 //////////////////////////////////////////////////////////////////////////// 65 66 bool sniff(String8 *mimeType, float *confidence, sp<AMessage> *meta); 67 68 // The sniffer can optionally fill in "meta" with an AMessage containing 69 // a dictionary of values that helps the corresponding extractor initialize 70 // its state without duplicating effort already exerted by the sniffer. 71 typedef bool (*SnifferFunc)( 72 const sp<DataSource> &source, String8 *mimeType, 73 float *confidence, sp<AMessage> *meta); 74 75 static void RegisterSniffer(SnifferFunc func); 76 static void RegisterDefaultSniffers(); 77 78 // for DRM 79 virtual sp<DecryptHandle> DrmInitialization() { 80 return NULL; 81 } 82 virtual void getDrmInfo(sp<DecryptHandle> &handle, DrmManagerClient **client) {}; 83 84 virtual String8 getUri() { 85 return String8(); 86 } 87 88 virtual String8 getMIMEType() const; 89 90protected: 91 virtual ~DataSource() {} 92 93private: 94 static Mutex gSnifferMutex; 95 static List<SnifferFunc> gSniffers; 96 97 DataSource(const DataSource &); 98 DataSource &operator=(const DataSource &); 99}; 100 101} // namespace android 102 103#endif // DATA_SOURCE_H_ 104