모바일 화면 방향 Capacitor 플러그인

@capgo/capacitor-스크린-오리엔테이션을 사용합니다

Capacitor 모바일 화면 방향 플러그인 인터페이스.

Install

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

bunx cap sync 플러그인의 네이티브 code을 프로젝트에 복사합니다. 플러그인 업그레이드 후 다시 실행하세요.

Import

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

API 한눈에

예시

orientation()

현재 화면 방향을 가져오세요.

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

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

lock()

특정 방향으로 화면 방향을 고정하세요.

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

화면 방향을 해제하세요.

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

await ScreenOrientation.unlock();

startOrientationTracking()

장치 방향 추적을 시작하세요.

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

장치 방향 추적을 중지하세요.

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

await ScreenOrientation.stopOrientationTracking();

isOrientationLocked()

장치 방향 잠금이 현재 활성화되어 있는지 확인하세요.

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

위 표에는 13개의 핵심 메서드가 나열되어 있습니다. 리스너 및 버전 헬퍼, 각 메서드의 전체 계약은 __CAPGO_KEEP_0__ 저장소에서 문서화되어 있습니다. GitHub 저장소.

예시

addListener handle을 반환합니다. Call handle.remove() 화면이 해제될 때 또는 ScreenOrientation.removeAllListeners() 모든 리스너를 지우려면.

전체 참조

• GitHub 저장소
• 문서
• API 참조

@capgo/capacitor-스크린 방향

Using @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-screen-orientation에서 계속 Using @capgo/capacitor-screen-orientation Using @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-screen-orientation @capgo/capacitor-스크린 방향성 Capacitor-capgo-capacitor-__CAPGO_KEEP_2__ 시작하기 Capacitor-__CAPGO_KEEP_0__-__CAPGO_KEEP_1__-__CAPGO_KEEP_2__ Capacitor-capgo-capacitor-__CAPGO_KEEP_2__ Capacitor-capgo-capacitor-__CAPGO_KEEP_2__ Capacitor-capgo-capacitor-__CAPGO_KEEP_2__ Capacitor-capgo-capacitor-__CAPGO_KEEP_2__ Capacitor-capgo-capacitor-__CAPGO_KEEP_2__ Capacitor-capgo-capacitor-__CAPGO_KEEP_2__