Expose requestFullscreen method from Vimeo Player via useVimeoPlayer

[adityapattani]

Currently, the useVimeoPlayer hook exposes a limited set of Vimeo Player methods such as play, pause, and seekTo. However, the official Vimeo Player JS API (Docs: https://github.com/vimeo/player.js/?tab=readme-ov-file#requestfullscreen-promisevoid-error) supports requestFullscreen() and exitFullscreen() methods, which are not accessible via the bridge.

Expected Behavior

Calling requestFullscreen() on the player should programmatically enter fullscreen mode on Android (and iOS, if supported).

Calling exitFullscreen() should exit fullscreen mode.

Use Case

• Auto-fullscreen videos on Android when autoPlay is enabled.
• Provide parity with iOS behavior.
• Avoid the need for manually injecting JavaScript into the WebView to access the Vimeo Player instance.

[saseungmin]

I'll work on this feature over the weekend!

[saseungmin]

@adityapattani

This has been implemented! 🎉 (v1.2.0)

I've added support for the three fullscreen control methods:

• requestFullscreen(): Enter fullscreen mode programmatically
• exitFullscreen(): Exit fullscreen mode
• getFullscreen(): Get current fullscreen state

These methods are now available on the player instance returned by useVimeoPlayer hook.

Example usage:

const player = useVimeoPlayer(vimeoUrl);

// Enter fullscreen
await player.requestFullscreen();

// Exit fullscreen
await player.exitFullscreen();

// Check fullscreen state
const isFullscreen = await player.getFullscreen();

You can also listen to fullscreen changes using the fullscreenchange event:

const fullscreenState = useVimeoEvent(player, 'fullscreenchange');
console.log(fullscreenState?.fullscreen); // true or false

Check out the example app for a working demo!