初始化和設定視訊分析

您可以設定播放器以追蹤和分析視訊使用情況。

在啟用視訊追蹤（視訊心率）之前，請確定您擁有下列專案：

• Android適用的TVSDK
• 設定/初始化資訊 — 請聯絡您的Adobe代表，取得您特定的視訊追蹤帳戶資訊：

若要在播放器中設定視訊追蹤：

1. 確認中的載入時間選項 ADBMobileConfig.json 資源檔案正確。

   {
       "version" : "1.1",
       "analytics" : {
           "rsids" : "adobedevelopment",
           "server" : "10.131.129.149:3000",
           "charset" : "UTF-8",
           "ssl" : false,
           "offlineEnabled" : false,
           "lifecycleTimeout" : 5,
           "batchLimit" : 50,
           "privacyDefault" : "optedin",
           "poi" : []
       },
       "marketingCloud": {
           "org": "ADOBE PROVIDED VALUE"
       },
       "target" : {
           "clientCode" : "",
           "timeout" : 5
       },
       "audienceManager" : {
           "server" : ""
       }
   }
   

   此JSON格式設定檔案是隨TVSDK提供的資源。 您的播放器僅在載入時讀取這些值，而值在應用程式執行時保持不變。

   若要設定載入時間選項：

   1. 確認 ADBMobileConfig.json 檔案包含Adobe提供的適當值。

   2. 確認此檔案位於 assets 資料夾。

      此資料夾必須位於應用程式來源樹狀結構的根目錄中。

   3. 編譯及建置您的應用程式。

   4. 部署並執行隨附的應用程式。

      如需這些AppMeasurement設定的詳細資訊，請參閱 在Adobe Analytics中測量視訊.

2. 初始化和設定視訊心率追蹤中繼資料。

   重要

   您可以停止視訊分析模組midstream，並視需要再次將其重新初始化。 在重新初始化模組之前，請確定視訊分析中繼資料也更新為正確的內容中繼資料。 若要重新建立中繼資料，請重複子步驟1和2。

   1. 建立Video Analytics中繼資料的例項。

      此例項包含啟用視訊心率追蹤所需的所有設定資訊。 例如：

      private VideoAnalyticsMetadata getVideoAnalyticsTrackingMetadata() {
          VideoAnalyticsMetadata vaMetadata = new VideoAnalyticsMetadata();
      
          vaMetadata.setTrackingServer("example.com");
          vaMetadata.setPublisher("sample-publisher");
          vaMetadata.setChannel("test-channel");
          vaMetadata.setVideoName("myvideo");
          vaMetadata.setVideoId("myvideoid");
          vaMetadata.setPlayerName("PSDK Player");
          vaMetadata.setUseSSL(false);
          vaMetadata.debugLogging = true; // Set to NO for production deployment.
          vaMetadata.quietMode = false; // Set to NO for production deployment.
          vaMetadata.setEnableChapterTracking(true);
          // use this API to override the default asset length -1 for live streams
          vaMetadata.setAssetDuration(SAMPLE_ASSET_DURATION);
      
          return vaMetadata;
      }
      

   2. 將Video Analytics中繼資料新增至全域中繼資料例項。

      準備就緒後，請在媒體資源或媒體播放器專案上設定全域中繼資料例項：

      ((MetadataNode)resourceMetadata).setNode(
            DefaultMetadataKeys.VIDEO_ANALYTICS_METADATA_KEY.getValue(), vaMetadata);
      

   3. 初始化Video Analytics追蹤器

      建立媒體播放器例項後，您必須建立Video Analytics追蹤器例項，並提供媒體播放器例項的參考。

      秘訣

      請一律為每個內容播放工作階段建立新的追蹤器例項，並在您分離媒體播放器例項後移除先前的參照。

      VideoAnalyticsProvider videoAnalyticsProvider =
        new VideoAnalyticsProvider(appContext);
      
      // Attach the TVSDK media player instance
      videoAnalyticsProvider.attachMediaPlayer(mediaPlayer);
      

   4. 銷毀Video Analytics追蹤器。

      開始新的內容播放工作階段之前，請先摧毀視訊追蹤器的上一個例項。 收到內容完成事件（或通知）後，請稍候幾分鐘再摧毀視訊追蹤器例項。 立即摧毀執行個體可能會干擾Video Analytics追蹤器傳送視訊完成Ping的功能。

      if (_videoAnalyticsProvider) {
          _videoAnalyticsProvider.detachMediaPlayer();
          _videoAnalyticsProvider = null;
      }
      

   5. 手動將即時/線性資料流標示為完成。

      如果您在一個即時資料流上有各種集數，您可以使用完整的API手動將集數標示為完成。 這會結束目前影片的視訊追蹤工作階段，而且您可以為下一集開始新的追蹤工作階段。

      秘訣

      此API為選用專案，VOD視訊追蹤不需要此API。

      if (_videoAnalyticsProvider) {
         _videoAnalyticsProvider.trackVideoComplete();
      }