blob: 20ae320f13bcc2d487e755b2317d4ec9a15c9a30 [file] [log] [blame]
// Copyright 2014 The Chromium Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#ifndef COBALT_MEDIA_BASE_MEDIA_CLIENT_H_
#define COBALT_MEDIA_BASE_MEDIA_CLIENT_H_
#include <memory>
#include <string>
#include <vector>
#include "cobalt/media/base/key_system_properties.h"
#include "cobalt/media/base/media_export.h"
#include "cobalt/media/base/video_codecs.h"
#include "url/gurl.h"
namespace cobalt {
namespace media {
class MediaClient;
// Setter for the client. If a customized client is needed, it should be set
// early, before the client could possibly be used.
MEDIA_EXPORT void SetMediaClient(MediaClient* media_client);
// Media's embedder API should only be used by media.
#if defined(MEDIA_IMPLEMENTATION) || defined(MEDIA_BLINK_IMPLEMENTATION)
// Getter for the client. Returns NULL if no customized client is needed.
MEDIA_EXPORT MediaClient* GetMediaClient();
#endif
struct MEDIA_EXPORT KeySystemInfoForUMA {
KeySystemInfoForUMA(const std::string& key_system,
const std::string& key_system_name_for_uma);
~KeySystemInfoForUMA();
// Concrete key system name;
std::string key_system;
// Display name for UMA reporting. For example, the display name for
// "org.w3.clearkey" is "ClearKey". When providing this value, make sure to
// update tools/metrics/histograms/histograms.xml.
std::string key_system_name_for_uma;
};
// A client interface for embedders (e.g. content/renderer) to provide
// customized service.
class MEDIA_EXPORT MediaClient {
public:
MediaClient();
virtual ~MediaClient();
// Provides UMA info for key systems that SHOULD be reported to UMA, no matter
// whether a key system is actually supported by this client or not. Only
// called once per instance.
virtual void AddKeySystemsInfoForUMA(
std::vector<KeySystemInfoForUMA>* key_systems_info_for_uma) = 0;
// Returns whether client key systems properties should be updated.
virtual bool IsKeySystemsUpdateNeeded() = 0;
// Adds properties for supported key systems.
virtual void AddSupportedKeySystems(
std::vector<std::unique_ptr<KeySystemProperties>>*
key_systems_properties) = 0;
// Records a domain and registry of a url to a Rappor privacy-preserving
// metric. See: https://www.chromium.org/developers/design-documents/rappor
virtual void RecordRapporURL(const std::string& metric, const GURL& url) = 0;
// Returns true if the given combination of video codec, profile and level is
// supported. The |level| value is codec-specific.
virtual bool IsSupportedVideoConfig(VideoCodec codec,
VideoCodecProfile profile, int level) = 0;
};
} // namespace media
} // namespace cobalt
#endif // COBALT_MEDIA_BASE_MEDIA_CLIENT_H_