implementation.h

Go to the documentation of this file.

// Copyright 2017 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//     https://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.

#ifndef SHAKA_EMBEDDED_EME_IMPLEMENTATION_H_
#define SHAKA_EMBEDDED_EME_IMPLEMENTATION_H_

#include <functional>
#include <string>
#include <vector>

#include "../macros.h"
#include "configuration.h"
#include "data.h"
#include "eme_promise.h"

namespace shaka {
namespace eme {

struct SHAKA_EXPORT KeyStatusInfo final {
  KeyStatusInfo();
  KeyStatusInfo(const std::vector<uint8_t>& key_id, MediaKeyStatus status);

  // Needed to satisfy Chromium-style.
  KeyStatusInfo(KeyStatusInfo&&);
  KeyStatusInfo(const KeyStatusInfo&);
  KeyStatusInfo& operator=(KeyStatusInfo&&);
  KeyStatusInfo& operator=(const KeyStatusInfo&);
  ~KeyStatusInfo();

  std::vector<uint8_t> key_id;
  MediaKeyStatus status;
};

inline KeyStatusInfo::KeyStatusInfo() : status(MediaKeyStatus::Usable) {}
inline KeyStatusInfo::KeyStatusInfo(const std::vector<uint8_t>& key_id,
                                    MediaKeyStatus status)
    : key_id(std::move(key_id)), status(status) {}

inline KeyStatusInfo::KeyStatusInfo(KeyStatusInfo&&) = default;
inline KeyStatusInfo::KeyStatusInfo(const KeyStatusInfo&) = default;
inline KeyStatusInfo& KeyStatusInfo::operator=(KeyStatusInfo&&) = default;
inline KeyStatusInfo& KeyStatusInfo::operator=(const KeyStatusInfo&) = default;
inline KeyStatusInfo::~KeyStatusInfo() {}


class SHAKA_EXPORT Implementation {
 public:
  // Since this is intended to be subclassed by the app, this type cannot be
  // changed without breaking ABI compatibility.  This includes adding
  // new virtual methods.

  SHAKA_DECLARE_INTERFACE_METHODS(Implementation);


  virtual bool GetExpiration(const std::string& session_id,
                             int64_t* expiration) const = 0;

  virtual bool GetKeyStatuses(const std::string& session_id,
                              std::vector<KeyStatusInfo>* statuses) const = 0;


  virtual void SetServerCertificate(EmePromise promise, Data cert) = 0;

  virtual void CreateSessionAndGenerateRequest(
      EmePromise promise,
      std::function<void(const std::string&)> set_session_id,
      MediaKeySessionType session_type, MediaKeyInitDataType init_data_type,
      Data data) = 0;

  virtual void Load(const std::string& session_id, EmePromise promise) = 0;

  virtual void Update(const std::string& session_id, EmePromise promise,
                      Data data) = 0;

  virtual void Close(const std::string& session_id, EmePromise promise) = 0;

  virtual void Remove(const std::string& session_id, EmePromise promise) = 0;


  virtual DecryptStatus Decrypt(const FrameEncryptionInfo* info,
                                const uint8_t* data, size_t data_size,
                                uint8_t* dest) const = 0;
};

}  // namespace eme
}  // namespace shaka

#endif  // SHAKA_EMBEDDED_EME_IMPLEMENTATION_H_