顯示具有當前播放位置的搜索拖曳欄

TVSDK支援搜尋特定位置(時間),其中串流為滑動視窗播放清單、視訊隨選(VOD)和即時串流。

秘訣

在即時串流中搜尋僅允許DVR使用。

  1. 設定搜索回呼。

    搜尋是非同步的,因此TVSDK會調派下列搜尋相關事件:
    
    • MediaPlayerEvent.SEEK_BEGIN,尋找開始的位置。
    • MediaPlayerEvent.SEEK_END,其中尋找成功。
    • MediaPlayerEvent.OPERATION_FAILED,而尋找失敗的地方。
  2. 等待播放器處於有效狀態以進行搜尋。

    有效狀態包括「已準備」、「完成」、「暫停」和「正在播放」。

  3. 使用原生SeekBar來設定OnSeekBarChangeListener,此設定會決定使用者在何時拖曳。

  4. 將請求的尋道位置(毫秒)傳遞至MediaPlayer.seek方法。

    void seek(long position) throws MediaPlayerException;
    

    您只能在資產可見的期間內搜尋。 對於隨選視訊,即從0到資產的持續時間。

    秘訣

    此步驟會將播放磁頭移至串流中的新位置,但最終計算位置可能與指定的搜尋位置不同。

  5. 監聽MediaPlayerEvent.OPERATION_FAILED並採取適當的動作。

    此事件會傳遞適當的警告。 您的應用程式會決定如何繼續,而選項包括再次嘗試搜尋或從上一個位置繼續播放。

  6. 等待TVSDK呼叫MediaPlayerEvent.SEEK_END回呼。

  7. 使用回呼的位置參數擷取最終調整的播放位置。

    這很重要,因為搜尋後的實際開始位置可能與請求的位置不同。 如果搜尋或其他重新定位在廣告插播的中間結束或跳過廣告插播,規則(包括播放行為)可能會受到影響。

  8. 在顯示搜尋拖曳列時使用位置資訊。

搜尋範例

在此範例中,使用者將搜尋列拖曳至所要的位置。

//Use the native SeekBar to set an OnSeekBarChangeListener to
// see when the user is scrubbing.
seekBar.setOnSeekBarChangeListener(new SeekBar.OnSeekBarChangeListener() {
    @Override
    public void onProgressChanged(SeekBar seekBar, int progress, boolean isFromUser) {
        if (isFromUser) {
            // Update the seek bar thumb with the position provided by the user.
            setPosition(progress);
        }
    }

    @Override
    public void onStartTrackingTouch(SeekBar seekBar) {
        isSeeking = true;
    }

    @Override
    public void onStopTrackingTouch(SeekBar seekBar) {
        isSeeking = false;

        // Retrieve the playback range.
        TimeRange playbackRange = mediaPlayer.getPlaybackRange();

        // Make sure to seek inside the playback range.
        long seekPosition = Math.min(Math.round(seekBar.getProgress()),
        playbackRange.getDuration());

        // Perform seek.
        seek(playbackRange.getBegin() + seekPosition);
    }
};

本頁內容