Analytics

ExoPlayer-এ প্লেব্যাক অ্যানালিটিক্স সংক্রান্ত বিভিন্ন ধরনের প্রয়োজনীয়তা পূরণ করা যায়। শেষ পর্যন্ত, অ্যানালিটিক্স হল প্লেব্যাক থেকে ডেটা সংগ্রহ, ব্যাখ্যা, একত্রিতকরণ এবং সারসংক্ষেপ করা । এই ডেটা ডিভাইসে ব্যবহার করা যেতে পারে—যেমন লগিং, ডিবাগিং বা ভবিষ্যতে প্লেব্যাক সংক্রান্ত সিদ্ধান্ত নেওয়ার জন্য—অথবা সব ডিভাইস জুড়ে প্লেব্যাক মনিটর করার জন্য সার্ভারে রিপোর্ট করা যেতে পারে।

অ্যানালিটিক্স সিস্টেমকে সাধারণত প্রথমে ইভেন্ট সংগ্রহ করতে হয় এবং তারপরে সেগুলিকে অর্থপূর্ণ করার জন্য আরও প্রসেস করতে হয়:

  • ইভেন্ট সংগ্রহ: এটি ExoPlayer ইনস্ট্যান্সে AnalyticsListener রেজিস্টার করার মাধ্যমে করা যেতে পারে। প্লেয়ার ব্যবহার করার সময় রেজিস্টার করা অ্যানালিটিক্স লিসনাররা ইভেন্ট ঘটার সাথে সাথে সেগুলি সম্পর্কে জানতে পারেন। প্রতিটি ইভেন্ট প্লেলিস্টের সংশ্লিষ্ট মিডিয়া আইটেম এবং প্লেব্যাক পজিশন ও টাইমস্ট্যাম্প মেটাডেটার সাথে যুক্ত থাকে।
  • ইভেন্ট প্রসেসিং: কিছু অ্যানালিটিক্স সিস্টেম সার্ভারে র-ইভেন্ট আপলোড করে, যেখানে সব ইভেন্ট প্রসেসিং সার্ভার-সাইডে করা হয়। এছাড়াও, ডিভাইসে ইভেন্ট প্রসেস করা সম্ভব এবং এটি করলে আপলোড করার জন্য প্রয়োজনীয় তথ্যের পরিমাণ কমতে পারে বা প্রসেস করা আরও সহজ হতে পারে। ExoPlayer-এ PlaybackStatsListener আছে, যা আপনাকে নিম্নলিখিত প্রসেসিং ধাপগুলি সম্পূর্ণ করতে দেয়:
    1. ইভেন্ট ইন্টারপ্রিটেশন: অ্যানালিটিক্সের উদ্দেশ্যে উপযোগী হতে, ইভেন্টগুলি একটি প্লেব্যাকের প্রসঙ্গে ব্যাখ্যা করা প্রয়োজন। যেমন, প্লেয়ারের স্ট্যাটাস STATE_BUFFERING-এ পরিবর্তন হওয়ার র ইভেন্ট প্রাথমিক বাফারিং, রিবাফার বা খোঁজার পরে হওয়া বাফারিংয়ের সাথে সম্পর্কিত হতে পারে।
    2. স্টেট ট্র্যাকিং: এই ধাপ ইভেন্টকে কাউন্টারে কনভার্ট করে। যেমন, স্টেট পরিবর্তন সংক্রান্ত ইভেন্টকে কাউন্টারে কনভার্ট করা যেতে পারে যা প্রতিটি প্লেব্যাক স্টেটে কত সময় ব্যয় হয়েছে তা ট্র্যাক করে। ফলাফল হল একটি প্লেব্যাকের জন্য অ্যানালিটিক্স ডেটা মানের একটি প্রাথমিক সেট।
    3. এগ্রিগেশন: এই ধাপে একাধিক প্লেব্যাক জুড়ে অ্যানালিটিক্স ডেটা একত্রিত করা হয়, সাধারণত কাউন্টার যোগ করার মাধ্যমে।
    4. সারসংক্ষেপ মেট্রিকের গণনা: সবচেয়ে উপযোগী মেট্রিকের মধ্যে অনেকগুলিই গড় গণনা করে অথবা অন্য উপায়ে প্রাথমিক অ্যানালিটিক্স ডেটার মান একত্রিত করে। এক বা একাধিক প্লেব্যাকের জন্য সারাংশ মেট্রিক গণনা করা যেতে পারে।

