Bildschirmorientierung Capacitor-Plugin

Mit @capgo/capacitor-screen-orientation

Capacitor-Bildschirmorientierung-Plugin-Schnittstelle

Installieren

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

bunx cap sync kopiert die native code des Plugins in Ihre native Projekte. Führen Sie es erneut durch, nachdem Sie jedes Plugin aktualisiert haben.

Importieren

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

API im Überblick

Beispiele

orientation()

Werden Sie die aktuelle Bildschirmorientierung.

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

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

lock()

Blockieren Sie die Bildschirmorientierung auf eine bestimmte Art.

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

Entblockieren Sie die Bildschirmorientierung.

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

await ScreenOrientation.unlock();

startOrientationTracking()

Starten Sie die Verfolgung der Geräteorientierung mithilfe von Bewegungssensoren.

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

Beenden Sie die Verfolgung der Geräteorientierung mithilfe von Bewegungssensoren.

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

await ScreenOrientation.stopOrientationTracking();

isOrientationLocked()

Überprüfen Sie, ob die Geräteorientierungssperre derzeit aktiviert ist.

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);
}

Die folgende Tabelle listet die 13 Kernmethoden auf. Helfer für Listener und Versionen sowie die vollständige Vertragsstruktur jeder Methode sind im GitHub-Repository.

__CAPGO_KEEP_0__-Repository

addListener erstellt einen Handle. Aufrufen handle.remove() wenn das Bildschirm-Layout entfernt wird, oder ScreenOrientation.removeAllListeners() um alle Listener zu löschen.

Vollständige Referenz

• GitHub-Repository
• Dokumentation
• API reference

Weitermachen von @capgo/capacitor-Orientierung

Fortsetzen von Using @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-Bildschirmorientierung Verwendung von @capgo/capacitor-Bildschirmorientierung um native Medien- und Benutzeroberflächengedränge zu planen, verbinden Sie es mit @capgo/capacitor-Bildschirmorientierung für die Implementierungsdetails in @capgo/capacitor-Bildschirmorientierung, Getting Started für die Implementierungsdetails in Einstieg, Mit @capgo/capacitor-Live-Aktivitäten für die native Fähigkeit in Mit @capgo/capacitor-Live-Aktivitäten, @capgo/capacitor-Live-Aktivitäten für die Implementierungsdetails in @capgo/capacitor-Live-Aktivitäten und Mit @capgo/capacitor-Video-Player für die native Fähigkeit in Mit @capgo/capacitor-Video-Player.