Orientasi Layar Plugin Capacitor

Menggunakan @capgo/capacitor-orientasi-layar

Interface Plugin Orientasi Layar Capacitor

Pasang

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

bunx cap sync menggandakan kode native plugin code ke proyek native Anda. Jalankan lagi setelah setiap pembaruan plugin.

Import

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

Panduan API

Contoh-Contoh

orientation()

Ambil orientasi layar saat ini.

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

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

lock()

Tetapkan orientasi layar ke jenis tertentu.

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

Buka orientasi layar.

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

await ScreenOrientation.unlock();

startOrientationTracking()

Mulai mengikuti orientasi perangkat menggunakan sensor gerakan.

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

Hentikan penginderaan orientasi perangkat menggunakan sensor gerakan.

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

await ScreenOrientation.stopOrientationTracking();

isOrientationLocked()

Buka orientasi layar ke jenis tertentu.

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

Daftar di atas menampilkan 13 metode inti. Bantuan listener dan versi, serta kontrak lengkap dari setiap metode, dapat dilihat di repository GitHub.

Dengarkan event

addListener Periksa apakah penguncian orientasi perangkat sedang diaktifkan. handle.remove() ketika layar dihapus, atau ScreenOrientation.removeAllListeners() untuk menghapus setiap pendengar.

Referensi lengkap

• repository GitHub
• Dokumentasi
• API reference

Teruskan dari Menggunakan @capgo/capacitor-orientasi layar

Jika Anda menggunakan Menggunakan @capgo/capacitor-orientasi layar untuk merencanakan perilaku media dan antarmuka native, hubungkannya dengan @capgo/capacitor-orientasi layar untuk detail implementasi di @capgo/capacitor-orientasi layar, Mulai Menggunakan untuk detail implementasi di Mulai, Menggunakan @capgo/capacitor-aktivitas-hidup untuk kemampuan asli di Menggunakan @capgo/capacitor-aktivitas-hidup, @capgo/capacitor-aktivitas-hidup untuk detail implementasi di @capgo/capacitor-aktivitas-hidup, dan Menggunakan @capgo/capacitor-pemain-video untuk kemampuan asli di Menggunakan @capgo/capacitor-pemain-video.