AnalyticsListener-এর মাধ্যমে ইভেন্ট সংগ্রহ করা

প্লেয়ার থেকে র' প্লেব্যাক ইভেন্ট AnalyticsListener ইমপ্লিমেন্টেশনে রিপোর্ট করা হয়। আপনি নিজের লিসেনার যোগ করতে এবং শুধুমাত্র আপনার আগ্রহের পদ্ধতিগুলি ওভাররাইড করতে পারেন:

Kotlin

exoPlayer.addAnalyticsListener(
  object : AnalyticsListener {
    override fun onPlaybackStateChanged(eventTime: EventTime, @Player.State state: Int) {}

    override fun onDroppedVideoFrames(
      eventTime: EventTime,
      droppedFrames: Int,
      elapsedMs: Long,
    ) {}
  }
)

জাভা

exoPlayer.addAnalyticsListener(
    new AnalyticsListener() {
      @Override
      public void onPlaybackStateChanged(EventTime eventTime, @Player.State int state) {}

      @Override
      public void onDroppedVideoFrames(
          EventTime eventTime, int droppedFrames, long elapsedMs) {}
    });

প্রতিটি কলব্যাকে পাস করা EventTime, প্লেলিস্টের কোনও মিডিয়া আইটেমের সাথে ইভেন্টকে অ্যাসোসিয়েট করে, এর পাশাপাশি প্লেব্যাক পজিশন ও টাইমস্ট্যাম্প মেটাডেটা:

  • realtimeMs: ইভেন্টের ওয়াল ক্লক টাইম।
  • timeline, windowIndex এবং mediaPeriodId: প্লেলিস্ট এবং প্লেলিস্টের মধ্যে থাকা আইটেমকে সংজ্ঞায়িত করে যার সাথে ইভেন্টটি সম্পর্কিত। mediaPeriodId-এ ঐচ্ছিক অতিরিক্ত তথ্য থাকে, যেমন ইভেন্টটি আইটেমের মধ্যে থাকা কোনও বিজ্ঞাপনের সাথে সম্পর্কিত কিনা তা নির্দেশ করে।
  • eventPlaybackPositionMs: ইভেন্ট ঘটার সময় আইটেমে প্লেব্যাকের পজিশন।
  • currentTimeline, currentWindowIndex, currentMediaPeriodId এবং currentPlaybackPositionMs: আগে যেমন বর্ণনা করা হয়েছে, তবে বর্তমানে চলছে এমন আইটেমের জন্য। বর্তমানে যে আইটেমটি চালানো হচ্ছে সেটি ইভেন্টের আইটেম থেকে আলাদা হতে পারে, যেমন ইভেন্টটি যদি পরবর্তী আইটেম চালানোর জন্য প্রি-বাফারিংয়ের সাথে সম্পর্কিত হয়।

PlaybackStatsListener-এর মাধ্যমে ইভেন্ট প্রসেসিং

PlaybackStatsListener হল একটি AnalyticsListener যা অন-ডিভাইস ইভেন্ট প্রসেসিং প্রয়োগ করে। এটি কাউন্টার ও প্রাপ্ত মেট্রিক সহ PlaybackStats গণনা করে, যার মধ্যে রয়েছে:

  • সারাংশ মেট্রিক, যেমন মোট প্লেব্যাক সময়।
  • অ্যাডাপ্টিভ প্লেব্যাক কোয়ালিটি মেট্রিক, যেমন গড় ভিডিও রেজোলিউশন।
  • রেন্ডারিং কোয়ালিটি মেট্রিক, যেমন ড্রপ করা ফ্রেমের রেট।
  • রিসোর্স ব্যবহারের মেট্রিক, যেমন নেটওয়ার্কে কত বাইট ডেটা পড়া হয়েছে।

