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

Orientation d'écran

Plugin d'orientation d'écran avec prise en charge de la mise en cache de l'orientation

Guide

Tutoriel sur l'orientation de l'écran

Tester sur appareil

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

Plugin d'orientation d'écran : lien QR de prévisualisation code

Utilisation de @capgo/capacitor-orientation-écran

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

Installation

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éverrouiller l'orientation de l'écran.
  • startOrientationTracking - Démarrer la 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

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 natives, 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.