Back to Repositories

Testing Fragmented MP4 Extraction Functionality in SmartTube

This test suite validates the functionality of the FragmentedMp4Extractor class in ExoPlayer’s core library. It focuses on testing various aspects of MP4 fragment extraction, including basic sample processing, seekable content handling, and SEI payload parsing for closed captions.

Test Coverage Overview

The test suite provides comprehensive coverage of FragmentedMp4Extractor functionality.

Key areas tested include:
  • Basic MP4 fragment extraction
  • Seekable MP4 content handling
  • SEI payload parsing for CEA-608 closed captions
  • Format handling and configuration options

Implementation Analysis

The testing approach utilizes JUnit4 with AndroidJUnit4 runner for Android-specific testing context. The implementation leverages ExtractorAsserts utility class for behavior verification, employing a factory pattern for extractor instantiation with configurable formats.

Test methods follow a clear pattern of testing specific MP4 sample files with different characteristics and configurations.

Technical Details

Testing tools and configuration:
  • JUnit4 test framework
  • AndroidJUnit4 test runner
  • ExtractorAsserts utility class
  • Custom MP4 sample files
  • Format configuration for CEA-608 closed captions
  • Factory method pattern for extractor creation

Best Practices Demonstrated

The test suite exemplifies several testing best practices:

  • Isolated test cases for specific functionality
  • Clear test method naming conventions
  • Proper test resource management
  • Flexible configuration through factory methods
  • Comprehensive edge case coverage
  • Reusable test utilities

yuliskov/smarttube

exoplayer-amzn-2.10.6/library/core/src/test/java/com/google/android/exoplayer2/extractor/mp4/FragmentedMp4ExtractorTest.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.extractor.mp4;

import androidx.test.ext.junit.runners.AndroidJUnit4;
import com.google.android.exoplayer2.Format;
import com.google.android.exoplayer2.testutil.ExtractorAsserts;
import com.google.android.exoplayer2.testutil.ExtractorAsserts.ExtractorFactory;
import com.google.android.exoplayer2.util.MimeTypes;
import java.util.Collections;
import java.util.List;
import org.junit.Test;
import org.junit.runner.RunWith;

/** Unit test for {@link FragmentedMp4Extractor}. */
@RunWith(AndroidJUnit4.class)
public final class FragmentedMp4ExtractorTest {

  @Test
  public void testSample() throws Exception {
    ExtractorAsserts.assertBehavior(
        getExtractorFactory(Collections.emptyList()), "mp4/sample_fragmented.mp4");
  }

  @Test
  public void testSampleSeekable() throws Exception {
    ExtractorAsserts.assertBehavior(
        getExtractorFactory(Collections.emptyList()), "mp4/sample_fragmented_seekable.mp4");
  }

  @Test
  public void testSampleWithSeiPayloadParsing() throws Exception {
    // Enabling the CEA-608 track enables SEI payload parsing.
    ExtractorFactory extractorFactory =
        getExtractorFactory(
            Collections.singletonList(
                Format.createTextSampleFormat(null, MimeTypes.APPLICATION_CEA608, 0, null)));
    ExtractorAsserts.assertBehavior(extractorFactory, "mp4/sample_fragmented_sei.mp4");
  }

  private static ExtractorFactory getExtractorFactory(final List<Format> closedCaptionFormats) {
    return () -> new FragmentedMp4Extractor(0, null, null, null, closedCaptionFormats);
  }
}