Orientamento schermo Plugin Capacitor

Utilizza @capgo/capacitor-orientamento dello schermo

Interfaccia del plugin di orientamento dello schermo Capacitor

Installa

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

bunx cap sync copia il code nativo del plugin nei tuoi progetti nativi. Esegui nuovamente dopo ogni aggiornamento del plugin.

Importa

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

API in un colpo solo

Esempi

orientation()

Ottieni l'orientamento della schermata corrente.

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

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

lock()

Imposta l'orientamento della schermata su un tipo specifico.

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

Rilascia l'orientamento della schermata.

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

Verifica se l'orientamento della schermata è attualmente abilitato.

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

I metodi principali sono elencati nella tabella sopra. I listener e gli aiuti per la versione, nonché il contratto completo di ogni metodo, sono documentati nella repository GitHub.

Ascolta gli eventi

addListener ritorna un handle. Chiama handle.remove() quando lo schermo viene smontato, o ScreenOrientation.removeAllListeners() per cancellare ogni ascoltatore.

Riferimento completo

• GitHub repository
• Documentazione
• riferimento API

Continua da Utilizzo di @capgo/capacitor-screen-orientation

Se stai utilizzando Utilizzo di @capgo/capacitor-screen-orientation per pianificare il comportamento dei media e dell'interfaccia nativi, connettilo con @capgo/capacitor-screen-orientation per i dettagli di implementazione in @capgo/capacitor-screen-orientation Getting Started per i dettagli di implementazione in Avvio, Usando @capgo/capacitor-attività in tempo reale per la capacità nativa in Utilizzo di @capgo/capacitor-live-attivitàs. @capgo/capacitor-attività in tempo reale per i dettagli di implementazione in @capgo/capacitor-live-attività Usando @capgo/capacitor-player-video Per la capacità nativa in Utilizzo di @capgo/capacitor-video-player.