게임 및 앱에서 낮은 지연 시간으로 짧은 오디오 파일을 재생하는 데 사용할 수 있는 네이티브 오디오 엔진을 사용하여.
@capgo/capacitor-native-audio 이름이 바뀌었습니다. @capgo/native-audio가 @capgo/capacitor-native-audio로 이름이 바뀌었습니다. 미디어 오픈 소스

자연어 음성 @Capacitor 플러그인

게임과 앱에서 낮은 지연 시간으로 짧은 오디오 파일을 재생하는 데 사용되는 자연어 음성 엔진을 사용하여 오디오 파일을 재생합니다.

설치

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

Guide

Capacitor의 네이티브 오디오 사용 방법

기기에서 테스트

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

네이티브 오디오 플러그인 미리보기 QR code

@capgo/capacitor-native-audio를 사용하세요.

네이티브 오디오 엔진을 위한 네이티브 플러그인입니다.

설치

npm install @capgo/capacitor-native-audio
npx cap sync

이 플러그인이 노출하는 것

  • configure - 오디오 플레이어를 설정하세요.
  • preload - 오디오 파일을 로드하세요.
  • playOnce - 오디오 파일을 자동으로 정리하면서 한 번 재생하세요.
  • isPreloaded - 오디오 파일이 미리 로드되었는지 확인하세요.

예시 사용

configure

- 오디오 플레이어를 설정하세요.

import { NativeAudio } from '@capgo/capacitor-native-audio';

await NativeAudio.configure({
  focus: false,
  background: false,
  ignoreSilent: false,
  showNotification: false,
  backgroundPlayback: false,
});

preload

- 오디오 파일을 로드하세요.

import { NativeAudio } from '@capgo/capacitor-native-audio';

await NativeAudio.preload({
  assetPath: 'path/to/file',
  assetId: 'asset-id-123',
});

playOnce

- 오디오 파일을 자동으로 정리하면서 한 번 재생하세요.

import { NativeAudio } from '@capgo/capacitor-native-audio';

// Simple one-shot playback
await NativeAudio.playOnce({ assetPath: 'audio/notification.mp3' });

// Play and delete the file after completion
await NativeAudio.playOnce({
  assetPath: 'file:///path/to/temp/audio.mp3',
  isUrl: true,
  deleteAfterPlay: true
});

// Get the assetId to control playback
const { assetId } = await NativeAudio.playOnce({
  assetPath: 'audio/long-track.mp3',
  autoPlay: true
});
// Later, you can stop it manually if needed
await NativeAudio.stop({ assetId });

isPreloaded

- 오디오 파일이 미리 로드되었는지 확인하세요.

import { NativeAudio } from '@capgo/capacitor-native-audio';

const result = await NativeAudio.isPreloaded({
  assetPath: 'path/to/file',
  assetId: 'asset-id-123',
});
console.log(result);

전체 참조

이미지 및 인터페이스 동작을 계획하는 데 사용하는 @capgo/capacitor-native-audio를 계속 사용하세요.

이미지 및 인터페이스 동작을 계획하는 데 사용하는 @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-native-audio를 사용하고 있다면 Using @capgo/capacitor-native-audio native 미디어 및 인터페이스 동작을 계획하기 위해 연결하세요 @capgo/capacitor-native-audio Getting Started의 구현 세부 사항을 @capgo/capacitor-native-audio에서 확인하세요. 이미지 및 인터페이스 동작을 계획하는 데 사용하는 @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-live-activities를 사용하세요. 설정 시작에서 구현 세부 정보에 대해. Using @capgo/capacitor-live-activities @capgo/capacitor-live-activities의 구현 세부 사항을 @capgo/capacitor-live-activities에서 확인하세요. @capgo/capacitor-live-activities for @capgo/capacitor-live-activities 구현 세부 사항에 대해, @capgo/capacitor-video-player for @capgo/capacitor-video-player의 네이티브 기능

FAQ

네이티브 오디오 플러그인 FAQ

네이티브 오디오 플러그인을 Capacitor 앱에 어떻게 설치하나요?

Run "bun add @capgo/capacitor-native-audio" (또는 "npm install @capgo/capacitor-native-audio"), 그리고 "bunx cap sync" 명령어를 실행하여 iOS 및 Android 프로젝트가 네이티브 code를 인식하도록 하세요. 그리고 앱 code에서 "@capgo/capacitor-native-audio"를 임포트하세요.

@capgo/capacitor-native-audio는 React, Vue 및 Angular과 함께 작동하나요?

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

어떤 Capacitor 버전이 @capgo/capacitor-native-audio를 지원하나요?

Capgo 플러그인은 Capacitor의 메이저 버전을 따라서, 플러그인 메이저 버전은 Capacitor 메이저 버전과 일치해야 합니다. 예를 들어 플러그인 v8은 Capacitor 8과 일치해야 합니다. GitHub README에서 유지 보수되는 버전을 확인할 수 있습니다.

@capgo/capacitor-native-audio는 무료이며 오픈 소스인가요?

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

code가 Native Audio를 사용하는 경우 App Store 리뷰 없이 업데이트가 가능한가요?

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

네이티브 오디오 변경 사항을 앱 리뷰 기다리지 않고 배포하세요.

플러그인을 스토어 빌드에 추가한 후, Capgo 라이브 업데이트 기능을 사용하여 JavaScript, HTML 및 CSS 변경 사항을 사용자에게 몇 분 내에 푸시합니다.

Capgo로 시작하세요.