/* -*- Mode: C++; tab-width: 8; indent-tabs-mode: nil; c-basic-offset: 2 -*- */ /* vim: set ts=8 sts=2 et sw=2 tw=80: */ /* This Source Code Form is subject to the terms of the Mozilla Public * License, v. 2.0. If a copy of the MPL was not distributed with this file, * You can obtain one at http://mozilla.org/MPL/2.0/. */ #ifndef mozilla_dom_MediaKeySession_h #define mozilla_dom_MediaKeySession_h #include "DecoderDoctorLogger.h" #include "mozilla/Attributes.h" #include "nsCycleCollectionParticipant.h" #include "mozilla/DOMEventTargetHelper.h" #include "nsCOMPtr.h" #include "mozilla/dom/TypedArray.h" #include "mozilla/Mutex.h" #include "mozilla/dom/Promise.h" #include "mozilla/DetailedPromise.h" #include "mozilla/dom/MediaKeySessionBinding.h" #include "mozilla/dom/MediaKeysBinding.h" #include "mozilla/dom/MediaKeyMessageEventBinding.h" struct JSContext; namespace mozilla { class ErrorResult; namespace dom { class MediaKeySession; } // namespace dom DDLoggedTypeName(dom::MediaKeySession); namespace dom { class ArrayBufferViewOrArrayBuffer; class MediaKeyError; class MediaKeyStatusMap; nsString ToString(MediaKeySessionType aType); class MediaKeySession final : public DOMEventTargetHelper, public DecoderDoctorLifeLogger { public: NS_DECL_ISUPPORTS_INHERITED NS_DECL_CYCLE_COLLECTION_CLASS_INHERITED(MediaKeySession, DOMEventTargetHelper) public: MediaKeySession(nsPIDOMWindowInner* aParent, MediaKeys* aKeys, const nsAString& aKeySystem, MediaKeySessionType aSessionType, bool aHardwareDecryption, ErrorResult& aRv); void SetSessionId(const nsAString& aSessionId); JSObject* WrapObject(JSContext* aCx, JS::Handle aGivenProto) override; // Mark this as resultNotAddRefed to return raw pointers MediaKeyError* GetError() const; MediaKeyStatusMap* KeyStatuses() const; void GetSessionId(nsString& aRetval) const; const nsString& GetSessionId() const; // Number of ms since epoch at which expiration occurs, or NaN if unknown. // TODO: The type of this attribute is still under contention. // https://www.w3.org/Bugs/Public/show_bug.cgi?id=25902 double Expiration() const; Promise* Closed() const; already_AddRefed GenerateRequest( const nsAString& aInitDataType, const ArrayBufferViewOrArrayBuffer& aInitData, ErrorResult& aRv); already_AddRefed Load(const nsAString& aSessionId, ErrorResult& aRv); already_AddRefed Update(const ArrayBufferViewOrArrayBuffer& response, ErrorResult& aRv); already_AddRefed Close(ErrorResult& aRv); already_AddRefed Remove(ErrorResult& aRv); void DispatchKeyMessage(MediaKeyMessageType aMessageType, const nsTArray& aMessage); void DispatchKeyError(uint32_t system_code); void DispatchKeyStatusesChange(); void OnClosed(); bool IsClosed() const; void SetExpiration(double aExpiry); mozilla::dom::EventHandlerNonNull* GetOnkeystatuseschange(); void SetOnkeystatuseschange(mozilla::dom::EventHandlerNonNull* aCallback); mozilla::dom::EventHandlerNonNull* GetOnmessage(); void SetOnmessage(mozilla::dom::EventHandlerNonNull* aCallback); // Process-unique identifier. uint32_t Token() const; private: ~MediaKeySession(); void UpdateKeyStatusMap(); bool IsCallable() const { // The EME spec sets the "callable value" to true whenever the CDM sets // the sessionId. When the session is initialized, sessionId is empty and // callable is thus false. return !mSessionId.IsEmpty(); } already_AddRefed MakePromise(ErrorResult& aRv, const nsACString& aName); // EME spec, starting from 6.6.2.7 // https://w3c.github.io/encrypted-media/ void CompleteGenerateRequest(const nsString& aInitDataType, nsTArray& aData, DetailedPromise* aPromise); RefPtr mClosed; RefPtr mMediaKeyError; RefPtr mKeys; const nsString mKeySystem; nsString mSessionId; const MediaKeySessionType mSessionType; const uint32_t mToken; bool mIsClosed; bool mUninitialized; RefPtr mKeyStatusMap; double mExpiration; // True if this key session is related with hardware decryption. bool mHardwareDecryption; }; } // namespace dom } // namespace mozilla #endif