এইচএলএস

এক্সোপ্লেয়ার একাধিক কন্টেইনার ফরম্যাট সহ এইচএলএস সমর্থন করে। এর অন্তর্ভুক্ত অডিও এবং ভিডিও স্যাম্পল ফরম্যাটগুলোও সমর্থিত হতে হবে (বিস্তারিত জানার জন্য স্যাম্পল ফরম্যাট বিভাগটি দেখুন)। আমরা এইচএলএস কন্টেন্ট নির্মাতাদের এই ব্লগ পোস্টে বর্ণিত পদ্ধতি অনুযায়ী উচ্চ মানের এইচএলএস স্ট্রিম তৈরি করতে দৃঢ়ভাবে উৎসাহিত করি।

বৈশিষ্ট্য	সমর্থিত	মন্তব্য
কন্টেইনার
এমপিইজি-টিএস	হ্যাঁ
এফএমপি৪/সিএমএএফ	হ্যাঁ
ADTS (AAC)	হ্যাঁ
এমপি৩	হ্যাঁ
ক্লোজড ক্যাপশন / সাবটাইটেল
সিইএ-৬০৮	হ্যাঁ
সিইএ-৭০৮	হ্যাঁ
ওয়েবভিটিটি	হ্যাঁ
মেটাডেটা
আইডি৩	হ্যাঁ
SCTE-35	না
বিষয়বস্তু সুরক্ষা
AES-128	হ্যাঁ
নমুনা AES-128	না
ওয়াইডভাইন	হ্যাঁ	এপিআই ১৯+ ("cenc" স্কিম) এবং ২৫+ ("cbcs" স্কিম)
প্লে রেডি এসএল২০০০	হ্যাঁ	শুধুমাত্র অ্যান্ড্রয়েড টিভি
সার্ভার নিয়ন্ত্রণ
ডেল্টা আপডেট	হ্যাঁ
প্লেলিস্ট পুনরায় লোড করা ব্লক করা হচ্ছে	হ্যাঁ
প্রিলোড ইঙ্গিতের ব্লকিং লোড	হ্যাঁ	অনির্ধারিত দৈর্ঘ্যের বাইটরেঞ্জ ব্যতীত
বিজ্ঞাপন সন্নিবেশ
সার্ভার-নির্দেশিত বিজ্ঞাপন সন্নিবেশ (ইন্টারস্টিশিয়াল)	আংশিকভাবে	শুধুমাত্র X-ASSET-URI সহ VOD উপলব্ধ। লাইভ স্ট্রিম এবং X-ASSET-LIST পরবর্তীতে যোগ করা হবে।
আইএমএ সার্ভার-সাইড এবং ক্লায়েন্ট-সাইড বিজ্ঞাপন	হ্যাঁ	বিজ্ঞাপন সন্নিবেশ নির্দেশিকা
লাইভ প্লেব্যাক
নিয়মিত লাইভ প্লেব্যাক	হ্যাঁ
লো-ল্যাটেন্সি এইচএলএস (অ্যাপল)	হ্যাঁ
কম-বিলম্বিত HLS (কমিউনিটি)	না
কমন মিডিয়া ক্লায়েন্ট ডেটা সিএমসিডি	হ্যাঁ	সিএমসিডি একীকরণ নির্দেশিকা

মিডিয়াআইটেম ব্যবহার করে

একটি HLS স্ট্রিম চালাতে হলে, আপনাকে HLS মডিউলটির উপর নির্ভর করতে হবে।

কোটলিন

implementation("androidx.media3:media3-exoplayer-hls:1.10.0")

গ্রুভি

implementation "androidx.media3:media3-exoplayer-hls:1.10.0"

এরপর আপনি একটি HLS প্লেলিস্ট URI-এর জন্য একটি MediaItem তৈরি করে সেটি প্লেয়ারে পাঠাতে পারবেন।

কোটলিন

// Create a player instance.
val player = ExoPlayer.Builder(context).build()
// Set the media item to be played.
player.setMediaItem(MediaItem.fromUri(hlsUri))
// Prepare the player.
player.prepare()
Hls.kt

জাভা

// Create a player instance.
ExoPlayer player = new ExoPlayer.Builder(context).build();
// Set the media item to be played.
player.setMediaItem(MediaItem.fromUri(hlsUri));
// Prepare the player.
player.prepare();
Hls.java

