알람 Capacitor 플러그인

@capgo/capacitor-alarm 사용하기

네이티브 OS 알람 관리를 위한 Capacitor Alarm Plugin 인터페이스

설치

bun add @capgo/capacitor-alarm
bunx cap sync

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

가져오기

import { CapgoAlarm } from '@capgo/capacitor-alarm';

API 한눈에 보기

예시

createAlarm()

플랫폼 시계 앱을 사용하여 네이티브 OS 알람을 생성합니다. Android에서는 Alarm Clock intent를 사용하며, iOS에서는 사용 가능한 경우(iOS 16+) AlarmKit을 사용합니다.

import { CapgoAlarm } from '@capgo/capacitor-alarm';

const result = await CapgoAlarm.createAlarm({
  hour: 7,
  minute: 30,
  label: 'Wake up',
  skipUi: false,
  vibrate: true
});
console.log('Alarm created:', result.success);

openAlarms()

사용 가능한 경우 플랫폼의 네이티브 알람 목록 UI를 엽니다.

import { CapgoAlarm } from '@capgo/capacitor-alarm';

const result = await CapgoAlarm.openAlarms();
if (result.success) {
  console.log('Alarms UI opened');
}

getOSInfo()

OS 및 기능에 대한 정보를 가져옵니다.

import { CapgoAlarm } from '@capgo/capacitor-alarm';

const info = await CapgoAlarm.getOSInfo();
console.log('Platform:', info.platform);
console.log('Supports native alarms:', info.supportsNativeAlarms);
if (info.platform === 'android') {
  console.log('Can schedule exact alarms:', info.canScheduleExactAlarms);
}

requestPermissions()

플랫폼에서 알람 사용에 필요한 권한을 요청합니다. Android의 경우 정확한 알람 설정을 위해 설정 화면으로 이동할 수 있습니다.

import { CapgoAlarm } from '@capgo/capacitor-alarm';

const result = await CapgoAlarm.requestPermissions({ exactAlarm: true });
if (result.granted) {
  console.log('Permissions granted');
} else {
  console.log('Permissions denied');
}

checkPermissions()

UI를 띄우지 않고 네이티브 알람 접근에 대한 현재 권한 상태를 확인합니다. iOS에서는 AlarmKit 준비 상태를, Android에서는 기능 상세 정보를 보고합니다.

import { CapgoAlarm } from '@capgo/capacitor-alarm';

const status = await CapgoAlarm.checkPermissions();
console.log('AlarmKit allowed?', status.details?.alarmKit);

getAlarms()

이 앱이 예약한 알람 목록을 가져옵니다. iOS 16+에서는 AlarmKit의 알람을 반환합니다. Android는 시스템에서 알람 조회를 위한 API를 제공하지 않으므로 지원되지 않습니다.

import { CapgoAlarm } from '@capgo/capacitor-alarm';

const { alarms } = await CapgoAlarm.getAlarms();
console.log('Scheduled alarms:', alarms);
alarms.forEach(alarm => {
  console.log(`Alarm ${alarm.id}: ${alarm.hour}:${alarm.minute} - ${alarm.label}`);
});

위 표에는 7가지 핵심 메서드가 나열되어 있습니다. Listener 및 버전 헬퍼, 각 메서드의 전체 계약(contract)은 다음 문서에 설명되어 있습니다. GitHub 리포지토리.

전체 레퍼런스

• GitHub 리포지토리
• 문서
• API 레퍼런스

@capgo/capacitor-alarm 사용법 계속 보기

사용 중이라면 @capgo/capacitor-alarm 사용하기 네이티브 플러그인 작업을 계획하려면, 이를 다음 항목과 연결하세요: @capgo/capacitor-alarm @capgo/capacitor-alarm의 구현 세부 사항은 시작하기 Getting Started의 구현 상세 내용은 Capgo 플러그인 디렉토리 Capgo Plugin Directory의 제품 워크플로우에 맞춰, Capgo의 Capacitor 플러그인 Capgo의 Capacitor Plugins 구현 세부 사항 및 플러그인 추가 또는 업데이트 플러그인 추가 또는 업데이트의 구현 세부 사항은.