Quay lại một khoảng nghỉ quảng cáo đã bỏ qua

Chọn nền tảng: HTML5 Android iOS tvOS Roku

Là một nhà xuất bản video, bạn có thể muốn ngăn người xem tua qua quảng cáo trong video. Khi người dùng tìm kiếm qua một điểm chèn quảng cáo, bạn có thể đưa họ trở lại điểm bắt đầu của điểm chèn quảng cáo đó, rồi đưa họ quay về vị trí tìm kiếm sau khi điểm chèn quảng cáo đã hiển thị xong. Tính năng này có tên là "quay lại nhanh".

Ví dụ: xem sơ đồ bên dưới. Người xem đang xem một video và quyết định tua từ mốc 5 phút đến mốc 15 phút. Tuy nhiên, có một điểm chèn quảng cáo ở mốc 10 phút mà bạn muốn họ xem trước khi có thể xem nội dung sau đó:

Để hiển thị khoảng chèn quảng cáo này, hãy làm theo các bước sau:

1. Kiểm tra xem người dùng có thực hiện thao tác tìm kiếm để chuyển qua một điểm chèn quảng cáo chưa xem hay không. Nếu có, hãy đưa họ quay lại điểm chèn quảng cáo đó.
2. Sau khi điểm chèn quảng cáo kết thúc, hãy đưa người dùng trở lại vị trí tìm kiếm ban đầu.

Dưới dạng sơ đồ, điều đó có dạng như sau:

Sau đây là cách triển khai quy trình này trong SDK IMA DAI, như trong AdvancedExample.

Ngăn người dùng tua qua điểm chèn quảng cáo mà không xem

Kiểm tra xem người dùng có thực hiện thao tác tua qua một điểm chèn quảng cáo chưa xem hay không. Nếu có, hãy đưa họ quay lại điểm chèn quảng cáo đó. Trong SDK Android, hãy sử dụng đối tượng PlayerControl để phát hiện thao tác tìm kiếm. Khi người dùng tìm kiếm, hãy kích hoạt phương thức onSeek() của SampleHlsVideoPlayerCallback do SampleAdsWrapper triển khai. Phương thức đó (được trình bày bên dưới) sẽ kiểm tra điểm đánh dấu trước thời gian tìm kiếm của người dùng. Nếu chưa phát, hãy chuyển đến đầu thời điểm hiển thị quảng cáo đó thay vì điểm tìm kiếm mong muốn ban đầu và lưu điểm tìm kiếm mong muốn đó trong snapBackTime.

@Override
public void onSeek(int timeMillis) {
  double timeToSeek = timeMillis;
  if (streamManager != null) {
    CuePoint cuePoint =
        streamManager.getPreviousCuePointForStreamTime(timeMillis / 1000);
    if (cuePoint != null && !cuePoint.isPlayed()) {
      snapBackTime = timeToSeek / 1000.0; // Update snapback time.
      // Missed cue point, so snap back to the beginning of cue point.
      timeToSeek = cuePoint.getStartTime() * 1000;
      videoPlayer.seek(Math.round(timeToSeek));
      videoPlayer.setCanSeek(false);
      return;
    }
  }
  videoPlayer.seek(Math.round(timeToSeek));
}

Đưa người dùng trở lại điểm tua ban đầu

Giờ đây, khi bạn nhận được sự kiện onAdBreakEnded, hãy kiểm tra xem snapBackTime có được đặt hay không. Nếu có, hãy đưa người dùng đến điểm đó trong luồng phát, vì khoảng thời gian quảng cáo mà họ vừa xem là kết quả của tính năng tua lại:

@Override
public void onAdBreakEnded() {
  // Re-enable player controls.
  videoPlayer.setCanSeek(true);
  videoPlayer.enableControls(true);
  if (snapBackTime > 0) {
    videoPlayer.seek(Math.round(snapBackTime * 1000));
  }
  snapBackTime = 0;
}