যদি আপনার URI-এর শেষে .m3u8 না থাকে, তাহলে কন্টেন্টের ধরণ স্পষ্টভাবে নির্দেশ করার জন্য আপনি MediaItem.Builder এর setMimeType এ MimeTypes.APPLICATION_M3U8 পাস করতে পারেন।

মিডিয়া আইটেমের URI একটি মিডিয়া প্লেলিস্ট বা একটি মাল্টিভেরিয়েন্ট প্লেলিস্টকে নির্দেশ করতে পারে। যদি URI-টি এমন একটি মাল্টিভেরিয়েন্ট প্লেলিস্টকে নির্দেশ করে যেখানে একাধিক #EXT-X-STREAM-INF ট্যাগ ঘোষণা করা আছে, তাহলে ExoPlayer উপলব্ধ ব্যান্ডউইথ এবং ডিভাইসের সক্ষমতা উভয়ই বিবেচনা করে স্বয়ংক্রিয়ভাবে ভেরিয়েন্টগুলোর মধ্যে নিজেকে মানিয়ে নেবে।

HlsMediaSource ব্যবহার করে

আরও কাস্টমাইজেশন বিকল্পের জন্য, আপনি একটি MediaItem এর পরিবর্তে একটি HlsMediaSource তৈরি করে সরাসরি প্লেয়ারে পাঠাতে পারেন।

কোটলিন

// Create a data source factory.
val dataSourceFactory: DataSource.Factory = DefaultHttpDataSource.Factory()
// Create a HLS media source pointing to a playlist uri.
val hlsMediaSource =
  HlsMediaSource.Factory(dataSourceFactory).createMediaSource(MediaItem.fromUri(hlsUri))
// Create a player instance.
val player = ExoPlayer.Builder(context).build()
// Set the HLS media source as the playlist with a single media item.
player.setMediaSource(hlsMediaSource)
// Prepare the player.
player.prepare()
Hls.kt

জাভা

// Create a data source factory.
DataSource.Factory dataSourceFactory = new DefaultHttpDataSource.Factory();
// Create a HLS media source pointing to a playlist uri.
HlsMediaSource hlsMediaSource =
    new HlsMediaSource.Factory(dataSourceFactory).createMediaSource(MediaItem.fromUri(hlsUri));
// Create a player instance.
ExoPlayer player = new ExoPlayer.Builder(context).build();
// Set the HLS media source as the playlist with a single media item.
player.setMediaSource(hlsMediaSource);
// Prepare the player.
player.prepare();
Hls.java

ম্যানিফেস্ট অ্যাক্সেস করা

আপনি Player.getCurrentManifest কল করে বর্তমান ম্যানিফেস্টটি পেতে পারেন। HLS-এর জন্য, রিটার্ন করা অবজেক্টটিকে HlsManifest এ কাস্ট করতে হবে। যখনই ম্যানিফেস্ট লোড হয়, Player.Listener এর onTimelineChanged কলব্যাকটিও কল করা হয়। অন-ডিমান্ড কন্টেন্টের জন্য এটি একবার এবং লাইভ কন্টেন্টের জন্য সম্ভবত অনেকবার ঘটবে। নিচের কোড স্নিপেটটি দেখায় যে, ম্যানিফেস্ট লোড হলে একটি অ্যাপ কীভাবে কোনো কাজ করতে পারে।

কোটলিন

player.addListener(
  object : Player.Listener {
    override fun onTimelineChanged(
      timeline: Timeline,
      @Player.TimelineChangeReason reason: Int,
    ) {
      val manifest = player.currentManifest
      if (manifest is HlsManifest) {
        // Do something with the manifest.
      }
    }
  }
)
Hls.kt

জাভা

player.addListener(
    new Player.Listener() {
      @Override
      public void onTimelineChanged(
          Timeline timeline, @Player.TimelineChangeReason int reason) {
        Object manifest = player.getCurrentManifest();
        if (manifest != null) {
          HlsManifest hlsManifest = (HlsManifest) manifest;
          // Do something with the manifest.
        }
      }
    });
Hls.java

ইন্টারস্টিশিয়াল সহ HLS স্ট্রিম চালান।

