Home | History | Annotate | Download | only in android
      1 // Copyright (c) 2013 The Chromium Authors. All rights reserved.
      2 // Use of this source code is governed by a BSD-style license that can be
      3 // found in the LICENSE file.
      4 
      5 #ifndef MEDIA_BASE_ANDROID_MEDIA_RESOURCE_GETTER_H_
      6 #define MEDIA_BASE_ANDROID_MEDIA_RESOURCE_GETTER_H_
      7 
      8 #include <string>
      9 
     10 #include "base/callback.h"
     11 #include "base/files/file_path.h"
     12 #include "base/strings/string16.h"
     13 #include "base/time/time.h"
     14 #include "media/base/media_export.h"
     15 #include "url/gurl.h"
     16 
     17 namespace media {
     18 
     19 // Class for asynchronously retrieving resources for a media URL. All callbacks
     20 // are executed on the caller's thread.
     21 class MEDIA_EXPORT MediaResourceGetter {
     22  public:
     23   // Callback to get the cookies. Args: cookies string.
     24   typedef base::Callback<void(const std::string&)> GetCookieCB;
     25 
     26   // Callback to get the platform path. Args: platform path.
     27   typedef base::Callback<void(const std::string&)> GetPlatformPathCB;
     28 
     29   // Callback to get the auth credentials. Args: username and password.
     30   typedef base::Callback<void(const base::string16&, const base::string16&)>
     31       GetAuthCredentialsCB;
     32 
     33   // Callback to get the media metadata. Args: duration, width, height, and
     34   // whether the information is retrieved successfully.
     35   typedef base::Callback<void(base::TimeDelta, int, int, bool)>
     36       ExtractMediaMetadataCB;
     37   virtual ~MediaResourceGetter();
     38 
     39   // Method for getting the auth credentials for a URL.
     40   virtual void GetAuthCredentials(const GURL& url,
     41                                   const GetAuthCredentialsCB& callback) = 0;
     42 
     43   // Method for getting the cookies for a given URL.
     44   virtual void GetCookies(const GURL& url,
     45                           const GURL& first_party_for_cookies,
     46                           const GetCookieCB& callback) = 0;
     47 
     48   // Method for getting the platform path from a file system or blob URL.
     49   virtual void GetPlatformPathFromURL(
     50       const GURL& url,
     51       const GetPlatformPathCB& callback) = 0;
     52 
     53   // Extracts the metadata from a media URL. Once completed, the provided
     54   // callback function will be run.
     55   virtual void ExtractMediaMetadata(
     56       const std::string& url,
     57       const std::string& cookies,
     58       const std::string& user_agent,
     59       const ExtractMediaMetadataCB& callback) = 0;
     60 
     61   // Extracts the metadata from a file descriptor. Once completed, the
     62   // provided callback function will be run.
     63   virtual void ExtractMediaMetadata(
     64       const int fd,
     65       const int64 offset,
     66       const int64 size,
     67       const ExtractMediaMetadataCB& callback) = 0;
     68 };
     69 
     70 }  // namespace media
     71 
     72 #endif  // MEDIA_BASE_ANDROID_MEDIA_RESOURCE_GETTER_H_
     73