68587be8a0
[ Merge of http://go/wvgerrit/93838 ] Some more rework of policy engine/policy timers code to support timer and clock value handling introduced by OEMCrypto v16. Changes are * renamed methods to include rental duration since policies for v16 use rental and playback duration for all licenses. Previously rental and playback durations enforced timing for persistent licenses and license duration was used for streaming licenses. * Moved some common code to the base PolicyTimer class from PolicyTimerV15. * Corrected data member naming (policy_timers -> policy_timers_) * Updated comments Bug: 139372190 Test: Android WV unit/integration tests Change-Id: Id925ddcc14608a8500f30c2c68486d91608a9abe
119 lines
4.5 KiB
C++
119 lines
4.5 KiB
C++
// Copyright 2020 Google LLC. All Rights Reserved. This file and proprietary
|
|
// source code may only be used and distributed under the Widevine Master
|
|
// License Agreement.
|
|
|
|
#ifndef WVCDM_CORE_POLICY_TIMERS_H_
|
|
#define WVCDM_CORE_POLICY_TIMERS_H_
|
|
|
|
#include <memory>
|
|
#include <string>
|
|
|
|
#include "disallow_copy_and_assign.h"
|
|
#include "license_protocol.pb.h"
|
|
#include "wv_cdm_types.h"
|
|
|
|
namespace wvcdm {
|
|
|
|
// This is driven by the Policy Engine and maintains timer related
|
|
// information from the policy such as duration windows and renewals.
|
|
// Timer expiration behavior has changed with the introduction of core
|
|
// messages in OEMCrypto v16. Handling of behavior that differs between
|
|
// a OEMCrypto v16 license with core messages and one without is left to
|
|
// a class that derives from this interface.
|
|
|
|
class PolicyTimers {
|
|
public:
|
|
virtual ~PolicyTimers() {}
|
|
|
|
// SetLicense is used in handling the initial license response.
|
|
virtual void SetLicense(const video_widevine::License& license);
|
|
|
|
// UpdateLicense is used in handling a license response for a renewal request.
|
|
// The response may only contain policy fields that have changed. In this
|
|
// case an exact copy is not what we want to happen.
|
|
virtual bool UpdateLicense(int64_t current_time,
|
|
const video_widevine::License& license) = 0;
|
|
|
|
// Call this on first decrypt to set the start of playback.
|
|
virtual void BeginDecryption(int64_t current_time) = 0;
|
|
// Call this periodically to update the most recent playback time.
|
|
virtual void DecryptionEvent(int64_t current_time);
|
|
|
|
// For offline save and restore
|
|
virtual int64_t GetPlaybackStartTime() { return playback_start_time_; }
|
|
virtual int64_t GetLastPlaybackTime() { return last_playback_time_; }
|
|
virtual int64_t GetGracePeriodEndTime() = 0;
|
|
virtual void RestorePlaybackTimes(int64_t current_time,
|
|
int64_t playback_start_time,
|
|
int64_t last_playback_time,
|
|
int64_t grace_period_end_time) = 0;
|
|
|
|
virtual bool HasPlaybackStarted(int64_t current_time) = 0;
|
|
virtual bool HasLicenseOrRentalOrPlaybackDurationExpired(
|
|
int64_t current_time) = 0;
|
|
virtual bool HasPassedGracePeriod(int64_t current_time) = 0;
|
|
|
|
virtual int64_t GetLicenseOrRentalOrPlaybackDurationRemaining(
|
|
int64_t current_time) = 0;
|
|
virtual int64_t GetLicenseOrRentalDurationRemaining(int64_t current_time) = 0;
|
|
// This is only used in Query. This should return |playback_duration_seconds|
|
|
// before playback begins or the time remaining on
|
|
// |playback_duration_seconds| after playback begins.
|
|
virtual int64_t GetPlaybackDurationRemaining(int64_t current_time);
|
|
|
|
virtual bool GetSecondsSinceStarted(int64_t current_time,
|
|
int64_t* seconds_since_started);
|
|
virtual bool GetSecondsSinceLastPlayed(int64_t current_time,
|
|
int64_t* seconds_since_started);
|
|
|
|
virtual bool IsLicenseForFuture(int64_t current_time);
|
|
|
|
virtual bool UpdateExpirationTime(int64_t current_time, int64_t* expiry_time);
|
|
|
|
// Renewal related methods
|
|
virtual bool HasRenewalDelayExpired(int64_t current_time);
|
|
virtual bool HasRenewalRetryIntervalExpired(int64_t current_time);
|
|
virtual void UpdateRenewalRequest(int64_t current_time);
|
|
virtual bool HasRenewalRecoveryDurationExpired(int64_t current_time);
|
|
|
|
const video_widevine::License::Policy& get_policy() { return policy_; }
|
|
|
|
protected:
|
|
PolicyTimers()
|
|
: license_start_time_(0),
|
|
playback_start_time_(0),
|
|
last_playback_time_(0),
|
|
last_expiry_time_(0),
|
|
last_expiry_time_set_(false),
|
|
next_renewal_time_(0),
|
|
was_expired_on_load_(false) {}
|
|
|
|
// Gets the clock time that the license expires based on whether we have
|
|
// started playing.
|
|
virtual int64_t GetExpiryTime(int64_t current_time,
|
|
bool ignore_soft_enforce_playback_duration) = 0;
|
|
|
|
virtual int64_t GetRenewalStartTime() = 0;
|
|
|
|
// This is the current policy information for this license. This gets updated
|
|
// as license renewals occur.
|
|
video_widevine::License::Policy policy_;
|
|
|
|
int64_t license_start_time_;
|
|
int64_t playback_start_time_;
|
|
int64_t last_playback_time_;
|
|
int64_t last_expiry_time_;
|
|
int64_t last_expiry_time_set_;
|
|
int64_t next_renewal_time_;
|
|
|
|
// Indicates whether a persistent license was expired when loaded
|
|
bool was_expired_on_load_;
|
|
|
|
private:
|
|
CORE_DISALLOW_COPY_AND_ASSIGN(PolicyTimers);
|
|
};
|
|
|
|
} // namespace wvcdm
|
|
|
|
#endif // WVCDM_CORE_POLICY_TIMERS_H_
|