HLS স্পেসিফিকেশন HLS ইন্টারস্টিশিয়াল সংজ্ঞায়িত করে, যা একটি মিডিয়া প্লেলিস্টে মধ্যবর্তী তথ্য অন্তর্ভুক্ত করতে ব্যবহার করা যেতে পারে। ExoPlayer ডিফল্টরূপে এই ইন্টারস্টিশিয়ালগুলিকে উপেক্ষা করে। HlsInterstitialsAdsLoader ব্যবহার করে এর জন্য সাপোর্ট যোগ করা যেতে পারে। আমরা শুরু থেকেই স্পেসিফিকেশনের সমস্ত ফিচার সাপোর্ট করি না। যদি আপনার স্ট্রিমে সাপোর্টের অভাব বোধ করেন, তবে GitHub-এ একটি ইস্যু ফাইল করে আমাদের জানান এবং আপনার স্ট্রিম URI পাঠান, যাতে আমরা আপনার স্ট্রিমে সাপোর্ট যোগ করতে পারি।

প্লেলিস্ট এপিআই-এর সাথে একটি MediaItem ব্যবহার করুন

ইন্টারস্টিশিয়াল সহ HLS স্ট্রিম চালানোর সবচেয়ে সুবিধাজনক উপায় হলো HlsInterstitialsAdsLoader.AdsMediaSourceFactory ব্যবহার করে একটি ExoPlayer ইনস্ট্যান্স তৈরি করা। এর ফলে Player ইন্টারফেসের MediaItem ভিত্তিক প্লেলিস্ট API ব্যবহার করে HLS ইন্টারস্টিশিয়াল চালানো যায়।

প্লেয়ার ইনস্ট্যান্স তৈরি করার সময় ExoPlayer এর MediaSource.Factory কে বিল্ডারের মধ্যে ইনজেক্ট করা যেতে পারে:

কোটলিন

val hlsInterstitialsAdsLoader = HlsInterstitialsAdsLoader(context)
// Create a MediaSource.Factory for HLS streams with interstitials.
val hlsMediaSourceFactory =
  HlsInterstitialsAdsLoader.AdsMediaSourceFactory(
    hlsInterstitialsAdsLoader,
    playerView,
    DefaultMediaSourceFactory(context),
  )

// Build player with interstitials media source factory
val player = ExoPlayer.Builder(context).setMediaSourceFactory(hlsMediaSourceFactory).build()

// Set the player on the ads loader.
hlsInterstitialsAdsLoader.setPlayer(player)
playerView.setPlayer(player)
Hls.kt

জাভা

HlsInterstitialsAdsLoader hlsInterstitialsAdsLoader = new HlsInterstitialsAdsLoader(context);
// Create a MediaSource.Factory for HLS streams with interstitials.
MediaSource.Factory hlsMediaSourceFactory =
    new HlsInterstitialsAdsLoader.AdsMediaSourceFactory(
        hlsInterstitialsAdsLoader, playerView, new DefaultMediaSourceFactory(context));

// Build player with interstitials media source factory
ExoPlayer player =
    new ExoPlayer.Builder(context).setMediaSourceFactory(hlsMediaSourceFactory).build();

// Set the player on the ads loader.
hlsInterstitialsAdsLoader.setPlayer(player);
playerView.setPlayer(player);
Hls.java

এই ধরনের প্লেয়ার সেটআপের মাধ্যমে, HLS ইন্টারস্টিশিয়াল চালানোর জন্য প্লেয়ারটিতে AdsConfiguration সহ একটি মিডিয়া আইটেম সেট করতে হয়:

কোটলিন

// Build an HLS media item with ads configuration to be played.
player.setMediaItem(
  MediaItem.Builder()
    .setUri("https://www.example.com/media.m3u8")
    .setAdsConfiguration(
      MediaItem.AdsConfiguration.Builder("hls://interstitials".toUri())
        .setAdsId("ad-tag-0") // must be unique within playlist
        .build()
    )
    .build()
)

player.prepare()
player.play()
Hls.kt

জাভা

// Build an HLS media item with ads configuration to be played.
player.setMediaItem(
    new MediaItem.Builder()
        .setUri("https://www.example.com/media.m3u8")
        .setAdsConfiguration(
            new AdsConfiguration.Builder(Uri.parse("hls://interstitials"))
                .setAdsId("ad-tag-0") // must be unique within playlist
                .build())
        .build());
player.prepare();
player.play();
Hls.java

দ্রষ্টব্য: HlsInterstitialsAdsLoader.AdsMediaSourceFactory যেকোনো HLS স্ট্রিমের জন্য ব্যবহার করা যেতে পারে। যদি ads কনফিগারেশনটি বাদ দেওয়া হয়, তাহলে সোর্সটি এমনভাবে প্লে করা হয় যেন এটি সরাসরি HlsMediaSource.Factory দিয়ে তৈরি করা হয়েছে।

