Move nested classes out of Tuner.java (cecc980a) · Commits · e / os / android_frameworks_base

media/java/android/media/tv/tuner/Descrambler.java

0 → 100644

+103 −0

Original line number	Original line	Diff line number	Diff line
			/*
			* Copyright 2019 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 android.media.tv.tuner;

			import android.annotation.Nullable;
			import android.media.tv.tuner.Tuner.Filter;
			import android.media.tv.tuner.TunerConstants.DemuxPidType;

			/**
			* This class is used to interact with descramblers.
			*
			* <p> Descrambler is a hardware component used to descramble data.
			*
			* <p> This class controls the TIS interaction with Tuner HAL.
			* @hide
			*/
			public class Descrambler implements AutoCloseable {
			private long mNativeContext;

			private native int nativeAddPid(int pidType, int pid, Filter filter);
			private native int nativeRemovePid(int pidType, int pid, Filter filter);
			private native int nativeSetKeyToken(byte[] keyToken);
			private native int nativeClose();

			private Descrambler() {}

			/**
			* Add packets' PID to the descrambler for descrambling.
			*
			* The descrambler will start descrambling packets with this PID. Multiple PIDs can be added
			* into one descrambler instance because descambling can happen simultaneously on packets
			* from different PIDs.
			*
			* If the Descrambler previously contained a filter for the PID, the old filter is replaced
			* by the specified filter.
			*
			* @param pidType the type of the PID.
			* @param pid the PID of packets to start to be descrambled.
			* @param filter an optional filter instance to identify upper stream.
			* @return result status of the operation.
			*
			* @hide
			*/
			public int addPid(@DemuxPidType int pidType, int pid, @Nullable Filter filter) {
			return nativeAddPid(pidType, pid, filter);
			}

			/**
			* Remove packets' PID from the descrambler
			*
			* The descrambler will stop descrambling packets with this PID.
			*
			* @param pidType the type of the PID.
			* @param pid the PID of packets to stop to be descrambled.
			* @param filter an optional filter instance to identify upper stream.
			* @return result status of the operation.
			*
			* @hide
			*/
			public int removePid(@DemuxPidType int pidType, int pid, @Nullable Filter filter) {
			return nativeRemovePid(pidType, pid, filter);
			}

			/**
			* Set a key token to link descrambler to a key slot
			*
			* A descrambler instance can have only one key slot to link, but a key slot can hold a few
			* keys for different purposes.
			*
			* @param keyToken the token to be used to link the key slot.
			* @return result status of the operation.
			*
			* @hide
			*/
			public int setKeyToken(byte[] keyToken) {
			return nativeSetKeyToken(keyToken);
			}

			/**
			* Release the descrambler instance.
			*
			* @hide
			*/
			@Override
			public void close() {
			nativeClose();
			}

			}

media/java/android/media/tv/tuner/Dvr.java

0 → 100644

+152 −0

