メインコンテンツへスキップ
@capgo/capacitor-audio-session メディア オープンソース

オーディオセッション Capacitor プラグイン

バックグラウンド再生、ミキシング、ルーティング制御向けに iOS audio session を設定

インストール

bun add @capgo/capacitor-audio-session bunx cap sync
npm、pnpm、または yarn
  • npm install @capgo/capacitor-audio-session
  • pnpm add @capgo/capacitor-audio-session
  • yarn add @capgo/capacitor-audio-session

ガイド

Capacitor で Audio Session を使う方法

実機でテストする

Capgo アプリをダウンロードして、QR code をスキャンしてください。

Audio Session プラグインのプレビュー QR code

@capgo/capacitor-audio-session の使用

オーディオセッションの出力を取得・制御し、ルート変更や割り込みを監視する iOS 専用プラグイン。

インストール

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

bunx cap sync プラグインのネイティブcodeをネイティブプロジェクトにコピーします。プラグインをアップグレードするたびに再度実行してください。

インポート

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

API の概要

メソッド 説明
currentOutputs 現在アクティブなオーディオ出力ルートを取得します。
overrideOutput 現在のオーディオ出力ルートを上書きします。

例

currentOutputs()

現在アクティブなオーディオ出力ルートを取得します。

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

const result = await AudioSession.currentOutputs();
console.log(result);

overrideOutput()

現在のオーディオ出力ルートを上書きします。

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

const result = await AudioSession.overrideOutput('default');
console.log(result);

イベントをリッスンする

addListener ハンドルを返します。画面がアンマウントされるときに handle.remove() を呼び出してください。

完全なリファレンス

@capgo/capacitor-audio-session の使用から続ける

使用している場合 @capgo/capacitor-audio-session の使用 ネイティブメディアとインターフェースの挙動を計画するには、次と連携させてください @capgo/capacitor-audio-session @capgo/capacitor-audio-session の実装の詳細については、 スタートガイド スタートガイドの実装詳細については、 @capgo/capacitor-live-activities の使用 @capgo/capacitor-live-activities の使用におけるネイティブ機能については、 @capgo/capacitor-live-activities @capgo/capacitor-live-activities の実装の詳細については、 @capgo/capacitor-video-playerの使用方法 「@capgo/capacitor-video-player. の使い方」のネイティブ機能については

よくある質問

Audio Session プラグインの FAQ

Capacitor アプリに Audio Session プラグインをインストールするにはどうすればよいですか?

"bun add @capgo/capacitor-audio-session"(または "npm install @capgo/capacitor-audio-session")を実行した後、"bunx cap sync" を実行して、iOS および Android プロジェクトにネイティブの code を反映させてください。その後、アプリの code から "@capgo/capacitor-audio-session" をインポートします。

@capgo/capacitor-audio-session は React、Vue、Angular で動作しますか?

はい。Audio Session は Capacitor パッケージであるため、Ionic、React、Vue、Angular、Svelte、およびプレーンな JavaScript を含む、Capacitor 内で動作するあらゆる Web フレームワークで使用可能です。

@capgo/capacitor-audio-session はどの Capacitor バージョンをサポートしていますか?

Capgo プラグインは Capacitor のメジャーバージョンに合わせています。使用している Capacitor のメジャーバージョンに一致するプラグインのメジャーバージョンを使ってください (例: Capacitor 8 ならプラグイン v8)。GitHub の README にある互換性テーブルに、メンテナンス中のバージョンが記載されています。

@capgo/capacitor-audio-session は無料のオープンソースですか?

はい。code のソースコードは GitHub の https://github.com/Cap-go/capacitor-audiosession/ で公開されており、パッケージは npm から無料でインストールできます。バグ報告やプルリクエストをお待ちしています。

App Store の審査なしで、Audio Session を使用している code をアップデートできますか?

プラグインのインストールやアップグレードはネイティブの code を変更するため、新しいストアビルドが必要です。その後は、プラグインを呼び出す JavaScript、HTML、CSS の変更を Capgo Live Updates で即座に配信できます。

アプリの審査を待たずに Audio Session の変更をリリース

プラグインをストア用ビルドに組み込めば、Capgo live updates で JavaScript、HTML、CSS の変更を数分でユーザーに配信できます

Capgo から始める