Function●Since v1.0

useVideoPlayer

useVideoPlayer(
  videoRef: RefObject<HTMLVideoElement | null>,
  media: VideoMedia | undefined,
  options: UseVideoPlayerOptions

Parameters

Name	Type	Description
`videoRef`*	`RefObject<HTMLVideoElement \| null>`
`media`*	`VideoMedia \| undefined`
`options`	`UseVideoPlayerOptions`

Bind a VideoMedia handle to a caller-owned <video> element.

The caller renders <video ref={videoRef}> and styles it however they like; the hook never injects DOM nor overrides layout.
On message-finish, the underlying blob URL is minted and assigned as video.src. Progressive playback of streamed container video (fragmented mp4 / webm via MSE) is out of scope for this version; status stays in "buffering" until the blob resolves.
Element events (play / pause / ended / timeupdate / loadedmetadata / error) are translated into the shared PlayerStatus enum.
On unmount, media.revoke() is called to free the object URL.