mirror of
https://github.com/samsonjs/media.git
synced 2026-04-05 11:15:46 +00:00
1a909fd163
- This avoids the need to have to use the timeline to calculate a window duration, which can be awkward. - Window now represents a window of availability with an isSeekable flag, rather than a window of seekability. - Promoted Timeline and Window to top package; they're pretty important :). ------------- Created by MOE: https://github.com/google/moe MOE_MIGRATED_REVID=130278509
100 lines
3.4 KiB
Java
100 lines
3.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;
|
|
|
|
import com.google.android.exoplayer2.source.MediaSource.Listener;
|
|
|
|
/**
|
|
* The player's timeline consisting of one or more periods. Instances are immutable.
|
|
*/
|
|
public interface Timeline {
|
|
|
|
/**
|
|
* Returned by {@link #getIndexOfPeriod(Object)} if no period index corresponds to the specified
|
|
* identifier.
|
|
*/
|
|
int NO_PERIOD_INDEX = -1;
|
|
|
|
/**
|
|
* Returns the number of periods in the timeline.
|
|
*/
|
|
int getPeriodCount();
|
|
|
|
/**
|
|
* Returns whether the timeline is final, which means it will not change.
|
|
*/
|
|
boolean isFinal();
|
|
|
|
/**
|
|
* Returns the absolute start time of the timeline in milliseconds.
|
|
*/
|
|
long getAbsoluteStartTime();
|
|
|
|
/**
|
|
* Returns the duration of the period at {@code index} in the timeline, in milliseconds, or
|
|
* {@link ExoPlayer#UNKNOWN_TIME} if not known.
|
|
*
|
|
* @param index The index of the period.
|
|
* @return The duration of the period in milliseconds, or {@link ExoPlayer#UNKNOWN_TIME}.
|
|
*/
|
|
long getPeriodDurationMs(int index);
|
|
|
|
/**
|
|
* Returns the duration of the period at {@code index} in the timeline, in microseconds, or
|
|
* {@link C#UNSET_TIME_US} if not known.
|
|
*
|
|
* @param index The index of the period.
|
|
* @return The duration of the period in microseconds, or {@link C#UNSET_TIME_US}.
|
|
*/
|
|
long getPeriodDurationUs(int index);
|
|
|
|
/**
|
|
* Returns a unique identifier for the period at {@code index}, or {@code null} if the period at
|
|
* {@code index} is not known. The identifier is stable across {@link Timeline} instances.
|
|
* <p>
|
|
* When the timeline changes the player uses period identifiers to determine what periods are
|
|
* unchanged. Implementations that associate an object with each period can return the object for
|
|
* the provided index to guarantee uniqueness. Other implementations must be careful to return
|
|
* identifiers that can't clash with (for example) identifiers used by other timelines that may be
|
|
* concatenated with this one.
|
|
*
|
|
* @param index A period index.
|
|
* @return An identifier for the period, or {@code null} if the period is not known.
|
|
*/
|
|
Object getPeriodId(int index);
|
|
|
|
/**
|
|
* Returns the index of the period identified by {@code id}, or {@link #NO_PERIOD_INDEX} if the
|
|
* period is not in the timeline.
|
|
*
|
|
* @param id An identifier for a period.
|
|
* @return The index of the period, or {@link #NO_PERIOD_INDEX} if the period was not found.
|
|
*/
|
|
int getIndexOfPeriod(Object id);
|
|
|
|
/**
|
|
* Returns the number of windows that can be accessed via {@link #getWindow(int)}.
|
|
*/
|
|
int getWindowCount();
|
|
|
|
/**
|
|
* Returns the {@link Window} at {@code index}, which represents positions that can be seeked
|
|
* to in the timeline. The windows may change when
|
|
* {@link Listener#onSourceInfoRefreshed(Timeline, Object)} is called.
|
|
*/
|
|
Window getWindow(int index);
|
|
|
|
}
|