Orientación de pantalla Plugin Capacitor

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

Interface del plugin de orientación de pantalla Capacitor

Instalar

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

bunx cap sync copia el código nativo del plugin code en tus proyectos nativos. Correlo de nuevo después de cada actualización del plugin.

Importar

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

API en resumen

Ejemplos

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()

Convierta 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()

Start tracking device orientation using motion sensors.

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);
});

stopOrientationTracking()

Stop tracking device orientation using motion sensors.

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

await ScreenOrientation.stopOrientationTracking();

isOrientationLocked()

Check if device orientation lock is currently enabled.

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

// Start motion tracking first
await ScreenOrientation.startOrientationTracking({
  bypassOrientationLock: true
});

// Check lock status
const status = await ScreenOrientation.isOrientationLocked();
if (status.locked) {
  console.log('Orientation lock is ON');
  console.log('Physical:', status.physicalOrientation);
  console.log('UI:', status.uiOrientation);
}

La tabla anterior enumera los 13 métodos básicos. Los ayudantes de escucha y versión, así como el contrato completo de cada método, se documentan en repositorio de GitHub.

Escuche eventos

addListener devuelve un manejador. Llame handle.remove() cuando la pantalla se desmonta, o ScreenOrientation.removeAllListeners() para eliminar todos los oyentes.

Referencia completa

• GitHub repositorio
• Documentación
• Referencia de API

Sigue adelante desde Using @capgo/capacitor-orientación de pantalla

Si estás utilizando Usando @capgo/capacitor-orientación de pantalla para planificar el comportamiento de medios y interfaz nativos, conecta con @capgo/capacitor-orientación de pantalla para los detalles de implementación en @capgo/capacitor-orientación de pantalla Configuración inicial para los detalles de implementación en Configuración inicial Usando @capgo/capacitor-actividades-en-vivo para la capacidad nativa en Usando @capgo/capacitor-actividades-en-vivo @capgo/capacitor-actividades-en-vivo para los detalles de implementación en @capgo/capacitor-actividades-en-vivo, y Usando @capgo/capacitor-reproductor-de-videos para la capacidad nativa en Usando @capgo/capacitor-reproductor-de-videos.