建立媒體資源

對於每個新視訊內容,初始化包含視訊內容相關資訊的MediaResource例項並載入媒體資源。 MediaResource類代表MediaPlayer實例要載入的內容。

  1. 將媒體相關資訊傳遞至MediaResource建構函式,以建立MediaResource

    建構函式參數 說明

    url

    代表媒體資訊清單/播放清單URL的字串。

    type

    MediaResource.Type 枚舉的下列成員之一,該枚舉與指定的檔案類型相對應:

    • HLS - M3U8

    中繼資料

    中繼資料類別的例項,可能包含要載入內容的自訂資訊。

    內容的範例是要置於主要內容內的替代或廣告內容。 如果使用廣告,請設定 AuditudeSettings 。 如需詳細資訊,請參閱Ad Insertion中繼資料

    重要

    TVSDK僅支援特定內容類型的播放。 如果您嘗試載入任何其他類型的內容,TVSDK會派單錯誤事件。

    對於MP4隨選視訊(VOD)內容,TVSDK不支援特技播放、可調式位元速率(ABR)串流、廣告插入、隱藏字幕或DRM。

    以下代碼建立MediaResource實例:

    try { 
        // create a MediaResource instance pointing to some HLS content 
        Metadata metadata = //TODO: create metadata  
        MediaResource mediaResource = MediaResource.createFromUrl( 
          "https://www.example.com/video/some-video.m3u8",  
          MediaResource.Type.HLS,  
          metadata); 
    } catch(IllegalArgumentException ex) { 
        // this exception is thrown if the URL does not point  
        // to a valid url. 
    } 
    
    秘訣

    此時,您可以使用MediaResource存取器(getters)來檢查資源的類型、URL和中繼資料。

  2. 使用以下方法載入媒體資源:

    • 您的MediaPlayer例項。

      如需詳細資訊,請參閱「在MediaPlayer中載入媒體資源」。🔗

    • A MediaPlayerItemLoader如需詳細資訊,請參閱使用MediaPlayerItemLoader載入媒體資源。

    重要

    不要在後台線程上載入媒體資源。 大部分的TVSDK作業都需要在主執行緒上執行,而在背景執行緒上執行這些作業可能會導致作業擲回錯誤並退出。

本頁內容