public class

Period

extends java.lang.Object

 java.lang.Object

↳androidx.media3.exoplayer.dash.manifest.Period

Gradle dependencies

compile group: 'androidx.media3', name: 'media3-exoplayer-dash', version: '1.0.0-alpha03'

  • groupId: androidx.media3
  • artifactId: media3-exoplayer-dash
  • version: 1.0.0-alpha03

Artifact androidx.media3:media3-exoplayer-dash:1.0.0-alpha03 it located at Google repository (https://maven.google.com/)

Overview

Encapsulates media content components over a contiguous period of time.

Summary

Fields
public final java.util.List<AdaptationSet>adaptationSets

The adaptation sets belonging to the period.

public final DescriptorassetIdentifier

The asset identifier for this period, if one exists

public final java.util.List<EventStream>eventStreams

The event stream belonging to the period.

public final java.lang.Stringid

The period identifier, if one exists.

public final longstartMs

The start time of the period in milliseconds, relative to the start of the manifest.

Constructors
publicPeriod(java.lang.String id, long startMs, java.util.List<AdaptationSet> adaptationSets)

publicPeriod(java.lang.String id, long startMs, java.util.List<AdaptationSet> adaptationSets, java.util.List<EventStream> eventStreams)

publicPeriod(java.lang.String id, long startMs, java.util.List<AdaptationSet> adaptationSets, java.util.List<EventStream> eventStreams, Descriptor assetIdentifier)

Methods
public intgetAdaptationSetIndex(int type)

Returns the index of the first adaptation set of a given type, or C.INDEX_UNSET if no adaptation set of the specified type exists.

from java.lang.Objectclone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Fields

public final java.lang.String id

The period identifier, if one exists.

public final long startMs

The start time of the period in milliseconds, relative to the start of the manifest.

public final java.util.List<AdaptationSet> adaptationSets

The adaptation sets belonging to the period.

public final java.util.List<EventStream> eventStreams

The event stream belonging to the period.

public final Descriptor assetIdentifier

The asset identifier for this period, if one exists

Constructors

public Period(java.lang.String id, long startMs, java.util.List<AdaptationSet> adaptationSets)

Parameters:

id: The period identifier. May be null.
startMs: The start time of the period in milliseconds.
adaptationSets: The adaptation sets belonging to the period.

public Period(java.lang.String id, long startMs, java.util.List<AdaptationSet> adaptationSets, java.util.List<EventStream> eventStreams)

Parameters:

id: The period identifier. May be null.
startMs: The start time of the period in milliseconds.
adaptationSets: The adaptation sets belonging to the period.
eventStreams: The EventStreams belonging to the period.

public Period(java.lang.String id, long startMs, java.util.List<AdaptationSet> adaptationSets, java.util.List<EventStream> eventStreams, Descriptor assetIdentifier)

Parameters:

id: The period identifier. May be null.
startMs: The start time of the period in milliseconds.
adaptationSets: The adaptation sets belonging to the period.
eventStreams: The EventStreams belonging to the period.
assetIdentifier: The asset identifier for this period

Methods

public int getAdaptationSetIndex(int type)

Returns the index of the first adaptation set of a given type, or C.INDEX_UNSET if no adaptation set of the specified type exists.

Parameters:

type: An adaptation set type.

Returns:

The index of the first adaptation set of the specified type, or C.INDEX_UNSET.

Source

/*
 * 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 androidx.media3.exoplayer.dash.manifest;

import androidx.annotation.Nullable;
import androidx.media3.common.C;
import androidx.media3.common.util.UnstableApi;
import java.util.Collections;
import java.util.List;

/** Encapsulates media content components over a contiguous period of time. */
@UnstableApi
public class Period {

  /** The period identifier, if one exists. */
  @Nullable public final String id;

  /** The start time of the period in milliseconds, relative to the start of the manifest. */
  public final long startMs;

  /** The adaptation sets belonging to the period. */
  public final List<AdaptationSet> adaptationSets;

  /** The event stream belonging to the period. */
  public final List<EventStream> eventStreams;

  /** The asset identifier for this period, if one exists */
  @Nullable public final Descriptor assetIdentifier;

  /**
   * @param id The period identifier. May be null.
   * @param startMs The start time of the period in milliseconds.
   * @param adaptationSets The adaptation sets belonging to the period.
   */
  public Period(@Nullable String id, long startMs, List<AdaptationSet> adaptationSets) {
    this(id, startMs, adaptationSets, Collections.emptyList(), /* assetIdentifier= */ null);
  }

  /**
   * @param id The period identifier. May be null.
   * @param startMs The start time of the period in milliseconds.
   * @param adaptationSets The adaptation sets belonging to the period.
   * @param eventStreams The {@link EventStream}s belonging to the period.
   */
  public Period(
      @Nullable String id,
      long startMs,
      List<AdaptationSet> adaptationSets,
      List<EventStream> eventStreams) {
    this(id, startMs, adaptationSets, eventStreams, /* assetIdentifier= */ null);
  }

  /**
   * @param id The period identifier. May be null.
   * @param startMs The start time of the period in milliseconds.
   * @param adaptationSets The adaptation sets belonging to the period.
   * @param eventStreams The {@link EventStream}s belonging to the period.
   * @param assetIdentifier The asset identifier for this period
   */
  public Period(
      @Nullable String id,
      long startMs,
      List<AdaptationSet> adaptationSets,
      List<EventStream> eventStreams,
      @Nullable Descriptor assetIdentifier) {
    this.id = id;
    this.startMs = startMs;
    this.adaptationSets = Collections.unmodifiableList(adaptationSets);
    this.eventStreams = Collections.unmodifiableList(eventStreams);
    this.assetIdentifier = assetIdentifier;
  }

  /**
   * Returns the index of the first adaptation set of a given type, or {@link C#INDEX_UNSET} if no
   * adaptation set of the specified type exists.
   *
   * @param type An adaptation set type.
   * @return The index of the first adaptation set of the specified type, or {@link C#INDEX_UNSET}.
   */
  public int getAdaptationSetIndex(int type) {
    int adaptationCount = adaptationSets.size();
    for (int i = 0; i < adaptationCount; i++) {
      if (adaptationSets.get(i).type == type) {
        return i;
      }
    }
    return C.INDEX_UNSET;
  }
}