আপনি PlaybackStats Javadoc-এ উপলভ্য গণনা ও প্রাপ্ত মেট্রিকের সম্পূর্ণ তালিকা দেখতে পাবেন।

PlaybackStatsListener প্লেলিস্টের প্রতিটি মিডিয়া আইটেমের জন্য আলাদা PlaybackStats গণনা করে এবং এইসব আইটেমের মধ্যে যোগ করা প্রতিটি ক্লায়েন্ট-সাইড বিজ্ঞাপনও গণনা করে। প্লেব্যাক শেষ হওয়ার ব্যাপারে জানতে আপনি PlaybackStatsListener-এ কলব্যাক প্রদান করতে পারেন এবং কোন প্লেব্যাক শেষ হয়েছে তা শনাক্ত করতে কলব্যাকে পাস করা EventTime ব্যবহার করতে পারেন। একাধিক প্লেব্যাকের জন্য অ্যানালিটিক্স ডেটা একত্রিত করা সম্ভব। এছাড়াও, PlaybackStatsListener.getPlaybackStats() ব্যবহার করে যেকোনও সময় বর্তমান প্লেব্যাক সেশনের জন্য PlaybackStats-এ কোয়েরি করা সম্ভব।

Kotlin

exoPlayer.addAnalyticsListener(
  PlaybackStatsListener(/* keepHistory= */ true) {
    eventTime: EventTime?,
    playbackStats: PlaybackStats?
    -> // Analytics data for the session started at `eventTime` is ready.
  }
)

জাভা

exoPlayer.addAnalyticsListener(
    new PlaybackStatsListener(
        /* keepHistory= */ true,
        (eventTime, playbackStats) -> {
          // Analytics data for the session started at `eventTime` is ready.
        }));

PlaybackStatsListener-এর কনস্ট্রাক্টর প্রসেস করা ইভেন্টের সম্পূর্ণ ইতিহাস রাখার বিকল্প দেয়। মনে রাখবেন যে প্লেব্যাকের দৈর্ঘ্য এবং ইভেন্টের সংখ্যার উপর নির্ভর করে এটি একটি অজানা মেমরি ওভারহেড হতে পারে। তাই, শুধু চূড়ান্ত অ্যানালিটিক্স ডেটার পরিবর্তে প্রসেস করা ইভেন্টের সম্পূর্ণ ইতিহাস অ্যাক্সেস করার প্রয়োজন হলে তবেই এটি চালু করা উচিত।

মনে রাখবেন যে PlaybackStats শুধুমাত্র মিডিয়ার স্ট্যাটাসই নয়, বরং ব্যবহারকারীর চালানোর ইচ্ছা এবং আরও বিস্তারিত তথ্য যেমন প্লেব্যাক কেন বাধাগ্রস্ত বা শেষ হয়েছে তা দেখানোর জন্য স্ট্যাটাসের একটি বর্ধিত সেট ব্যবহার করে:

প্লেব্যাক স্টেট ব্যবহারকারীর খেলার ইচ্ছা খেলার কোনও ইচ্ছা নেই
প্লেব্যাকের আগে JOINING_FOREGROUND NOT_STARTED, JOINING_BACKGROUND
অ্যাক্টিভ প্লেব্যাক PLAYING
প্লেব্যাক বাধাগ্রস্ত হয়েছে BUFFERING, SEEKING PAUSED, PAUSED_BUFFERING, SUPPRESSED, SUPPRESSED_BUFFERING, INTERRUPTED_BY_AD
শেষের স্ট্যাটাস ENDED, STOPPED, FAILED, ABANDONED

