From df84f2930cdb1f75d273668a96953c0aae102943 Mon Sep 17 00:00:00 2001
From: tonihei <tonihei@google.com>
Date: Thu, 29 Jun 2017 04:16:16 -0700
Subject: [PATCH] Clarify JavaDoc of MediaPeriod.

Two of MediaPeriod's methods are only called after the media period has been
prepared. Added this to JavaDoc of these method to simplify implementations.

-------------
Created by MOE: https://github.com/google/moe
MOE_MIGRATED_REVID=160510373
---
 .../com/google/android/exoplayer2/source/MediaPeriod.java     | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/library/core/src/main/java/com/google/android/exoplayer2/source/MediaPeriod.java b/library/core/src/main/java/com/google/android/exoplayer2/source/MediaPeriod.java
index 3b06542855..aaf4c89ff7 100644
--- a/library/core/src/main/java/com/google/android/exoplayer2/source/MediaPeriod.java
+++ b/library/core/src/main/java/com/google/android/exoplayer2/source/MediaPeriod.java
@@ -106,6 +106,8 @@ public interface MediaPeriod extends SequenceableLoader {
 
   /**
    * Discards buffered media up to the specified position.
+   * <p>
+   * This method should only be called after the period has been prepared.
    *
    * @param positionUs The position in microseconds.
    */
@@ -116,6 +118,8 @@ public interface MediaPeriod extends SequenceableLoader {
    * <p>
    * After this method has returned a value other than {@link C#TIME_UNSET}, all
    * {@link SampleStream}s provided by the period are guaranteed to start from a key frame.
+   * <p>
+   * This method should only be called after the period has been prepared.
    *
    * @return If a discontinuity was read then the playback position in microseconds after the
    *     discontinuity. Else {@link C#TIME_UNSET}.