@capgo/capacitor-brightness 사용하기
iOS 및 Android에서 화면 밝기를 제어합니다.
설치
bun add @capgo/capacitor-brightness
bunx cap sync
bunx cap sync 플러그인의 네이티브 code를 네이티브 프로젝트에 복사합니다. 플러그인을 업그레이드할 때마다 다시 실행하세요.
가져오기
import { CapgoBrightness } from '@capgo/capacitor-brightness';
API 한눈에 보기
| 메서드 | 설명 |
|---|---|
getBrightness |
기기 메인 화면의 현재 밝기 값을 가져옵니다. |
setBrightness |
기기 메인 화면의 밝기 값을 설정합니다. |
getSystemBrightness |
시스템 전체 화면 밝기를 가져옵니다. |
setSystemBrightness |
시스템 전체 화면 밝기를 설정합니다. Android에서는 WRITE_SETTINGS 권한이 필요하며, 밝기 모드가 MANUAL로 변경됩니다. |
getSystemBrightnessMode |
현재 시스템 밝기 모드(자동 또는 수동)를 가져옵니다. Android에서는 WRITE_SETTINGS 권한이 필요합니다. |
setSystemBrightnessMode |
시스템 밝기 모드(자동 또는 수동)를 설정합니다. Android에서는 WRITE_SETTINGS 권한이 필요합니다. |
isUsingSystemBrightness |
현재 액티비티가 시스템 전체 밝기 값을 사용 중인지 확인합니다. |
restoreSystemBrightness |
현재 액티비티의 밝기 설정을 시스템 전체 값 사용으로 초기화합니다. |
isAvailable |
현재 기기에서 Brightness API 사용이 가능한지 확인합니다. |
checkPermissions |
시스템 밝기 접근에 대한 사용자 권한을 확인합니다. |
requestPermissions |
시스템 밝기 접근 권한을 요청합니다. Android의 경우 WRITE_SETTINGS 권한을 부여할 수 있도록 시스템 설정 화면을 엽니다. |
예시
getBrightness()
기기 메인 화면의 현재 밝기 값을 가져옵니다.
import { CapgoBrightness } from '@capgo/capacitor-brightness';
const result = await CapgoBrightness.getBrightness();
console.log(result);
setBrightness()
기기 메인 화면의 밝기 값을 설정합니다.
import { CapgoBrightness } from '@capgo/capacitor-brightness';
await CapgoBrightness.setBrightness({ brightness: 0.5 });
getSystemBrightness()
시스템 전체 화면 밝기를 가져옵니다.
import { CapgoBrightness } from '@capgo/capacitor-brightness';
const result = await CapgoBrightness.getSystemBrightness();
console.log(result);
setSystemBrightness()
시스템 전체 화면 밝기를 설정합니다. Android에서는 WRITE_SETTINGS 권한이 필요하며, 밝기 모드가 MANUAL로 변경됩니다.
import { CapgoBrightness } from '@capgo/capacitor-brightness';
await CapgoBrightness.setSystemBrightness({ brightness: 0.5 });
getSystemBrightnessMode()
현재 시스템 밝기 모드(자동 또는 수동)를 가져옵니다. Android에서는 WRITE_SETTINGS 권한이 필요합니다.
import { CapgoBrightness } from '@capgo/capacitor-brightness';
const result = await CapgoBrightness.getSystemBrightnessMode();
console.log(result);
setSystemBrightnessMode()
시스템 밝기 모드(자동 또는 수동)를 설정합니다. Android에서는 WRITE_SETTINGS 권한이 필요합니다.
import { CapgoBrightness, BrightnessMode } from '@capgo/capacitor-brightness';
await CapgoBrightness.setSystemBrightnessMode({ mode: BrightnessMode.AUTOMATIC });
위 표에는 11개의 핵심 메서드가 나열되어 있습니다. Listener 및 버전 헬퍼, 각 메서드의 전체 계약 내용은 GitHub 리포지토리.
전체 레퍼런스
@capgo/capacitor-brightness 사용법 계속 보기
사용 중이라면 @capgo/capacitor-brightness 사용하기 네이티브 미디어 및 인터페이스 동작을 계획하려면, 이를 다음 항목과 연결하세요: @capgo/capacitor-brightness @capgo/capacitor-brightness의 구현 세부 사항은 시작하기 Getting Started의 구현 상세 내용은 @capgo/capacitor-live-activities 사용 @capgo/capacitor-live-activities 사용에서의 네이티브 기능, @capgo/capacitor-live-activities @capgo/capacitor-live-activities의 구현 세부 사항은, 그리고 @capgo/capacitor-video-player 사용 @capgo/capacitor-video-player. 사용하기에서의 네이티브 기능은