กลับไปที่ช่วงพักโฆษณาที่ข้าม

เลือกแพลตฟอร์ม: HTML5 Android iOS tvOS Roku

ในฐานะผู้เผยแพร่วิดีโอ คุณอาจต้องการป้องกันไม่ให้ผู้ชม ข้ามโฆษณาตอนกลาง เมื่อผู้ใช้เลื่อนแถบเลื่อนเลยช่วงพักโฆษณา คุณสามารถนำผู้ใช้กลับไปยังจุดเริ่มต้นของช่วงพักโฆษณานั้น จากนั้นนำ ผู้ใช้กลับไปยังตำแหน่งเดิมหลังจากช่วงพักโฆษณาสิ้นสุดลง ฟีเจอร์นี้ เรียกว่า "ย้อนกลับ"

ดูตัวอย่างได้ที่แผนภาพด้านล่าง ผู้ชมกำลังดูวิดีโอ และตัดสินใจที่จะกรอจากช่วง 5 นาทีไปที่ช่วง 15 นาที อย่างไรก็ตาม คุณต้องการให้ผู้ชมดูช่วงพักโฆษณาที่เครื่องหมาย 10 นาที ก่อนที่จะดูเนื้อหาหลังจากนั้น

หากต้องการแสดงช่วงพักโฆษณานี้ ให้ทำตามขั้นตอนต่อไปนี้

  1. ตรวจสอบว่าผู้ใช้เลื่อนแถบเลื่อนข้ามช่วงพักโฆษณาที่ยังไม่ได้ดูหรือไม่ หากใช่ ให้นำผู้ใช้กลับไปยังช่วงพักโฆษณานั้น
  2. หลังจากช่วงพักโฆษณาสิ้นสุดลง ให้นำผู้ใช้กลับไปยังตำแหน่งเดิมที่ผู้ใช้เลื่อนแถบเลื่อน

ในรูปแบบแผนภาพ จะมีลักษณะดังนี้

วิธีติดตั้งใช้งานเวิร์กโฟลว์นี้ใน IMA DAI SDK มีดังนี้ AdvancedExample

ป้องกันการข้ามโฆษณาที่ยังไม่ได้ดู

หากผู้ใช้พยายามข้ามช่วงพักโฆษณา เพลเยอร์ต้องตรวจหาการข้ามและ บังคับให้เล่นช่วงพักโฆษณานั้นๆ ตั้งแต่ต้น หากไม่ต้องการให้ผู้ชมข้ามโฆษณาที่ยังไม่ได้ดู ให้ทำดังนี้

  1. เมื่อผู้ใช้เริ่มโต้ตอบกับแถบเลื่อน ให้บันทึกเวลา การเล่นปัจจุบัน
  2. หลังจากที่ผู้ใช้เลื่อนไปยังเวลาอื่นในสตรีม ให้ระบุช่วงพักโฆษณาล่าสุดที่อยู่ก่อนเวลานี้
  3. หากช่วงพักโฆษณาเริ่มหลังจากเวลาเริ่มต้นที่บันทึกไว้ ซึ่งบ่งบอกว่ามีการข้าม และยังไม่ได้เล่น ให้เลื่อนโปรแกรมเล่นไปที่จุดเริ่มต้นของช่วงพัก โฆษณา
  4. เปิดใช้snapbackModeเพื่อติดตามว่ามีการบังคับใช้ช่วงพักโฆษณานี้

Objective-C

- (IBAction)videoControlsTouchStarted:(id)sender {
  [NSObject cancelPreviousPerformRequestsWithTarget:self
                                            selector:@selector(hideFullscreenControls)
                                              object:self];

  self.currentlySeeking = YES;
  self.seekStartTime = self.contentPlayer.currentTime;
}

