시작하기

설치

AI-Assisted Setup으로 플러그인을 설치할 수 있습니다. 다음 명령어로 AI 도구에 Capgo 스킬을 추가하세요:

npx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-plugins

그런 다음 아래 프롬프트를 사용하세요:

Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capgo/capacitor-mute` plugin in my project.

수동 설정을 선호한다면, 다음 명령어를 실행하여 플러그인을 설치하고 아래의 플랫폼별 지침을 따르세요:

bun add @capgo/capacitor-mute
bunx cap sync

가져오기

import { Mute } from '@capgo/capacitor-mute';

빠른 시작

import { Mute } from '@capgo/capacitor-mute';

const { value } = await Mute.isMuted();
if (value) {
  showVisualAlert();
} else {
  await playNotificationSound();
}

예시: 게임 속 게이트 사운드

하드웨어 스위치는 앱 이벤트 없이도 상태가 바뀔 수 있으므로, 레벨에 진입할 때나 사용자가 Control Center에서 돌아올 때 mute 상태를 폴링하세요.

자주 하는 실수

• 웹 지원 없음: Capacitor 웹 빌드를 보호합니다. Capacitor.getPlatform() === 'web'.
• 볼륨 아님: mute는 벨소리나 하드웨어 무음 상태를 반영하며, 미디어 볼륨 슬라이더와는 다릅니다.
• Android 모드: 진동 모드나 무음 모드도 알림음 기준으로는 muted 상태로 간주됩니다.

API 개요

isMuted

기기의 무음 스위치가 켜져 있는지 확인합니다.

import { Mute } from '@capgo/capacitor-mute';

const { value } = await Mute.isMuted();
if (value) {
  console.log('Device is muted');
} else {
  console.log('Device is not muted');
}

타입 레퍼런스

MuteResponse

음소거 상태 확인 응답.

export interface MuteResponse {
  /** True if device is muted, false otherwise */
  value: boolean;
}

Source of Truth

이 페이지는 플러그인의 src/definitions.tsupstream에서 public API가 변경되면 sync를 다시 실행하세요.

시작하기 다음 단계

사용 중이라면 시작하기 대시보드 및 API 운영을 계획하려면, 이를 다음과 연결하세요 @capgo/capacitor-mute 사용 중 @capgo/capacitor-mute를 사용하여 네이티브 기능을 구현하려면, API 개요 구현 세부 사항은 API 개요에서 소개 구현 세부 사항은 소개에서 API 키 API Keys의 구현 세부 사항은, 기기 Devices의 구현 세부 사항은.