Original line number	Original line	Diff line number	Diff line
			/*
			* Copyright 2019 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 android.media.tv.tuner;

			import android.annotation.NonNull;
			import android.media.tv.tuner.Tuner.DvrCallback;
			import android.media.tv.tuner.Tuner.Filter;
			import android.os.ParcelFileDescriptor;

			/** @hide */
			public class Dvr {
			private long mNativeContext;
			private DvrCallback mCallback;

			private native int nativeAttachFilter(Filter filter);
			private native int nativeDetachFilter(Filter filter);
			private native int nativeConfigureDvr(DvrSettings settings);
			private native int nativeStartDvr();
			private native int nativeStopDvr();
			private native int nativeFlushDvr();
			private native int nativeClose();
			private native void nativeSetFileDescriptor(int fd);
			private native int nativeRead(int size);
			private native int nativeRead(byte[] bytes, int offset, int size);
			private native int nativeWrite(int size);
			private native int nativeWrite(byte[] bytes, int offset, int size);

			private Dvr() {}

			/**
			* Attaches a filter to DVR interface for recording.
			*
			* @param filter the filter to be attached.
			* @return result status of the operation.
			*/
			public int attachFilter(Filter filter) {
			return nativeAttachFilter(filter);
			}

			/**
			* Detaches a filter from DVR interface.
			*
			* @param filter the filter to be detached.
			* @return result status of the operation.
			*/
			public int detachFilter(Filter filter) {
			return nativeDetachFilter(filter);
			}

			/**
			* Configures the DVR.
			*
			* @param settings the settings of the DVR interface.
			* @return result status of the operation.
			*/
			public int configure(DvrSettings settings) {
			return nativeConfigureDvr(settings);
			}

			/**
			* Starts DVR.
			*
			* Starts consuming playback data or producing data for recording.
			*
			* @return result status of the operation.
			*/
			public int start() {
			return nativeStartDvr();
			}

			/**
			* Stops DVR.
			*
			* Stops consuming playback data or producing data for recording.
			*
			* @return result status of the operation.
			*/
			public int stop() {
			return nativeStopDvr();
			}

			/**
			* Flushed DVR data.
			*
			* @return result status of the operation.
			*/
			public int flush() {
			return nativeFlushDvr();
			}

			/**
			* closes the DVR instance to release resources.
			*
			* @return result status of the operation.
			*/
			public int close() {
			return nativeClose();
			}

			/**
			* Sets file descriptor to read/write data.
			*/
			public void setFileDescriptor(ParcelFileDescriptor fd) {
			nativeSetFileDescriptor(fd.getFd());
			}

			/**
			* Reads data from the file for DVR playback.
			*/
			public int read(int size) {
			return nativeRead(size);
			}

			/**
			* Reads data from the buffer for DVR playback.
			*/
			public int read(@NonNull byte[] bytes, int offset, int size) {
			if (size + offset > bytes.length) {
			throw new ArrayIndexOutOfBoundsException(
			"Array length=" + bytes.length + ", offset=" + offset + ", size=" + size);
			}
			return nativeRead(bytes, offset, size);
			}

			/**
			* Writes recording data to file.
			*/
			public int write(int size) {
			return nativeWrite(size);
			}

			/**
			* Writes recording data to buffer.
			*/
			public int write(@NonNull byte[] bytes, int offset, int size) {
			return nativeWrite(bytes, offset, size);
			}
			}

media/java/android/media/tv/tuner/Filter.java

0 → 100644

+142 −0

Original line number	Original line	Diff line number	Diff line
			/*
			* Copyright 2019 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 android.media.tv.tuner;

			import android.annotation.NonNull;
			import android.annotation.Nullable;
			import android.media.tv.tuner.Tuner.FilterCallback;
			import android.media.tv.tuner.filter.FilterConfiguration;
			import android.media.tv.tuner.filter.Settings;

			/**
			* Tuner data filter.
			*
			* <p> This class is used to filter wanted data according to the filter's configuration.
			* @hide
			*/
			public class Filter implements AutoCloseable {
			private long mNativeContext;
			private FilterCallback mCallback;
			int mId;

			private native int nativeConfigureFilter(
			int type, int subType, FilterConfiguration settings);
			private native int nativeGetId();
			private native int nativeSetDataSource(Tuner.Filter source);
			private native int nativeStartFilter();
			private native int nativeStopFilter();
			private native int nativeFlushFilter();
			private native int nativeRead(byte[] buffer, int offset, int size);
			private native int nativeClose();

			private Filter(int id) {
			mId = id;
			}

			private void onFilterStatus(int status) {
			}

			/**
			* Configures the filter.
			*
			* @param settings the settings of the filter.
			* @return result status of the operation.
			* @hide
			*/
			public int configure(FilterConfiguration settings) {
			int subType = -1;
			Settings s = settings.getSettings();
			if (s != null) {
			subType = s.getType();
			}
			return nativeConfigureFilter(settings.getType(), subType, settings);
			}

			/**
			* Gets the filter Id.
			*
			* @return the hardware resource Id for the filter.
			* @hide
			*/
			public int getId() {
			return nativeGetId();
			}

			/**
			* Sets the filter's data source.
			*
			* A filter uses demux as data source by default. If the data was packetized
			* by multiple protocols, multiple filters may need to work together to
			* extract all protocols' header. Then a filter's data source can be output
			* from another filter.
			*
			* @param source the filter instance which provides data input. Switch to
			* use demux as data source if the filter instance is NULL.
			* @return result status of the operation.
			* @hide
			*/
			public int setDataSource(@Nullable Tuner.Filter source) {
			return nativeSetDataSource(source);
			}

			/**
			* Starts the filter.
			*
			* @return result status of the operation.
			* @hide
			*/
			public int start() {
			return nativeStartFilter();
			}


			/**
			* Stops the filter.
			*
			* @return result status of the operation.
			* @hide
			*/
			public int stop() {
			return nativeStopFilter();
			}

			/**
			* Flushes the filter.
			*
			* @return result status of the operation.
			* @hide
			*/
			public int flush() {
			return nativeFlushFilter();
			}

			/** @hide */
			public int read(@NonNull byte[] buffer, int offset, int size) {
			size = Math.min(size, buffer.length - offset);
			return nativeRead(buffer, offset, size);
			}

			/**
			* Release the Filter instance.
			*
			* @hide
			*/
			@Override
			public void close() {
			nativeClose();
			}
			}

