Passer à la navigation principale
Retour aux plugins
@capgo/capacitor-orientation-écran
Tutoriel
@capgo/capacitor-orientation-écran

Orientation écran

Plugin d'orientation écran avec prise en charge de la mise en pause de la verrouillage d'orientation

Guide

Tutoriel sur l'orientation de l'écran

Tester sur appareil

Téléchargez l'application Capgo, puis scannez le code QR code.

Prévisualisation du lien QR du plugin d'orientation de l'écran code

Utilisation de @capgo/capacitor-orientation-de-l'écran

Capacitor Interface du plugin d'orientation de l'écran

Installer

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

Ce que ce plugin expose

  • orientation - Récupérer l'orientation actuelle de l'écran.
  • lock - Blocquer l'orientation de l'écran sur un type spécifique.
  • unlock - Débloquer l'orientation de l'écran.
  • startOrientationTracking - Démarrer la traçabilité 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

Fixer l'orientation 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ésactiver l'orientation de l'écran.

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

await ScreenOrientation.unlock();

startOrientationTracking

Commencer à suivre 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-de-l'écran

Si vous utilisez L'utilisation de @capgo/capacitor-orientation-de-l'écran pour planifier le comportement des médias et de l'interface natifs, connectez-l’avec @capgo/capacitor-orientation-de-l'écran pour les détails d'implémentation dans @capgo/capacitor-orientation-écran, Prise en main pour les détails d'implémentation dans Prise en main, Utilisation de @capgo/capacitor-activités-en-vivre pour la capacité native dans Utilisation de @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 Utilisation de @capgo/capacitor-joueur-de-videos pour la capacité native dans Utilisation de @capgo/capacitor-joueur-de-videos.