Unity study notes Description of AVPro video jump function (Seeking)

1. SeekingFunction related interface

Find jumps by double-precision time：

• Seek() ⇒ Jump to the screen at the exact specified time
• SeekFast() ⇒ Jump to the most recent frame at the specified time
• SeekWithTolerance() ⇒ Jump to the screen within a certain range at the specified time（只支持macOS,ios,tvOS）

Find jumps by using frames（Only valid for media with a known constant frame rate）：

• SeekToFrame() ⇒ Jump to a specific frame of the picture
• SeekToFrameRelative() ⇒ Jump to the frame how many frames forward or backward relative to the current frame

The source code of the underlying interface is as follows：

		/// <summary>
		/// The time in seconds seeked will be to the exact time
		/// This can take a long time is the keyframes are far apart
		/// Some platforms don't support this and instead seek to the closest keyframe
		/// </summary>
		void	Seek(double time);

		/// <summary>
		/// The time in seconds seeked will be to the closest keyframe
		/// </summary>
		void	SeekFast(double time);

		/// <summary>
		/// The time in seconds seeked to will be within the range [time-timeDeltaBefore, time+timeDeltaAfter] for efficiency.
		/// Only supported on macOS, iOS and tvOS.
		/// Other platforms will automatically pass through to Seek()
		/// </summary>
		void	SeekWithTolerance(double time, double timeDeltaBefore, double timeDeltaAfter);

		/// <summary>
		/// Seek to a specific frame, range is [0, GetMaxFrameNumber()]
		/// NOTE: For best results the video should be encoded as keyframes only
		/// and have no audio track, or an audio track with the same length as the video track
		/// </summary>
		void	SeekToFrame(int frame, float overrideFrameRate = 0f);

		/// <summary>
		/// Seek forwards or backwards relative to the current frame
		/// NOTE: For best results the video should be encoded as keyframes only
		/// and have no audio track, or an audio track with the same length as the video track
		/// </summary>
		void	SeekToFrameRelative(int frameOffset, float overrideFrameRate = 0f);

需要注意的是,Jump response/Behavior varies on different platforms

平台	Fast approximate keyframe search(Fast Approximate Keyframe Seeking)	Accurate framing at slow speed(Slow Accurate Frame Seeking)
Windows (WinRT / Media Foundation)	*	*
Windows (DirectShow)	*	Depends on the codec
Android (ExoPlayer)	*	*
Android (MediaPlayer)	*	API 26 及以上
macOS	*	*
iOS/iPadOS/tvOS	*	*
WebGL	*	Varies depending on the situation

2. 跳转(Seeking)Example of the implementation of the function

具体的实现可以参考AVPro提供的Demo（Demo_MediaPlayer场景）

Only the combined time bar is listed below(slider)The part where video jumps are made：

		[Header("UI Components")]
		[SerializeField] Slider _sliderTime = null;

		void Start()
		{
    
			CreateTimelineDragEvents();
		}

		private void CreateTimelineDragEvents()
		{
    
			EventTrigger trigger = _sliderTime.gameObject.GetComponent<EventTrigger>();
			if (trigger != null)
			{
    
				EventTrigger.Entry entry = new EventTrigger.Entry();
				entry.eventID = EventTriggerType.PointerDown;
				entry.callback.AddListener((data) => {
     OnTimeSliderBeginDrag(); });
				trigger.triggers.Add(entry);

				entry = new EventTrigger.Entry();
				entry.eventID = EventTriggerType.Drag;
				entry.callback.AddListener((data) => {
     OnTimeSliderDrag(); });
				trigger.triggers.Add(entry);

				entry = new EventTrigger.Entry();
				entry.eventID = EventTriggerType.PointerUp;
				entry.callback.AddListener((data) => {
     OnTimeSliderEndDrag(); });
				trigger.triggers.Add(entry);

				entry = new EventTrigger.Entry();
				entry.eventID = EventTriggerType.PointerEnter;
				entry.callback.AddListener((data) => {
     OnTimelineBeginHover((PointerEventData)data); });
				trigger.triggers.Add(entry);

				entry = new EventTrigger.Entry();
				entry.eventID = EventTriggerType.PointerExit;
				entry.callback.AddListener((data) => {
     OnTimelineEndHover((PointerEventData)data); });
				trigger.triggers.Add(entry);
			}
		}

		private bool _wasPlayingBeforeTimelineDrag;
		private void OnTimeSliderBeginDrag()
		{
    
			if (_mediaPlayer && _mediaPlayer.Control != null)
			{
    
				_wasPlayingBeforeTimelineDrag = _mediaPlayer.Control.IsPlaying();
				if (_wasPlayingBeforeTimelineDrag)
				{
    
					_mediaPlayer.Pause();
				}
				OnTimeSliderDrag();
			}
		}

		private void OnTimeSliderDrag()
		{
    
			if (_mediaPlayer && _mediaPlayer.Control != null)
			{
    
				TimeRange timelineRange = GetTimelineRange();
				double time = timelineRange.startTime + (_sliderTime.value * timelineRange.duration);
				_mediaPlayer.Control.Seek(time);
				_isHoveringOverTimeline = true;
			}
		}

		private void OnTimeSliderEndDrag()
		{
    
			if (_mediaPlayer && _mediaPlayer.Control != null)
			{
    
				if (_wasPlayingBeforeTimelineDrag)
				{
    
					_mediaPlayer.Play();
					_wasPlayingBeforeTimelineDrag = false;
				}
			}
		}


		private bool _isHoveringOverTimeline;
		private void OnTimelineBeginHover(PointerEventData eventData)
		{
    
			if (eventData.pointerCurrentRaycast.gameObject != null)
			{
    
				_isHoveringOverTimeline = true;
				_sliderTime.transform.localScale = new Vector3(1f, 2.5f, 1f);
			}
		}

		private void OnTimelineEndHover(PointerEventData eventData)
		{
    
			_isHoveringOverTimeline = false;
			_sliderTime.transform.localScale = new Vector3(1f, 1f, 1f);
		}

参考文献

AVPro官方说明文档