মিডিয়া সোর্স ভিত্তিক এপিআই ব্যবহার করুন

বিকল্পভাবে, ডিফল্ট মিডিয়া সোর্স ফ্যাক্টরি ওভাররাইড না করেও ExoPlayer ইনস্ট্যান্সটি তৈরি করা যেতে পারে। ইন্টারস্টিশিয়াল সমর্থন করার জন্য, একটি অ্যাপ তখন সরাসরি HlsInterstitialsAdsLoader.AdsMediaSourceFactory ব্যবহার করে একটি MediaSource তৈরি করতে পারে এবং মিডিয়া সোর্স ভিত্তিক প্লেলিস্ট API ব্যবহার করে সেটি ExoPlayer-কে সরবরাহ করতে পারে:

কোটলিন

val hlsInterstitialsAdsLoader = HlsInterstitialsAdsLoader(context)
// Create a MediaSource.Factory for HLS streams with interstitials.
val hlsMediaSourceFactory =
  HlsInterstitialsAdsLoader.AdsMediaSourceFactory(
    hlsInterstitialsAdsLoader,
    playerView,
    context,
  )

// Build player with default media source factory.
val player = ExoPlayer.Builder(context).build()

// Create an media source from an HLS media item with ads configuration.
val mediaSource =
  hlsMediaSourceFactory.createMediaSource(
    MediaItem.Builder()
      .setUri("https://www.example.com/media.m3u8")
      .setAdsConfiguration(
        MediaItem.AdsConfiguration.Builder("hls://interstitials".toUri())
          .setAdsId("ad-tag-0")
          .build()
      )
      .build()
  )

// Set the media source on the player.
player.setMediaSource(mediaSource)
player.prepare()
player.play()
Hls.kt

জাভা

HlsInterstitialsAdsLoader hlsInterstitialsAdsLoader = new HlsInterstitialsAdsLoader(context);
// Create a MediaSource.Factory for HLS streams with interstitials.
MediaSource.Factory hlsMediaSourceFactory =
    new HlsInterstitialsAdsLoader.AdsMediaSourceFactory(
        hlsInterstitialsAdsLoader, playerView, context);

// Build player with default media source factory.
ExoPlayer player = new ExoPlayer.Builder(context).build();

// Create an media source from an HLS media item with ads configuration.
MediaSource mediaSource =
    hlsMediaSourceFactory.createMediaSource(
        new MediaItem.Builder()
            .setUri("https://www.example.com/media.m3u8")
            .setAdsConfiguration(
                new MediaItem.AdsConfiguration.Builder(Uri.parse("hls://interstitials"))
                    .setAdsId("ad-tag-0")
                    .build())
            .build());

// Set the media source on the player.
player.setMediaSource(mediaSource);
player.prepare();
player.play();
Hls.java

বিজ্ঞাপনের ঘটনাগুলো শুনুন

HLS ইন্টারস্টিশিয়াল প্লেব্যাকের স্ট্যাটাস পরিবর্তন সংক্রান্ত ইভেন্টগুলো মনিটর করার জন্য HlsInterstitialsAdsLoader এ একটি Listener যোগ করা যেতে পারে। এর মাধ্যমে একটি অ্যাপ বা SDK প্লে হওয়া বিজ্ঞাপন, লোড হতে থাকা অ্যাসেট লিস্ট, প্রস্তুত হতে থাকা অ্যাড মিডিয়া সোর্স ট্র্যাক করতে পারে অথবা অ্যাসেট লিস্ট লোড এবং বিজ্ঞাপন প্রস্তুতির ত্রুটি শনাক্ত করতে পারে। এছাড়াও, অ্যাড প্লেব্যাকের সূক্ষ্ম যাচাইকরণের জন্য বা এর অগ্রগতি ট্র্যাক করার জন্য অ্যাড মিডিয়া সোর্স থেকে নির্গত মেটাডেটা গ্রহণ করা যেতে পারে।

দ্রষ্টব্য: (বিজ্ঞাপন) প্লেব্যাক আরও বিস্তারিতভাবে ট্র্যাক করার জন্য একটি প্রচলিত Player.Listener ব্যবহার করা যেতে পারে ( প্লেয়ার ইভেন্ট শোনা দেখুন)।

কোটলিন

class AdsLoaderListener : HlsInterstitialsAdsLoader.Listener {

  override fun onStart(mediaItem: MediaItem, adsId: Any, adViewProvider: AdViewProvider) {
    // Do something when HLS media item with interstitials is started.
  }

