Saltar al contenido principal
Volver a plugins
@capgo/capacitor-orientación-de-pantalla
Tutoriales
@capgo/capacitor-orientación-de-pantalla

Orientación de pantalla

Plugin de orientación de pantalla con soporte para saltar el bloqueo de orientación

Guía

Tutorial sobre Orientación de Pantalla

Usando @capgo/capacitor-orientación-de-pantalla

Interface del plugin de orientación de pantalla de Capacitor.

Instalar

bun add @capgo/capacitor-screen-orientation
bunx cap sync

¿Qué se expone con este plugin?

  • orientation - Obtener la orientación de pantalla actual.
  • lock - Bloquear la orientación de pantalla a un tipo específico.
  • unlock - Desbloquear la orientación de pantalla.
  • startOrientationTracking - Iniciar el seguimiento de la orientación del dispositivo utilizando sensores de movimiento.

Ejemplo de uso

orientation

Obtenga la orientación de pantalla actual.

import { ScreenOrientation } from '@capgo/capacitor-screen-orientation';

const result = await ScreenOrientation.orientation();
console.log('Current orientation:', result.type);

lock

Bloquee la orientación de pantalla a un tipo específico.

import { ScreenOrientation } from '@capgo/capacitor-screen-orientation';

// Standard lock
await ScreenOrientation.lock({ orientation: 'landscape' });

// Lock with motion tracking on iOS
await ScreenOrientation.lock({
  orientation: 'portrait',
  bypassOrientationLock: true
});

unlock

Desbloquee la orientación de pantalla.

import { ScreenOrientation } from '@capgo/capacitor-screen-orientation';

await ScreenOrientation.unlock();

startOrientationTracking

Inicie la seguimiento de la orientación del dispositivo utilizando sensores de movimiento.

import { ScreenOrientation } from '@capgo/capacitor-screen-orientation';

await ScreenOrientation.startOrientationTracking({
  bypassOrientationLock: true
});

// Listen for changes
ScreenOrientation.addListener('screenOrientationChange', (result) => {
  console.log('Orientation changed:', result.type);
});

Referencia completa

Siga adelante desde Usando @capgo/capacitor-orientación-de-pantalla

Si está utilizando Usando @capgo/capacitor-orientación-de-pantalla para planificar el comportamiento de medios y interfaces nativas, conectarlo con para los detalles de implementación en @capgo/capacitor-screen-orientation, for the implementation detail in @capgo/capacitor-screen-orientation, para los detalles de implementación en Inicio, Usando @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-live-activities para la capacidad nativa en Usando @capgo/capacitor-live-activities, Actividades en vivo de @capgo/capacitor para los detalles de implementación en Actividades en vivo de @capgo/capacitor, y Usando @capgo/capacitor-video-player para la capacidad nativa en Usando @capgo/capacitor-video-player. for the native capability in Using @capgo/capacitor-video-player.