ব্যবহারকারী কখন প্যাসিভ অপেক্ষা করার সময় থেকে প্লেব্যাক চালিয়ে যাওয়ার জন্য সক্রিয়ভাবে অপেক্ষা করছিলেন তা আলাদা করার জন্য ব্যবহারকারীর প্লে করার ইচ্ছা গুরুত্বপূর্ণ। যেমন, PlaybackStats.getTotalWaitTimeMs, JOINING_FOREGROUND, BUFFERING এবং SEEKING স্ট্যাটাসে কাটানো মোট সময় দেখায়, কিন্তু প্লেব্যাক পজ করা থাকলে সেই সময় দেখায় না। একইভাবে, PlaybackStats.getTotalPlayAndWaitTimeMs-এর মাধ্যমে ব্যবহারকারীর চালানোর ইচ্ছার মোট সময়, অর্থাৎ মোট অ্যাক্টিভ অপেক্ষার সময় এবং PLAYING অবস্থায় কাটানো মোট সময় জানা যাবে।

প্রসেস ও ব্যাখ্যা করা ইভেন্ট

keepHistory=true-এর সাথে PlaybackStatsListener ব্যবহার করে আপনি প্রসেস ও ব্যাখ্যা করা ইভেন্ট রেকর্ড করতে পারবেন। ফলাফল হিসেবে পাওয়া PlaybackStats-এ নিম্নলিখিত ইভেন্টের তালিকা থাকবে:

  • playbackStateHistory: এক্সটেন্ডেড প্লেব্যাক স্ট্যাটাসের ক্রমানুসারে সাজানো তালিকা, যেখানে EventTime থেকে সেগুলি প্রয়োগ করা শুরু হয়েছে। এছাড়াও, আপনি PlaybackStats.getPlaybackStateAtTime ব্যবহার করে নির্দিষ্ট দেওয়াল ঘড়ির সময়ে স্ট্যাটাস দেখতে পারবেন।
  • mediaTimeHistory: ওয়াল ক্লক টাইম ও মিডিয়া টাইমের ইতিহাস যা আপনাকে মিডিয়ার কোন অংশ কোন সময়ে চালানো হয়েছে তা পুনর্নির্মাণ করতে দেয়। এছাড়াও, আপনি PlaybackStats.getMediaTimeMsAtRealtimeMs ব্যবহার করে নির্দিষ্ট দেওয়াল ঘড়ির সময় অনুযায়ী প্লেব্যাক পজিশন দেখতে পারবেন।
  • videoFormatHistory এবং audioFormatHistory: প্লেব্যাকের সময় ব্যবহৃত ভিডিও এবং অডিও ফর্ম্যাটের ক্রমানুসারে সাজানো তালিকা, যেখানে EventTime থেকে সেগুলি ব্যবহার করা শুরু হয়েছে।
  • fatalErrorHistory এবং nonFatalErrorHistory: মারাত্মক এবং মারাত্মক নয় এমন সমস্যার ক্রমানুসারে সাজানো তালিকা, যেখানে EventTime-এ সমস্যাগুলি ঘটেছে। মারাত্মক সমস্যা হল সেগুলি যেগুলি প্লেব্যাক বন্ধ করে দেয়, যেখানে মারাত্মক নয় এমন সমস্যাগুলি সমাধান করা যেতে পারে।

সিঙ্গেল-প্লেব্যাক অ্যানালিটিক্স ডেটা

আপনি PlaybackStatsListener ব্যবহার করলে, এই ডেটা অটোমেটিক সংগ্রহ করা হয়, এমনকি keepHistory=false-এর সাথেও। চূড়ান্ত মান হল সর্বজনীন ফিল্ড যা আপনি PlaybackStats Javadoc-এ খুঁজে পাবেন এবং প্লেব্যাক স্টেট ডিউরেশন getPlaybackStateDurationMs-এর মাধ্যমে ফেরত পাবেন। সুবিধার জন্য, আপনি getTotalPlayTimeMs এবং getTotalWaitTimeMs-এর মতো পদ্ধতিও খুঁজে পাবেন যা নির্দিষ্ট প্লেব্যাক স্টেট কম্বিনেশনের সময়কাল রিটার্ন করে।

Kotlin

Log.d(
  "DEBUG",
  "Playback summary: " +
    "play time = " +
    playbackStats.totalPlayTimeMs +
    ", rebuffers = " +
    playbackStats.totalRebufferCount,
)