  override fun onMetadata(
    mediaItem: MediaItem,
    adsId: Any,
    adGroupIndex: Int,
    adIndexInAdGroup: Int,
    metadata: Metadata,
  ) {
    // Do something with metadata that is emitted by the ad media source of the given ad.
  }

  override fun onAdCompleted(
    mediaItem: MediaItem,
    adsId: Any,
    adGroupIndex: Int,
    adIndexInAdGroup: Int,
  ) {
    // Do something when ad completed playback.
  }

  // ... See JavaDoc for further callbacks of HlsInterstitialsAdsLoader.Listener.

  override fun onStop(mediaItem: MediaItem, adsId: Any, adPlaybackState: AdPlaybackState) {
    // Do something with the resulting ad playback state when stopped.
  }
}
Hls.kt

জাভা

@OptIn(markerClass = UnstableApi.class)
private static class AdsLoaderListener implements HlsInterstitialsAdsLoader.Listener {

  // implement HlsInterstitialsAdsLoader.Listener
  @Override
  public void onStart(MediaItem mediaItem, Object adsId, AdViewProvider adViewProvider) {
    // Do something when HLS media item with interstitials is started.
  }

  @Override
  public void onMetadata(
      MediaItem mediaItem,
      Object adsId,
      int adGroupIndex,
      int adIndexInAdGroup,
      Metadata metadata) {
    // Do something with metadata that is emitted by the ad media source of the given ad.
  }

  @Override
  public void onAdCompleted(
      MediaItem mediaItem, Object adsId, int adGroupIndex, int adIndexInAdGroup) {
    // Do something when ad completed playback.
  }

  // ... See JavaDoc for further callbacks

  @Override
  public void onStop(MediaItem mediaItem, Object adsId, AdPlaybackState adPlaybackState) {
    // Do something with the resulting ad playback state when stopped.
  }
}
Hls.java

উপলব্ধ সকল কলব্যাকের বিস্তারিত ডকুমেন্টেশনের জন্য HlsInterstitialsAdsLoader.Listener এর JavaDoc দেখুন।

এরপর লিসেনারটিকে অ্যাডস লোডারে যোগ করা যেতে পারে:

কোটলিন

val listener = AdsLoaderListener()
// Add the listener to the ads loader to receive ad loader events.
hlsInterstitialsAdsLoader.addListener(listener)
Hls.kt

জাভা

AdsLoaderListener listener = new AdsLoaderListener();
// Add the listener to the ads loader to receive ad loader events.
hlsInterstitialsAdsLoader.addListener(listener);
Hls.java

HlsInterstitialsAdsLoader জীবনচক্র

HlsInterstitialsAdsLoader অথবা HlsInterstitialsAdsLoader.AdsMediaSourceFactory এর একটি ইনস্ট্যান্স একাধিক প্লেয়ার ইনস্ট্যান্সের জন্য পুনরায় ব্যবহার করা যেতে পারে, যেগুলো একাধিক মিডিয়া সোর্স তৈরি করে এবং যেগুলোর জন্য বিজ্ঞাপন লোড করতে হয়।

উদাহরণস্বরূপ, একটি Activity onCreate মেথডে একটি ইনস্ট্যান্স তৈরি করা যেতে পারে এবং তারপর একাধিক প্লেয়ার ইনস্ট্যান্সের জন্য এটি পুনরায় ব্যবহার করা যেতে পারে। এটি ততক্ষণ পর্যন্ত কাজ করে যতক্ষণ এটি একই সময়ে একটিমাত্র প্লেয়ার ইনস্ট্যান্স দ্বারা ব্যবহৃত হয়। এটি সেই সাধারণ ক্ষেত্রে উপযোগী যখন অ্যাপটিকে ব্যাকগ্রাউন্ডে নিয়ে যাওয়া হয়, প্লেয়ার ইনস্ট্যান্সটি ধ্বংস হয়ে যায় এবং তারপর অ্যাপটি আবার ফোরগ্রাউন্ডে এলে একটি নতুন ইনস্ট্যান্স তৈরি হয়।

বিজ্ঞাপন প্লেব্যাক অবস্থায় প্লেব্যাক পুনরায় শুরু করা

