media/base/android/media_resource_getter.h

   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_