জাভা

Log.d(
    "DEBUG",
    "Playback summary: "
        + "play time = "
        + playbackStats.getTotalPlayTimeMs()
        + ", rebuffers = "
        + playbackStats.totalRebufferCount);

একাধিক প্লেব্যাকের মোট অ্যানালিটিক্স ডেটা

PlaybackStats.merge-এ কল করে আপনি একাধিক PlaybackStats একসাথে যোগ করতে পারবেন। ফলাফল হিসেবে পাওয়া PlaybackStats-এ সব মার্জ করা প্লেব্যাকের মোট ডেটা থাকবে। মনে রাখবেন, এতে আলাদা আলাদা প্লেব্যাক ইভেন্টের ইতিহাস থাকবে না, কারণ এগুলি একত্রিত করা যায় না।

PlaybackStatsListener.getCombinedPlaybackStats ব্যবহার করে PlaybackStatsListener-এর লাইফটাইমে সংগ্রহ করা সমস্ত অ্যানালিটিক্স ডেটার একটি সামগ্রিক ভিউ পাওয়া যেতে পারে।

গণনা করা সারসংক্ষেপ মেট্রিক

প্রাথমিক অ্যানালিটিক্স ডেটা ছাড়াও, PlaybackStats সারসংক্ষেপ মেট্রিক গণনা করার জন্য অনেক পদ্ধতি প্রদান করে।

Kotlin

Log.d(
  "DEBUG",
  "Additional calculated summary metrics: " +
    "average video bitrate = " +
    playbackStats.meanVideoFormatBitrate +
    ", mean time between rebuffers = " +
    playbackStats.meanTimeBetweenRebuffers,
)

জাভা

Log.d(
    "DEBUG",
    "Additional calculated summary metrics: "
        + "average video bitrate = "
        + playbackStats.getMeanVideoFormatBitrate()
        + ", mean time between rebuffers = "
        + playbackStats.getMeanTimeBetweenRebuffers());

উন্নত বিষয়

প্লেব্যাক মেটাডেটার সাথে অ্যানালিটিক্স ডেটা যুক্ত করা

আলাদা প্লেব্যাকের জন্য অ্যানালিটিক্স ডেটা সংগ্রহ করার সময়, আপনি হয়ত মিডিয়া প্লে করার সময় মেটাডেটার সাথে প্লেব্যাক অ্যানালিটিক্স ডেটা যুক্ত করতে চাইবেন।

MediaItem.Builder.setTag-এর সাথে মিডিয়া-নির্দিষ্ট মেটাডেটা সেট করা ভাল। মিডিয়া ট্যাগ হল EventTime-এর অংশ যা র ইভেন্টের জন্য রিপোর্ট করা হয় এবং যখন PlaybackStats শেষ হয়, তাই সংশ্লিষ্ট অ্যানালিটিক্স ডেটা ম্যানেজ করার সময় এটি উদ্ধার করা যেতে পারে:

Kotlin

PlaybackStatsListener(/* keepHistory= */ false) {
  eventTime: EventTime,
  playbackStats: PlaybackStats ->
  val mediaTag =
    eventTime.timeline
      .getWindow(eventTime.windowIndex, Timeline.Window())
      .mediaItem
      .localConfiguration
      ?.tag
  // Report playbackStats with mediaTag metadata.
}

জাভা

new PlaybackStatsListener(
    /* keepHistory= */ false,
    (eventTime, playbackStats) -> {
      Object mediaTag =
          eventTime.timeline.getWindow(eventTime.windowIndex, new Timeline.Window())
              .mediaItem
              .localConfiguration
              .tag;
      // Report playbackStats with mediaTag metadata.
    });

কাস্টম অ্যানালিটিক্স ইভেন্ট রিপোর্ট করা

