mirror of https://github.com/NekoX-Dev/NekoX.git
122 lines
4.4 KiB
Java
122 lines
4.4 KiB
Java
/*
|
|
* Copyright (C) 2016 The Android Open Source Project
|
|
*
|
|
* 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
|
|
*
|
|
* http://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.
|
|
*/
|
|
package com.google.android.exoplayer2.drm;
|
|
|
|
import android.os.Looper;
|
|
import androidx.annotation.Nullable;
|
|
import com.google.android.exoplayer2.C;
|
|
import com.google.android.exoplayer2.drm.DrmInitData.SchemeData;
|
|
|
|
/**
|
|
* Manages a DRM session.
|
|
*/
|
|
public interface DrmSessionManager<T extends ExoMediaCrypto> {
|
|
|
|
/** Returns {@link #DUMMY}. */
|
|
@SuppressWarnings("unchecked")
|
|
static <T extends ExoMediaCrypto> DrmSessionManager<T> getDummyDrmSessionManager() {
|
|
return (DrmSessionManager<T>) DUMMY;
|
|
}
|
|
|
|
/** {@link DrmSessionManager} that supports no DRM schemes. */
|
|
DrmSessionManager<ExoMediaCrypto> DUMMY =
|
|
new DrmSessionManager<ExoMediaCrypto>() {
|
|
|
|
@Override
|
|
public boolean canAcquireSession(DrmInitData drmInitData) {
|
|
return false;
|
|
}
|
|
|
|
@Override
|
|
public DrmSession<ExoMediaCrypto> acquireSession(
|
|
Looper playbackLooper, DrmInitData drmInitData) {
|
|
return new ErrorStateDrmSession<>(
|
|
new DrmSession.DrmSessionException(
|
|
new UnsupportedDrmException(UnsupportedDrmException.REASON_UNSUPPORTED_SCHEME)));
|
|
}
|
|
|
|
@Override
|
|
@Nullable
|
|
public Class<ExoMediaCrypto> getExoMediaCryptoType(DrmInitData drmInitData) {
|
|
return null;
|
|
}
|
|
};
|
|
|
|
/**
|
|
* Acquires any required resources.
|
|
*
|
|
* <p>{@link #release()} must be called to ensure the acquired resources are released. After
|
|
* releasing, an instance may be re-prepared.
|
|
*/
|
|
default void prepare() {
|
|
// Do nothing.
|
|
}
|
|
|
|
/** Releases any acquired resources. */
|
|
default void release() {
|
|
// Do nothing.
|
|
}
|
|
|
|
/**
|
|
* Returns whether the manager is capable of acquiring a session for the given
|
|
* {@link DrmInitData}.
|
|
*
|
|
* @param drmInitData DRM initialization data.
|
|
* @return Whether the manager is capable of acquiring a session for the given
|
|
* {@link DrmInitData}.
|
|
*/
|
|
boolean canAcquireSession(DrmInitData drmInitData);
|
|
|
|
/**
|
|
* Returns a {@link DrmSession} that does not execute key requests, with an incremented reference
|
|
* count. When the caller no longer needs to use the instance, it must call {@link
|
|
* DrmSession#release()} to decrement the reference count.
|
|
*
|
|
* <p>Placeholder {@link DrmSession DrmSessions} may be used to configure secure decoders for
|
|
* playback of clear content periods. This can reduce the cost of transitioning between clear and
|
|
* encrypted content periods.
|
|
*
|
|
* @param playbackLooper The looper associated with the media playback thread.
|
|
* @param trackType The type of the track to acquire a placeholder session for. Must be one of the
|
|
* {@link C}{@code .TRACK_TYPE_*} constants.
|
|
* @return The placeholder DRM session, or null if this DRM session manager does not support
|
|
* placeholder sessions.
|
|
*/
|
|
@Nullable
|
|
default DrmSession<T> acquirePlaceholderSession(Looper playbackLooper, int trackType) {
|
|
return null;
|
|
}
|
|
|
|
/**
|
|
* Returns a {@link DrmSession} for the specified {@link DrmInitData}, with an incremented
|
|
* reference count. When the caller no longer needs to use the instance, it must call {@link
|
|
* DrmSession#release()} to decrement the reference count.
|
|
*
|
|
* @param playbackLooper The looper associated with the media playback thread.
|
|
* @param drmInitData DRM initialization data. All contained {@link SchemeData}s must contain
|
|
* non-null {@link SchemeData#data}.
|
|
* @return The DRM session.
|
|
*/
|
|
DrmSession<T> acquireSession(Looper playbackLooper, DrmInitData drmInitData);
|
|
|
|
/**
|
|
* Returns the {@link ExoMediaCrypto} type returned by sessions acquired using the given {@link
|
|
* DrmInitData}, or null if a session cannot be acquired with the given {@link DrmInitData}.
|
|
*/
|
|
@Nullable
|
|
Class<? extends ExoMediaCrypto> getExoMediaCryptoType(DrmInitData drmInitData);
|
|
}
|