- (IBAction)videoControlsTouchEnded:(id)sender {
  if (self.fullscreen) {
    [self startHideControlsTimer];
  }
  self.currentlySeeking = NO;
  if (!self.adPlaying) {
    self.seekEndTime = CMTimeMake(self.progressBar.value, 1);
    IMACuepoint *lastCuepoint =
        [self.streamManager previousCuepointForStreamTime:CMTimeGetSeconds(self.seekEndTime)];
    if (!lastCuepoint.played && (lastCuepoint.startTime > CMTimeGetSeconds(self.seekStartTime))) {
      self.snapbackMode = YES;
      // Add 1 to the seek time to get the keyframe at the start of the ad to be our landing
      // place.
      [self.contentPlayer
          seekToTime:CMTimeMakeWithSeconds(lastCuepoint.startTime + 1, NSEC_PER_SEC)];
    }
  }
}

Swift

@IBAction func progressBarTouchStarted(_ sender: UISlider) {
  guard !isAdPlaying else { return }
  currentlySeeking = true
  seekStartTime = contentPlayer.currentTime().seconds
}

// MARK: Snapback Logic
@IBAction func progressBarTouchEnded(_ sender: UISlider) {
  guard !isAdPlaying else { return }
  if isFullScreen {
    startHideControlsTimer()
  }
  currentlySeeking = false
  seekEndTime = Float64(sender.value)

  guard let streamManager else { return }

  if let lastCuepoint = streamManager.previousCuepoint(forStreamTime: seekEndTime) {
    if !lastCuepoint.isPlayed, lastCuepoint.startTime > seekStartTime {
      logMessage(
        "Snapback to \(String(format: "%.2f", lastCuepoint.startTime)) from \(String(format: "%.2f", seekEndTime))"
      )
      snapbackMode = true
      contentPlayer.seek(
        to: CMTime(seconds: Double(sender.value), preferredTimescale: 1000))
    }
  }
}

กลับมาเล่นต่อจากตำแหน่งเดิม

หลังจากที่ช่วงพักโฆษณาที่บังคับเล่นจบลงแล้ว เพลเยอร์จะนำผู้ใช้ไปยังจุดเนื้อหาที่ต้องการ

หากต้องการกลับไปใช้การกรอของผู้ใช้ตามเดิม ให้ทำดังนี้

  1. รอฟังเหตุการณ์ AD_BREAK_ENDED ในตัวจัดการสตรีม

  2. ตรวจสอบว่าsnapbackMode flag ทำงานอยู่เพื่อให้แน่ใจว่าการข้ามนี้จะเกิดขึ้น หลังจากดูโฆษณาแบบบังคับ

  3. หากมีการใช้งานอยู่ ให้เลื่อนเพลเยอร์ไปยังเวลาปลายทางที่บันทึกไว้เพื่อนำผู้ใช้กลับไป ยังการประทับเวลาที่ต้องการ

ตัวอย่างต่อไปนี้จะรอให้ช่วงพักโฆษณาจบลงและนำผู้ใช้กลับไปที่การกรอเดิม

Objective-C

case kIMAAdEvent_AD_BREAK_ENDED: {
  [self logMessage:@"Ad break ended"];
  self.adPlaying = NO;
  if (self.snapbackMode) {
    self.snapbackMode = NO;
    if (CMTimeCompare(self.seekEndTime, self.contentPlayer.currentTime)) {
      [self.contentPlayer seekToTime:self.seekEndTime];
    }
  }
  break;
}

Swift

case .AD_BREAK_ENDED:
  logMessage("Ad break ended")
  isAdPlaying = false
  progressBar.isUserInteractionEnabled = true
  if snapbackMode {
    snapbackMode = false
    if contentPlayer.currentTime().seconds < seekEndTime {
      contentPlayer.seek(to: CMTime(seconds: Double(seekEndTime), preferredTimescale: 1000))
    }
  } else if pendingBookmarkSeek, let time = bookmarkStreamTime {
    logMessage(String(format: "AD_BREAK_ENDED: Seeking to bookmark streamTime: %.2f", time))
    imaVideoDisplay.seekStream(toTime: time)
    pendingBookmarkSeek = false
    bookmarkStreamTime = nil
  }
  updatePlayHeadState(isPlaying: self.isContentPlaying)