주요 콘텐츠로 건너뛰기
@capgo/capacitor-미디어 세션 미디어 오픈 소스

미디어 세션 Capacitor 플러그인

잠금 화면과 알림 센터에서 미디어 재생을 제어합니다.

설치

bun add @capgo/capacitor-media-session bunx cap sync
npm, pnpm 또는 yarn
  • npm install @capgo/capacitor-media-session
  • pnpm add @capgo/capacitor-media-session
  • yarn add @capgo/capacitor-media-session

Guide

How to use Media Session in Capacitor

장치에서 테스트

다운로드 Capgo 앱, 그리고 QR code를 스캔하세요.

미디어 세션 플러그인 미리보기 QR code

@capgo/capacitor-미디어 세션 사용

Capacitor 플러그인을 사용하여 장치의 미디어 세션 제어를 노출합니다.

설치

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

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

수입

import { MediaSession } from '@capgo/capacitor-media-session';

API의 개요

방법 설명
setMetadata 현재 재생 중인 미디어의 메타데이터를 설정합니다.
setPlaybackState 미디어 세션의 재생 상태를 업데이트합니다.
setActionHandler 미디어 세션 액션에 대한 핸들러를 등록합니다.
setPositionState 활성 미디어 세션의 위치 상태를 업데이트합니다.

예시

setMetadata()

현재 재생 중인 미디어의 메타데이터를 설정합니다.

import { MediaSession } from '@capgo/capacitor-media-session';

await MediaSession.setMetadata({ album: 'album' });

setPlaybackState()

미디어 세션의 재생 상태를 업데이트합니다.

import { MediaSession } from '@capgo/capacitor-media-session';

await MediaSession.setPlaybackState({ playbackState: 'none' });

setActionHandler()

미디어 세션 액션에 대한 핸들러를 등록합니다.

import { MediaSession } from '@capgo/capacitor-media-session';

await MediaSession.setActionHandler({ action: 'play' }, (details) => {
  console.log(details);
});

setPositionState()

활성 미디어 세션의 위치 상태를 업데이트합니다.

import { MediaSession } from '@capgo/capacitor-media-session';

await MediaSession.setPositionState({
  duration: 1000,
  playbackRate: 1,
  position: 10,
});

참조

Using @capgo/capacitor-media-session 계속하기

이미 @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-media-session을 사용 중이라면 @capgo/capacitor-미디어 세션 사용 @API/__CAPGO_KEEP_1__-media-session과 연결하여 @capgo/capacitor-media-session의 구현 세부 사항을 참조하세요 for the implementation detail in @capgo/capacitor-media-session, Getting Started의 구현 세부 사항을 참조하세요 __CAPGO_KEEP_0__ 개요 API 개요의 구현 세부 사항을 참조하세요 API 개요 소개 소개에서 구현 세부 정보를 위해 API 키 API 키에서 구현 세부 정보를 위해

자주 묻는 질문

미디어 세션 플러그인 FAQ

Capacitor 앱에 미디어 세션 플러그인을 설치하는 방법은 무엇인가요?

bun add @capgo/capacitor-media-session (또는 npm install @capgo/capacitor-media-session) 명령어를 실행한 후 bunx cap sync 명령어를 실행하여 iOS와 Android 프로젝트가 네이티브 code를 인식하도록 합니다. 그리고 capgo/capacitor-media-session 패키지를 code에서 임포트합니다.

@capgo/capacitor-media-session은 React, Vue 및 Angular와 함께 작동하나요?

네. 미디어 세션은 Capacitor 패키지이므로 Capacitor 내부에서 실행되는 모든 웹 프레임워크와 함께 작동합니다. 예를 들어 Ionic, React, Vue, Angular, Svelte 및 일반 JavaScript도 포함됩니다.

Which Capacitor version does @capgo/capacitor-media-session support?

Capgo plugins follow Capacitor's major version: use the plugin major version that matches your Capacitor major version (for example plugin v8 with Capacitor 8). The compatibility table in the GitHub README lists the maintained versions.

@capgo/capacitor-media-session은 무료이고 오픈 소스인가요?

Yes. The source code is public on GitHub at https://github.com/Cap-go/capacitor-media-session/ and the package is free to install from npm. Bug reports and pull requests are welcome.

미디어 세션을 사용하는 code를 App Store 리뷰 없이 업데이트할 수 있나요?

설치 또는 플러그인 업그레이드는 네이티브 code을 변경하므로 새로운 스토어 빌드를 필요로 합니다. 그 후에 JavaScript, HTML 및 CSS 변경 사항이 플러그인을 호출하는 경우 Capgo 라이브 업데이트와 함께 즉시 배포할 수 있습니다.

앱 리뷰 기다리지 않고 미디어 세션 변경을 배포하세요

플러그인이 스토어 빌드에 포함된 후, Capgo 라이브 업데이트는 사용자에게 몇 분 만에 자바스크립트, HTML 및 CSS 변경을 푸시합니다.

Capgo