Orientation de l'écran plugin Capacitor

Utilisation de @capgo/capacitor-screen-orientation

L'interface du plugin d'orientation d'écran de Capacitor.

Installer

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

bunx cap sync copie le code natif du plugin dans vos projets natifs. Exécutez-l’à nouveau après chaque mise à jour du plugin.

Importer

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

API en un coup d'œil

Exemples

orientation()

Obtenez la position actuelle de l'écran.

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

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

lock()

Fixez la position de l'écran à un type spécifique.

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

Désactivez la position de l'écran.

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

await ScreenOrientation.unlock();

startOrientationTracking()

Suivez l'orientation du dispositif à l'aide de capteurs de mouvement.

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

Arrêtez de suivre l'orientation du dispositif à l'aide de capteurs de mouvement.

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 table ci-dessus liste les 13 méthodes de base. Les écouteurs et les assistants de version, ainsi que la pleine convention de chaque méthode, sont documentés dans le GitHub dépôt.

Écoutez les événements

addListener retourne un gestionnaire. Appelez handle.remove() lorsque l'écran est démonté, ou ScreenOrientation.removeAllListeners() pour supprimer tous les écouteurs.

Référence complète

• GitHub dépôt
• Documentation
• API référence

Continuez de l'étape précédente : Utilisation de @capgo/capacitor-orientation-écran

Si vous utilisez En utilisant @capgo/capacitor-orientation-écran pour planifier le comportement des médias et de l'interface native, connectez-l’avec @capgo/capacitor-orientation-écran pour les détails d'implémentation dans @capgo/capacitor-orientation-écran, Getting Started pour les détails d'implémentation dans Démarrage, En utilisant @capgo/capacitor-activités-en-vivre pour la capacité native dans En utilisant @capgo/capacitor-activités-en-vivre, @capgo/capacitor-activités-en-vivre pour les détails d'implémentation dans @capgo/capacitor-activités-en-vivre, et En utilisant @capgo/capacitor-joueur-de-videos pour la capacité native dans l'utilisation de @capgo/capacitor-video-player.