অ্যানালিটিক্স ডেটাতে কাস্টম ইভেন্ট যোগ করতে হলে, আপনাকে এইসব ইভেন্ট নিজের ডেটা স্ট্রাকচারে সেভ করতে হবে এবং পরে রিপোর্ট করা PlaybackStats-এর সাথে সেগুলি একত্রিত করতে হবে। এটি সাহায্য করলে, আপনি DefaultAnalyticsCollector এক্সটেন্ড করতে পারেন যাতে আপনার কাস্টম ইভেন্টের জন্য EventTime ইনস্ট্যান্স জেনারেট করতে পারেন এবং নিম্নলিখিত উদাহরণে দেখানো হিসাবে আগে থেকে রেজিস্টার করা শ্রোতাদের কাছে পাঠাতে পারেন।

Kotlin

@OptIn(UnstableApi::class)
private interface ExtendedListener : AnalyticsListener {
  fun onCustomEvent(eventTime: EventTime)
}

@OptIn(UnstableApi::class)
private class ExtendedCollector : DefaultAnalyticsCollector(Clock.DEFAULT) {

  fun customEvent() {
    val eventTime = super.generateCurrentPlayerMediaPeriodEventTime()
    super.sendEvent(eventTime, CUSTOM_EVENT_ID) { listener: AnalyticsListener ->
      if (listener is ExtendedListener) {
        listener.onCustomEvent(eventTime)
      }
    }
  }
}

@OptIn(UnstableApi::class)
fun useExtendedAnalyticsCollector(context: Context) {
  // Usage - Setup and listener registration.
  val player = ExoPlayer.Builder(context).setAnalyticsCollector(ExtendedCollector()).build()
  player.addAnalyticsListener(
    object : ExtendedListener {
      override fun onCustomEvent(eventTime: EventTime) {
        // Save custom event for analytics data.
      }
    }
  )
  // Usage - Triggering the custom event.
  (player.analyticsCollector as ExtendedCollector).customEvent()
}

জাভা

@OptIn(markerClass = UnstableApi.class)
private interface ExtendedListener extends AnalyticsListener {
  void onCustomEvent(EventTime eventTime);
}

@OptIn(markerClass = UnstableApi.class)
private static class ExtendedCollector extends DefaultAnalyticsCollector {
  public ExtendedCollector() {
    super(Clock.DEFAULT);
  }

  public void customEvent() {
    AnalyticsListener.EventTime eventTime = generateCurrentPlayerMediaPeriodEventTime();
    sendEvent(
        eventTime,
        CUSTOM_EVENT_ID,
        listener -> {
          if (listener instanceof ExtendedListener) {
            ((ExtendedListener) listener).onCustomEvent(eventTime);
          }
        });
  }
}

@OptIn(markerClass = UnstableApi.class)
public static void useExtendedAnalyticsCollector(Context context) {
  // Usage - Setup and listener registration.
  ExoPlayer player =
      new ExoPlayer.Builder(context).setAnalyticsCollector(new ExtendedCollector()).build();
  player.addAnalyticsListener(
      (ExtendedListener)
          eventTime -> {
            // Save custom event for analytics data.
          });
  // Usage - Triggering the custom event.
  ((ExtendedCollector) player.getAnalyticsCollector()).customEvent();
}

ফিচার ফ্ল্যাগ ও Canary মোড ট্র্যাক করা

A/B টেস্টিং পরিচালনা করার সময় বা নতুন Media3 অপ্টিমাইজেশনের প্রভাব মূল্যায়ন করার সময়, আপনি প্লেব্যাক অ্যানালিটিক্স ডেটাকে অ্যাক্টিভ ফিচার ফ্ল্যাগ এবং Canary মোডের সাথে সম্পর্কযুক্ত করতে পারেন।

আপনি Flags.getLogString কোয়েরি করতে পারেন অথবা Flags.getEnabledOverrides এবং Flags.getDisabledOverrides ব্যবহার করে নির্দিষ্ট ফ্ল্যাগ ওভাররাইড পরীক্ষা করতে পারেন যাতে আপনার কাস্টম অ্যানালিটিক্স পেলোড বা সেশন মেটাডেটায় ফ্ল্যাগ স্টেট অন্তর্ভুক্ত করা যায়।