ব্যবহারকারীদের যাতে বিজ্ঞাপন পুনরায় দেখতে না হয়, সেজন্য প্লেয়ারটি পুনরায় তৈরি করার সময় বিজ্ঞাপন প্লেব্যাকের অবস্থা সংরক্ষণ এবং পুনরুদ্ধার করা যেতে পারে। এটি করার জন্য, প্লেয়ারটি রিলিজ হওয়ার ঠিক আগে getAdsResumptionStates() কল করে ফেরত আসা AdsResumptionState অবজেক্টগুলো সংরক্ষণ করা হয়। প্লেয়ারটি পুনরায় তৈরি হলে, অ্যাডস লোডার ইনস্ট্যান্সে addAdResumptionState() কল করে অবস্থাটি পুনরুদ্ধার করা যায়। AdsResumptionState বান্ডলযোগ্য, তাই এটি একটি Activity র onSaveInstanceState বান্ডলে সংরক্ষণ করা যেতে পারে। উল্লেখ্য যে, বিজ্ঞাপন পুনরায় চালু করার সুবিধাটি শুধুমাত্র VOD স্ট্রিমের জন্য সমর্থিত।

কোটলিন

class HlsInterstitialsActivity : Activity() {

  companion object {
    const val ADS_RESUMPTION_STATE_KEY = "ads_resumption_state"
  }

  private var hlsInterstitialsAdsLoader: HlsInterstitialsAdsLoader? = null
  private var playerView: PlayerView? = null
  private var player: ExoPlayer? = null
  private var adsResumptionStates: List<HlsInterstitialsAdsLoader.AdsResumptionState>? = null

  override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    // Create the ads loader instance.
    hlsInterstitialsAdsLoader = HlsInterstitialsAdsLoader(this)
    // Restore ad resumption states.
    savedInstanceState?.getParcelableArrayList<Bundle>(ADS_RESUMPTION_STATE_KEY)?.let { bundles ->
      adsResumptionStates =
        bundles.map { HlsInterstitialsAdsLoader.AdsResumptionState.fromBundle(it) }
    }
  }

  override fun onStart() {
    super.onStart()
    // Build a player and set it on the ads loader.
    initializePlayer()
    hlsInterstitialsAdsLoader?.setPlayer(player)
    // Add any stored ad resumption states to the ads loader.
    adsResumptionStates?.forEach { hlsInterstitialsAdsLoader?.addAdResumptionState(it) }
    adsResumptionStates = null // Consume the states
  }

  override fun onStop() {
    super.onStop()
    // Get ad resumption states.
    adsResumptionStates = hlsInterstitialsAdsLoader?.adsResumptionStates
    releasePlayer()
  }

  override fun onDestroy() {
    // Release the ads loader when not used anymore.
    hlsInterstitialsAdsLoader?.release()
    hlsInterstitialsAdsLoader = null
    super.onDestroy()
  }

  override fun onSaveInstanceState(outState: Bundle) {
    super.onSaveInstanceState(outState)
    // Store the ad resumption states.
    adsResumptionStates?.let {
      outState.putParcelableArrayList(
        ADS_RESUMPTION_STATE_KEY,
        ArrayList(it.map(HlsInterstitialsAdsLoader.AdsResumptionState::toBundle)),
      )
    }
  }

  fun initializePlayer() {
    if (player == null) {
      // Create a media source factory for HLS streams.
      val hlsMediaSourceFactory =
        HlsInterstitialsAdsLoader.AdsMediaSourceFactory(
          checkNotNull(hlsInterstitialsAdsLoader),
          playerView!!,
          /* context= */ this,
        )
      // Build player with interstitials media source
      player =
        ExoPlayer.Builder(/* context= */ this)
          .setMediaSourceFactory(hlsMediaSourceFactory)
          .build()
      // Set the player on the ads loader.
      hlsInterstitialsAdsLoader?.setPlayer(player)
      playerView?.player = player
    }

    // Use a media item with an HLS stream URI, an ad tag URI and ads ID.
    player?.setMediaItem(
      MediaItem.Builder()
        .setUri("https://www.example.com/media.m3u8")
        .setMimeType(MimeTypes.APPLICATION_M3U8)
        .setAdsConfiguration(
          MediaItem.AdsConfiguration.Builder("hls://interstitials".toUri())
            .setAdsId("ad-tag-0") // must be unique within ExoPlayer playlist
            .build()
        )
        .build()
    )
    player?.prepare()
    player?.play()
  }

  fun releasePlayer() {
    player?.release()
    player = null
    hlsInterstitialsAdsLoader?.setPlayer(null)
    playerView?.player = null
  }
}
Hls.kt

জাভা

@OptIn(markerClass = UnstableApi.class)
public static class HlsInterstitialsActivity extends Activity {

