Passer au contenu principal
Retour aux plugins
@capgo/capacitor-orientation-écran
Tutoriel
@capgo/capacitor-orientation-écran

Orientation écran

Plugin d'orientation d'écran avec prise en charge de la contournement du verrouillage d'orientation

Guide

Tutoriel sur l'orientation d'écran

Utilisation de @capgo/capacitor-orientation-écran

Interface du plugin d'orientation d'écran Capacitor.

Installation

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

Ce plugin expose les éléments suivants :

  • orientation - Récupérer l'orientation actuelle de l'écran.
  • lock - Blocage de l'orientation de l'écran sur un type spécifique.
  • unlock - Déverrouillage de l'orientation de l'écran.
  • startOrientationTracking - Démarrage du suivi de l'orientation du dispositif à l'aide de capteurs de mouvement.

Exemple d'utilisation

orientation

Récupérer l'orientation actuelle de l'écran.

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

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

lock

Blocage de l'orientation de l'écran sur 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éverrouillage de l'orientation de l'écran.

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

await ScreenOrientation.unlock();

startOrientationTracking

Démarrage du suivi de 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);
});

Référence complète

Continuez à partir de l'utilisation de @capgo/capacitor-orientation-écran

Si vous utilisez L'utilisation de @capgo/capacitor-orientation-écran pour planifier le comportement de médias et d'interface natifs, connectez-le avec @capgo/capacitor-orientation-écran pour les détails d'implémentation dans @capgo/capacitor-orientation-écran, Démarrage pour les détails d'implémentation dans Démarrage, L'utilisation de @capgo/capacitor-activités-en-vivre pour la capacité native dans l'utilisation de @capgo/capacitor-activités en direct, @capgo/capacitor-activités en direct pour le détail d'implémentation dans @capgo/capacitor-activités en direct, et L'utilisation de @capgo/capacitor-joueur de vidéo pour la capacité native dans l'utilisation de @capgo/capacitor-joueur de vidéo.