From f599155bbfcbe727a802bbb0ae30700a49bdd834 Mon Sep 17 00:00:00 2001
From: aquilescanta <aquilescanta@google.com>
Date: Wed, 13 May 2020 11:36:24 +0100
Subject: [PATCH] Document the sample data format for samples with supplemental
 data

PiperOrigin-RevId: 311298802
---
 .../android/exoplayer2/extractor/TrackOutput.java | 15 ++++++++++++++-
 1 file changed, 14 insertions(+), 1 deletion(-)

diff --git a/library/extractor/src/main/java/com/google/android/exoplayer2/extractor/TrackOutput.java b/library/extractor/src/main/java/com/google/android/exoplayer2/extractor/TrackOutput.java
index a203d164dd..b071237cf5 100644
--- a/library/extractor/src/main/java/com/google/android/exoplayer2/extractor/TrackOutput.java
+++ b/library/extractor/src/main/java/com/google/android/exoplayer2/extractor/TrackOutput.java
@@ -130,7 +130,20 @@ public interface TrackOutput {
    * </ul>
    */
   int SAMPLE_DATA_PART_ENCRYPTION = 1;
-  /** Sample supplemental data. */
+  /**
+   * Sample supplemental data.
+   *
+   * <p>If a sample contains supplemental data, the format of the entire sample data will be:
+   *
+   * <ul>
+   *   <li>If the sample has the {@link C#BUFFER_FLAG_ENCRYPTED} flag set, all encryption
+   *       information.
+   *   <li>(4 bytes) {@code sample_data_size}: The size of the actual sample data, not including
+   *       supplemental data or encryption information.
+   *   <li>({@code sample_data_size} bytes): The media sample data.
+   *   <li>(remaining bytes) The supplemental data.
+   * </ul>
+   */
   int SAMPLE_DATA_PART_SUPPLEMENTAL = 2;
 
   /**