  public static final String ADS_RESUMPTION_STATE_KEY = "ads_resumption_state";

  @Nullable private HlsInterstitialsAdsLoader hlsInterstitialsAdsLoader;
  @Nullable private PlayerView playerView;
  @Nullable private ExoPlayer player;

  private List<HlsInterstitialsAdsLoader.AdsResumptionState> adsResumptionStates;

  @Override
  protected void onCreate(@Nullable Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    // Create the ads loader instance.
    hlsInterstitialsAdsLoader = new HlsInterstitialsAdsLoader(this);
    // Restore ad resumption states.
    if (savedInstanceState != null) {
      ArrayList<Bundle> bundles =
          savedInstanceState.getParcelableArrayList(ADS_RESUMPTION_STATE_KEY);
      if (bundles != null) {
        adsResumptionStates = new ArrayList<>();
        for (Bundle bundle : bundles) {
          adsResumptionStates.add(
              HlsInterstitialsAdsLoader.AdsResumptionState.fromBundle(bundle));
        }
      }
    }
  }

  @Override
  protected void onStart() {
    super.onStart();
    // Build a player and set it on the ads loader.
    initializePlayer();
    // Add any stored ad resumption states to the ads loader.
    if (adsResumptionStates != null) {
      for (HlsInterstitialsAdsLoader.AdsResumptionState state : adsResumptionStates) {
        hlsInterstitialsAdsLoader.addAdResumptionState(state);
      }
      adsResumptionStates = null; // Consume the states
    }
  }

  @Override
  protected void onStop() {
    super.onStop();
    // Get ad resumption states before releasing the player.
    if (hlsInterstitialsAdsLoader != null) {
      adsResumptionStates = hlsInterstitialsAdsLoader.getAdsResumptionStates();
    }
    releasePlayer();
  }

  @Override
  protected void onDestroy() {
    // Release the ads loader when not used anymore.
    if (hlsInterstitialsAdsLoader != null) {
      hlsInterstitialsAdsLoader.release();
      hlsInterstitialsAdsLoader = null;
    }
    super.onDestroy();
  }

  @Override
  protected void onSaveInstanceState(Bundle outState) {
    super.onSaveInstanceState(outState);
    // Store the ad resumption states.
    if (adsResumptionStates != null) {
      ArrayList<Bundle> bundles = new ArrayList<>();
      for (HlsInterstitialsAdsLoader.AdsResumptionState state : adsResumptionStates) {
        bundles.add(state.toBundle());
      }
      outState.putParcelableArrayList(ADS_RESUMPTION_STATE_KEY, bundles);
    }
  }

  private void initializePlayer() {
    if (player == null) {
      // Create a media source factory for HLS streams.
      MediaSource.Factory hlsMediaSourceFactory =
          new HlsInterstitialsAdsLoader.AdsMediaSourceFactory(
              checkNotNull(hlsInterstitialsAdsLoader), playerView, /* context= */ this);
      // Build player with interstitials media source
      player =
          new ExoPlayer.Builder(/* context= */ this)
              .setMediaSourceFactory(hlsMediaSourceFactory)
              .build();
      // Set the player on the ads loader.
      hlsInterstitialsAdsLoader.setPlayer(player);
      playerView.setPlayer(player);
    }

    // Use a media item with an HLS stream URI, an ad tag URI and ads ID.
    player.setMediaItem(
        new MediaItem.Builder()
            .setUri("https://www.example.com/media.m3u8")
            .setMimeType(MimeTypes.APPLICATION_M3U8)
            .setAdsConfiguration(
                new MediaItem.AdsConfiguration.Builder(Uri.parse("hls://interstitials"))
                    .setAdsId("ad-tag-0") // must be unique within ExoPlayer playlist
                    .build())
            .build());
    player.prepare();
    player.play();
  }

  private void releasePlayer() {
    if (player != null) {
      player.release();
      player = null;
    }
    if (hlsInterstitialsAdsLoader != null) {
      hlsInterstitialsAdsLoader.setPlayer(null);
    }
    if (playerView != null) {
      playerView.setPlayer(null);
    }
  }
}
Hls.java

প্লেব্যাক কাস্টমাইজ করা

ExoPlayer আপনার অ্যাপের প্রয়োজন অনুযায়ী প্লেব্যাক অভিজ্ঞতা সাজিয়ে নেওয়ার জন্য একাধিক উপায় প্রদান করে। উদাহরণের জন্য কাস্টমাইজেশন পৃষ্ঠাটি দেখুন।

