初始化並設定視訊分析

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

在啟動視訊追蹤（視訊心率）之前，請確定您有下列項目：

• 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. 初始化並設定視訊心率追蹤中繼資料。

   重要

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

   1. 建立視訊分析中繼資料的例項。

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

      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. 將視訊分析中繼資料新增至全域中繼資料例項。

      當您準備好時，在媒體資源或媒體播放器項目上設定全域中繼資料例項：

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

   3. 初始化視訊分析追蹤器。

      建立媒體播放器例項後，您必須建立視訊分析追蹤器例項並提供媒體播放器例項的參考。

      秘訣

      請務必為每個內容播放作業建立新的追蹤器例項，並在您分離媒體播放器例項後移除先前的參考。

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

   4. 銷毀視訊分析追蹤器。

      開始新的內容播放作業前，請先銷毀視訊追蹤器的先前例項。 收到內容完成事件（或通知）後，請等候幾分鐘，再銷毀視訊追蹤器例項。 立即銷毀執行個體可能會干擾視訊分析追蹤器傳送視訊完成ping的功能。

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

   5. 手動將即時／線性串流標示為完成。

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

      秘訣

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

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