시작하기
이 플러그인의 설치 단계와 전체 마크다운 가이드가 포함된 설정 프롬프트를 복사하세요.
Set up this Capacitor plugin in the project.
Use the package manager already used by the project.
Install these package(s): `@capgo/capacitor-media-session`
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/media-session/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.
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-media-session` plugin in my project.수동 설정을 선호한다면, 다음 명령어를 실행하여 플러그인을 설치하고 아래의 플랫폼별 지침을 따르세요:
bun add @capgo/capacitor-media-sessionbunx cap sync가져오기
“Import” 섹션import { MediaSession } from '@capgo/capacitor-media-session';빠른 시작
“빠른 시작” 섹션플레이어가 시작될 때 메타데이터와 재생 상태를 게시합니다.
import { MediaSession } from '@capgo/capacitor-media-session';
await MediaSession.setMetadata({ title: 'Episode 12', artist: 'Capgo Podcast', album: 'Ship faster', artwork: [{ src: 'https://cdn.example.com/artwork.png', sizes: '512x512', type: 'image/png' }],});
await MediaSession.setPlaybackState({ playbackState: 'playing' });
await MediaSession.setPositionState({ duration: 3600, position: 120, playbackRate: 1,});예제: 잠금 화면 컨트롤 처리
“예시: 잠금 화면 컨트롤 처리하기” 섹션await MediaSession.setActionHandler({ action: 'play' }, () => { audio.play();});
await MediaSession.setActionHandler({ action: 'pause' }, () => { audio.pause();});
await MediaSession.setActionHandler({ action: 'seekto' }, (details) => { if (details.seekTime != null) { audio.currentTime = details.seekTime; }});전달하세요: null 액션 등록을 해제하기 위한 핸들러로
예제: 버퍼링 중 일시정지 상태
“예시: 버퍼링 중 일시정지 상태” 섹션await MediaSession.setPlaybackState({ playbackState: 'paused' });// resume with 'playing' when your buffer is ready자주 하는 실수
“흔한 실수” 섹션- 재생 위치 최신 상태 유지: 호출
setPositionState재생이 진행되거나 스크러빙할 때 Android에서 동작이 끊기는 것처럼 느껴질 수 있습니다. - 아트워크 URL: 기기에서 접근 가능한 HTTPS 에셋을 사용하세요. 이미지가 너무 크면 잠금 화면 업데이트가 느려집니다.
- 핸들러 생명주기: 핸들러는 트랙이 바뀔 때마다 등록하지 말고, 플레이어 설정 시 한 번만 등록하세요.
API 개요
“API 개요” 섹션setMetadata
“setMetadata” 섹션현재 재생 중인 미디어의 메타데이터를 설정합니다.
import { MediaSession } from '@capgo/capacitor-media-session';
await MediaSession.setMetadata({ album: 'album' });setPlaybackState
“setPlaybackState” 섹션미디어 세션의 재생 상태를 업데이트합니다.
import { MediaSession } from '@capgo/capacitor-media-session';
await MediaSession.setPlaybackState({ playbackState: 'none' });setActionHandler
“setActionHandler” 섹션미디어 세션 액션에 대한 핸들러를 등록합니다.
import { MediaSession } from '@capgo/capacitor-media-session';
await MediaSession.setActionHandler({ action: 'play' }, (details) => { console.log(details);});setPositionState
“setPositionState” 섹션활성화된 미디어 세션의 위치 상태를 업데이트합니다.
import { MediaSession } from '@capgo/capacitor-media-session';
await MediaSession.setPositionState({ duration: 1000, playbackRate: 1, position: 10,});타입 레퍼런스
“타입 참조” 섹션MetadataOptions
“MetadataOptions” 섹션export interface MetadataOptions { album?: string; artist?: string; artwork?: MediaImage[]; title?: string;}PlaybackStateOptions
“PlaybackStateOptions” 섹션export interface PlaybackStateOptions { playbackState: MediaSessionPlaybackState;}ActionHandlerOptions
“ActionHandlerOptions” 섹션export interface ActionHandlerOptions { action: MediaSessionAction;}ActionHandler
“ActionHandler” 섹션export type ActionHandler = (details: ActionDetails) => void;PositionStateOptions
“PositionStateOptions” 섹션export interface PositionStateOptions { duration?: number; playbackRate?: number; position?: number;}MediaImage
“MediaImage” 섹션export interface MediaImage { src: string; sizes?: string; type?: string;}MediaSessionPlaybackState
“MediaSessionPlaybackState” 섹션export type MediaSessionPlaybackState = 'none' | 'paused' | 'playing';MediaSessionAction
“MediaSessionAction” 섹션export type MediaSessionAction = | 'play' | 'pause' | 'seekbackward' | 'seekforward' | 'previoustrack' | 'nexttrack' | 'seekto' | 'stop';Source of Truth
“Source Of Truth” 섹션이 페이지는 플러그인의 src/definitions.tsupstream에서 public API가 변경되면 sync를 다시 실행하세요.
시작하기 다음 단계
“Getting Started에서 계속하기” 섹션사용 중이라면 시작하기 대시보드 및 API 운영을 계획하려면, 이를 다음과 연결하세요 @capgo/capacitor-media-session 사용하기 @capgo/capacitor-media-session 사용 시 네이티브 기능을 위해, API 개요 구현 세부 사항은 API 개요에서 소개 구현 세부 사항은 소개에서 API 키 API Keys의 구현 세부 사항은, 기기 Devices의 구현 세부 사항은.