Getting Started

설치 단계와 이 플러그인의 전체 마크다운 가이드를 포함한 설정 프롬프트를 복사하세요.

        Set up this Capacitor plugin in the project.

Use the package manager already used by the project.
Install these package(s): `@capgo/capacitor-audio-session`, `@capgo/capacitor-audiosession`
Run the required Capacitor sync/update step after installation.
Read this markdown guide for the full setup steps: https://raw.githubusercontent.com/Cap-go/website/refs/heads/main/apps/docs/src/content/docs/docs/plugins/audiosession/getting-started.mdx
Use that guide for platform-specific steps, native file edits, permissions, config changes, imports, and usage setup.
If that guide references other docs pages, read them too.

설치

Capgo의 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-audio-session` plugin in my project.

만약 Manual Setup을 선호한다면, 플러그인을 설치하기 위해 다음 명령어를 실행하고 아래의 플랫폼별 지침을 따르세요.

bun add @capgo/capacitor-audio-session
bunx cap sync

Import

import { AudioSession } from '@capgo/capacitor-audio-session';

API 개요

`currentOutputs`

현재 활성 오디오 출력 경로를 가져옵니다.

웹 및 iOS가 아닌 플랫폼에서 이 값은 빈 배열로 반환됩니다.

import { AudioSession } from '@capgo/capacitor-audio-session';

await AudioSession.currentOutputs();

`overrideOutput`

현재 오디오 출력 경로를 오버라이드합니다.

Use speaker built-in 스피커를 통해 재생을 강제로 하거나 default __CAPGO_KEEP_0__을 시스템으로부터 선택한 경로로 복원합니다.

import { AudioSession } from '@capgo/capacitor-audio-session';

await AudioSession.overrideOutput({} as OutputOverrideType);

타입 참조

`AudioSessionPorts`

iOS에서 사용 가능한 오디오 출력 경로.

export enum AudioSessionPorts {
  AIR_PLAY = 'airplay',
  BLUETOOTH_LE = 'bluetooth-le',
  BLUETOOTH_HFP = 'bluetooth-hfp',
  BLUETOOTH_A2DP = 'bluetooth-a2dp',
  BUILT_IN_SPEAKER = 'builtin-speaker',
  BUILT_IN_RECEIVER = 'builtin-receiver',
  HDMI = 'hdmi',
  HEADPHONES = 'headphones',
  LINE_OUT = 'line-out',
}

`OutputOverrideType`

출력 오버라이드 유형. default시스템으로부터 선택한 경로를 사용합니다. speaker강제로 내장 스피커를 통해 재생합니다.

export type OutputOverrideType = 'default' | 'speaker';

`OverrideResult`

출력 오버라이드 요청의 결과입니다.

export type OverrideResult = {
  success: boolean;
  message: string;
};

`RouteChangeListener`

음성 경로가 변경될 때 호출되는 리스너입니다.

export type RouteChangeListener = (reason: RouteChangeReasons) => void;

`InterruptionListener`

음성 세션이 중단되거나 끝날 때 호출되는 리스너입니다.

export type InterruptionListener = (type: InterruptionTypes) => void;

`RouteChangeReasons`

export enum RouteChangeReasons {
  NEW_DEVICE_AVAILABLE = 'new-device-available',
  OLD_DEVICE_UNAVAILABLE = 'old-device-unavailable',
  CATEGORY_CHANGE = 'category-change',
  OVERRIDE = 'override',
  WAKE_FROM_SLEEP = 'wake-from-sleep',
  NO_SUITABLE_ROUTE_FOR_CATEGORY = 'no-suitable-route-for-category',
  ROUTE_CONFIGURATION_CHANGE = 'route-config-change',
  UNKNOWN = 'unknown',
}

`InterruptionTypes`

export enum InterruptionTypes {
  BEGAN = 'began',
  ENDED = 'ended',
}

실질적인 진실

이 페이지는 플러그인의 src/definitions.ts공개 API이 업스트림에서 변경될 때 다시 싱크를 실행하세요.

Getting Started

Getting Started native 미디어 및 인터페이스 동작을 계획하고 있다면 Using @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-audio-session Using @capgo/capacitor-audio-session for the native capability in Using @capgo/capacitor-audio-session, Using @capgo/capacitor-live-activities native 기능을 위해 @capgo/capacitor-live-activities를 사용합니다. @capgo/capacitor-live-activities @capgo/capacitor-live-activities의 구현 세부 정보를 위해 Using @capgo/capacitor-video-player native 기능을 위해 @capgo/capacitor-video-player를 사용합니다. 그리고 @capgo/capacitor-video-player @capgo/capacitor-video-player의 구현 세부 정보를 위해