media/java/android/media/tv/tuner/TimeFilter.java

0 → 100644

+127 −0

Original line number	Original line	Diff line number	Diff line
			/*
			* Copyright 2019 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 android.media.tv.tuner;

			import android.annotation.Nullable;
			import android.media.tv.tuner.TunerConstants.Result;

			/**
			* A timer filter is used to filter data based on timestamps.
			*
			* <p> If the timestamp is set, data is discarded if its timestamp is smaller than the
			* timestamp in this time filter.
			*
			* <p> The format of the timestamps is the same as PTS defined in ISO/IEC 13818-1:2019. The
			* timestamps may or may not be related to PTS or DTS.
			*
			* @hide
			*/
			public class TimeFilter implements AutoCloseable {
			private native int nativeSetTimestamp(long timestamp);
			private native int nativeClearTimestamp();
			private native Long nativeGetTimestamp();
			private native Long nativeGetSourceTime();
			private native int nativeClose();

			private boolean mEnable = false;

			/**
			* Set timestamp for time based filter.
			*
			* It is used to set initial timestamp and enable time filtering. Once set, the time will be
			* increased automatically like a clock. Contents are discarded if their timestamps are
			* older than the time in the time filter.
			*
			* This method can be called more than once to reset the initial timestamp.
			*
			* @param timestamp initial timestamp for the time filter before it's increased. It's
			* based on the 90KHz counter, and it's the same format as PTS (Presentation Time Stamp)
			* defined in ISO/IEC 13818-1:2019. The timestamps may or may not be related to PTS or DTS.
			* @return result status of the operation.
			*/
			@Result
			public int setCurrentTimestamp(long timestamp) {
			int res = nativeSetTimestamp(timestamp);
			// TODO: use a constant for SUCCESS
			if (res == 0) {
			mEnable = true;
			}
			return res;
			}

			/**
			* Clear the timestamp in the time filter.
			*
			* It is used to clear the time value of the time filter. Time filtering is disabled then.
			*
			* @return result status of the operation.
			*/
			@Result
			public int clearTimestamp() {
			int res = nativeClearTimestamp();
			if (res == 0) {
			mEnable = false;
			}
			return res;
			}

			/**
			* Get the current time in the time filter.
			*
			* It is used to inquiry current time in the time filter.
			*
			* @return current timestamp in the time filter. It's based on the 90KHz counter, and it's
			* the same format as PTS (Presentation Time Stamp) defined in ISO/IEC 13818-1:2019. The
			* timestamps may or may not be related to PTS or DTS. {@code null} if the timestamp is
			* never set.
			*/
			@Nullable
			public Long getTimeStamp() {
			if (!mEnable) {
			return null;
			}
			return nativeGetTimestamp();
			}

			/**
			* Get the timestamp from the beginning of incoming data stream.
			*
			* It is used to inquiry the timestamp from the beginning of incoming data stream.
			*
			* @return first timestamp of incoming data stream. It's based on the 90KHz counter, and
			* it's the same format as PTS (Presentation Time Stamp) defined in ISO/IEC 13818-1:2019.
			* The timestamps may or may not be related to PTS or DTS.
			*/
			@Nullable
			public Long getSourceTime() {
			if (!mEnable) {
			return null;
			}
			return nativeGetSourceTime();
			}

			/**
			* Close the Time Filter instance
			*
			* It is to release the TimeFilter instance. Resources are reclaimed so the instance must
			* not be accessed after this method is called.
			*/
			@Override
			public void close() {
			nativeClose();
			}
			}

media/java/android/media/tv/tuner/Tuner.java

+5 −430

File changed.

Preview size limit exceeded, changes collapsed.