খণ্ডবিহীন প্রস্তুতি নিষ্ক্রিয় করা

ডিফল্টরূপে, ExoPlayer চাঙ্কলেস প্রিপারেশন ব্যবহার করে। এর মানে হলো, স্ট্রিম প্রস্তুত করার জন্য ExoPlayer শুধুমাত্র মাল্টিভেরিয়েন্ট প্লেলিস্টের তথ্য ব্যবহার করবে, যা তখনই কাজ করে যখন #EXT-X-STREAM-INF ট্যাগগুলিতে CODECS অ্যাট্রিবিউটটি থাকে।

আপনার মিডিয়া সেগমেন্টে যদি এমন মাক্সড ক্লোজড-ক্যাপশন ট্র্যাক থাকে যা #EXT-X-MEDIA:TYPE=CLOSED-CAPTIONS ট্যাগ দিয়ে মাল্টিভেরিয়েন্ট প্লেলিস্টে ডিক্লেয়ার করা নেই, তাহলে আপনাকে এই ফিচারটি ডিজেবল করতে হতে পারে। অন্যথায়, এই ক্লোজড-ক্যাপশন ট্র্যাকগুলি ডিটেক্ট এবং প্লে করা হবে না। আপনি নিচের কোড স্নিপেটে দেখানো পদ্ধতি অনুযায়ী HlsMediaSource.Factory তে চাঙ্কলেস প্রিপারেশন ডিজেবল করতে পারেন। মনে রাখবেন, এর ফলে স্টার্ট-আপ টাইম বেড়ে যাবে, কারণ এই অতিরিক্ত ট্র্যাকগুলি খুঁজে বের করার জন্য ExoPlayer-কে একটি মিডিয়া সেগমেন্ট ডাউনলোড করতে হবে। তাই এর পরিবর্তে মাল্টিভেরিয়েন্ট প্লেলিস্টে ক্লোজড-ক্যাপশন ট্র্যাকগুলি ডিক্লেয়ার করাই শ্রেয়।

কোটলিন

val hlsMediaSource =
  HlsMediaSource.Factory(dataSourceFactory)
    .setAllowChunklessPreparation(false)
    .createMediaSource(MediaItem.fromUri(hlsUri))
Hls.kt

জাভা

HlsMediaSource hlsMediaSource =
    new HlsMediaSource.Factory(dataSourceFactory)
        .setAllowChunklessPreparation(false)
        .createMediaSource(MediaItem.fromUri(hlsUri));
Hls.java

উচ্চ মানের HLS কন্টেন্ট তৈরি করা

ExoPlayer থেকে সেরা ফলাফল পেতে, আপনার HLS কন্টেন্ট উন্নত করার জন্য কিছু নির্দিষ্ট নির্দেশিকা রয়েছে যা আপনি অনুসরণ করতে পারেন। সম্পূর্ণ ব্যাখ্যার জন্য ExoPlayer-এ HLS প্লেব্যাক সম্পর্কে আমাদের Medium পোস্টটি পড়ুন। মূল বিষয়গুলো হলো:

• সেগমেন্টের সুনির্দিষ্ট সময়কাল ব্যবহার করুন।
• একটি নিরবচ্ছিন্ন মিডিয়া প্রবাহ ব্যবহার করুন; বিভিন্ন অংশের মধ্যে মিডিয়ার কাঠামোতে পরিবর্তন পরিহার করুন।
• #EXT-X-INDEPENDENT-SEGMENTS ট্যাগটি ব্যবহার করুন।
• যেসব ফাইলে ভিডিও এবং অডিও উভয়ই থাকে, সেগুলোর পরিবর্তে ডিমাক্সড স্ট্রিম ব্যবহার করা শ্রেয়।
• মাল্টিভেরিয়েন্ট প্লেলিস্টে আপনার পক্ষে সম্ভব সকল তথ্য অন্তর্ভুক্ত করুন।

নিম্নলিখিত নির্দেশিকাগুলি বিশেষভাবে লাইভ স্ট্রিমের জন্য প্রযোজ্য:

• #EXT-X-PROGRAM-DATE-TIME ট্যাগটি ব্যবহার করুন।
• #EXT-X-DISCONTINUITY-SEQUENCE ট্যাগটি ব্যবহার করুন।
• একটি দীর্ঘ লাইভ উইন্ডো দিন। এক মিনিট বা তার বেশি হলে খুব ভালো।