diff options
Diffstat (limited to 'android/media/TimedMetaData.java')
-rw-r--r-- | android/media/TimedMetaData.java | 78 |
1 files changed, 78 insertions, 0 deletions
diff --git a/android/media/TimedMetaData.java b/android/media/TimedMetaData.java new file mode 100644 index 00000000..0ab52d73 --- /dev/null +++ b/android/media/TimedMetaData.java @@ -0,0 +1,78 @@ +/* + * Copyright 2015 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; + +import android.os.Parcel; + +/** + * Class that embodies one timed metadata access unit, including + * + * <ul> + * <li> a time stamp, and </li> + * <li> raw uninterpreted byte-array extracted directly from the container. </li> + * </ul> + * + * @see MediaPlayer#setOnTimedMetaDataAvailableListener(android.media.MediaPlayer.OnTimedMetaDataListener) + */ +public final class TimedMetaData { + private static final String TAG = "TimedMetaData"; + + private long mTimestampUs; + private byte[] mMetaData; + + /** + * @hide + */ + static TimedMetaData createTimedMetaDataFromParcel(Parcel parcel) { + return new TimedMetaData(parcel); + } + + private TimedMetaData(Parcel parcel) { + if (!parseParcel(parcel)) { + throw new IllegalArgumentException("parseParcel() fails"); + } + } + + /** + * @return the timestamp associated with this metadata access unit in microseconds; + * 0 denotes playback start. + */ + public long getTimestamp() { + return mTimestampUs; + } + + /** + * @return raw, uninterpreted content of this metadata access unit; for ID3 tags this includes + * everything starting from the 3 byte signature "ID3". + */ + public byte[] getMetaData() { + return mMetaData; + } + + private boolean parseParcel(Parcel parcel) { + parcel.setDataPosition(0); + if (parcel.dataAvail() == 0) { + return false; + } + + mTimestampUs = parcel.readLong(); + mMetaData = new byte[parcel.readInt()]; + parcel.readByteArray(mMetaData); + + return true; + } +} |