Orientamento dello schermo Plugin Capacitor

Utilizzo di @capgo/capacitor-screen-orientation

Interfaccia del plugin Screen Orientation per Capacitor.

Installa

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

bunx cap sync copia i code nativi del plugin nei tuoi progetti nativi. Eseguilo di nuovo dopo ogni aggiornamento del plugin.

Importa

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

API in breve

Metodo	Descrizione
orientation	Ottieni l'orientamento attuale dello schermo.
lock	Blocca l'orientamento dello schermo su un tipo specifico.
unlock	Sblocca l'orientamento dello schermo.
startOrientationTracking	Inizia a tracciare l'orientamento del dispositivo tramite i sensori di movimento.
stopOrientationTracking	Stop tracking device orientation using motion sensors.
isOrientationLocked	Controlla se il blocco dell'orientamento del dispositivo è attualmente attivo.
isDeviceFoldable	Ascolta i cambiamenti di orientamento dello schermo.
getFoldState	Leggi la piega attuale.
getHingeAngle	Leggi l'angolo della cerniera in gradi.
getReservedRegions	Leggi la piega e qualsiasi cosa copra lo schermo.
getBarPlacement	Leggi dove iPhone Duo posiziona le tab bar e le toolbar native.
setVerticalBarBehavior	Scegli se iPhone Duo può spostare lateralmente le barre di questa app.
getSizeClass	Leggi le window size classes.

Esempi

orientation()

Ottieni l'orientamento attuale dello schermo.

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

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

lock()

Blocca l'orientamento dello schermo 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()

Sblocca l'orientamento dello schermo.

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

await ScreenOrientation.unlock();

startOrientationTracking()

Inizia a tracciare l'orientamento del dispositivo tramite i sensori di movimento.

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

Controlla se il blocco dell'orientamento del dispositivo è attualmente attivo.

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 tabella sopra elenca i 13 metodi core. I listener e gli helper di versione, insieme al contratto completo di ogni metodo, sono documentati in repository GitHub.

Ascolta gli eventi

addListener restituisce un handle. Chiama handle.remove() quando la schermata viene smontata, o ScreenOrientation.removeAllListeners() per rimuovere tutti i listener.

Riferimento completo

• repository GitHub
• Documentazione
• riferimento API

Continua da Usare @capgo/capacitor-screen-orientation

Se stai usando Utilizzo di @capgo/capacitor-screen-orientation per pianificare il comportamento dei media nativi e dell'interfaccia, collegalo a @capgo/capacitor-screen-orientation per i dettagli di implementazione in @capgo/capacitor-screen-orientation, Per iniziare per i dettagli di implementazione nella guida introduttiva, Uso di @capgo/capacitor-live-activities per la funzionalità nativa nella pagina Uso di @capgo/capacitor-live-activities, @capgo/capacitor-live-activities per i dettagli di implementazione in @capgo/capacitor-live-activities, e Uso di @capgo/capacitor-video-player per la funzionalità nativa in Usare @capgo/capacitor-video-player.