mirror of
https://github.com/samsonjs/media.git
synced 2026-03-28 09:55:48 +00:00
0841d043b8
Dash/SS SampleSources now instantiate ChunkSource and ChunkSampleSource (renamed to ChunkTrackStream) instances on demand as tracks are enabled. The TrackGroups exposed by the DASH/SS SampleSources are now constructed at the top level. Note that this change resolves the TODOs at the top of the ChunkSource classes, allowing multiple adaptation sets of the same type. Next steps will include: - Bring back UTC timing element support for DASH, which will be an extra request during preparation in the DASH SampleSource. - Simplification of manifest fetching to use a Loader directly in the two top level SampleSource classes. ManifestFetcher should eventually go away once HLS no longer needs it. - Eventually, some consolidation between DASH/SS. There's a lot of common code there now. ------------- Created by MOE: https://github.com/google/moe MOE_MIGRATED_REVID=121001777
123 lines
4.2 KiB
Java
123 lines
4.2 KiB
Java
/*
|
|
* Copyright (C) 2014 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.exoplayer;
|
|
|
|
import java.io.IOException;
|
|
import java.util.List;
|
|
|
|
/**
|
|
* A source of media.
|
|
*/
|
|
public interface SampleSource {
|
|
|
|
/**
|
|
* Prepares the source, or does nothing if the source is already prepared.
|
|
* <p>
|
|
* {@link #selectTracks(List, List, long)} <b>must</b> be called after the source is prepared to
|
|
* make an initial track selection. This is true even if the caller does not wish to select any
|
|
* tracks.
|
|
*
|
|
* @param positionUs The player's current playback position.
|
|
* @return True if the source is prepared, false otherwise.
|
|
* @throws IOException If there's an error preparing the source.
|
|
*/
|
|
boolean prepare(long positionUs) throws IOException;
|
|
|
|
/**
|
|
* Returns the duration of the source.
|
|
* <p>
|
|
* This method should only be called after the source has been prepared.
|
|
*
|
|
* @return The duration of the source in microseconds, or {@link C#UNSET_TIME_US} if the duration
|
|
* is not known.
|
|
*/
|
|
long getDurationUs();
|
|
|
|
/**
|
|
* Returns the {@link TrackGroup}s exposed by the source.
|
|
* <p>
|
|
* This method should only be called after the source has been prepared.
|
|
*
|
|
* @return The {@link TrackGroup}s.
|
|
*/
|
|
TrackGroupArray getTrackGroups();
|
|
|
|
/**
|
|
* Modifies the selected tracks.
|
|
* <p>
|
|
* {@link TrackStream}s corresponding to tracks being unselected are passed in {@code oldStreams}.
|
|
* Tracks being selected are specified in {@code newSelections}. Each new {@link TrackSelection}
|
|
* must have a {@link TrackSelection#group} index distinct from those of currently enabled tracks,
|
|
* except for those being unselected.
|
|
* <p>
|
|
* This method should only be called after the source has been prepared.
|
|
*
|
|
* @param oldStreams {@link TrackStream}s corresponding to tracks being unselected. May be empty
|
|
* but must not be null.
|
|
* @param newSelections {@link TrackSelection}s that define tracks being selected. May be empty
|
|
* but must not be null.
|
|
* @param positionUs The current playback position in microseconds.
|
|
* @return The {@link TrackStream}s corresponding to each of the newly selected tracks.
|
|
*/
|
|
TrackStream[] selectTracks(List<TrackStream> oldStreams, List<TrackSelection> newSelections,
|
|
long positionUs);
|
|
|
|
/**
|
|
* Indicates to the source that it should continue buffering data for its enabled tracks.
|
|
* <p>
|
|
* This method should only be called when at least one track is selected.
|
|
*
|
|
* @param positionUs The current playback position.
|
|
*/
|
|
void continueBuffering(long positionUs);
|
|
|
|
/**
|
|
* Attempts to read a pending reset.
|
|
*
|
|
* @return If a reset was read then the playback position in microseconds after the reset. Else
|
|
* {@link C#UNSET_TIME_US}.
|
|
*/
|
|
long readReset();
|
|
|
|
/**
|
|
* Returns an estimate of the position up to which data is buffered for the enabled tracks.
|
|
* <p>
|
|
* This method should only be called when at least one track is selected.
|
|
*
|
|
* @return An estimate of the absolute position in microseconds up to which data is buffered, or
|
|
* {@link C#END_OF_SOURCE_US} if the track is fully buffered, or {@link C#UNSET_TIME_US} if no
|
|
* estimate is available.
|
|
*/
|
|
long getBufferedPositionUs();
|
|
|
|
/**
|
|
* Seeks to the specified position in microseconds.
|
|
* <p>
|
|
* This method should only be called when at least one track is selected.
|
|
*
|
|
* @param positionUs The seek position in microseconds.
|
|
*/
|
|
void seekToUs(long positionUs);
|
|
|
|
/**
|
|
* Releases the source.
|
|
* <p>
|
|
* This method should be called when the source is no longer required. It may be called in any
|
|
* state.
|
|
*/
|
|
void release();
|
|
|
|
}
|