メインコンテンツへスキップ

@capgo/capacitor-audio-recorder

iOS、Android、Webで音声クリップを録音。一時停止、レベルメーター、ネイティブファイル出力に対応。

使用する @capgo/capacitor-audio-recorder プラットフォームごとに別のネイティブモジュールを追加することなく、Capacitor アプリでマイクキャプチャを行いたいときに最適です。クリップの開始・停止、録音途中の一時停止、波形用の入力レベル取得、フォアグラウンドとバックグラウンドを行き来する間の録音エラー監視(適切なネイティブのエンタイトルメントが必要)に対応します。

主なユースケース:ボイスメモ、アプリ内音声メッセージ、フィールドノート、軽量なポッドキャスト録音、モバイルWebViewやモバイルブラウザで動作する必要がある音声ファースト機能など。

プラットフォームサポート備考
iOSとはいAVFoundation キャプチャ(オプション) resetToPlaybackOnStop 録音後の再生音が小さくなるのを防ぐため
AndroidでははいMediaRecorder、API 24+ で一時停止または再開
Webはいブラウザ MediaRecorder, stopRecording を返します Blob ファイルURIの代わりに
  • startRecording - デバイスのマイクを使用して音声録音を開始します。
  • pauseRecording - 進行中の録音を一時停止します。Android (API 24+)、iOS、Web でのみ利用可能です。
  • resumeRecording - 一時停止していた録音を再開します。
  • stopRecording - 現在の録音を停止し、録音したオーディオを保存します。
メソッド説明
startRecordingデバイスのマイクを使用して録音を開始します。
pauseRecording進行中の録音を一時停止します。Android(API 24+)、iOS、Web でのみ利用できます。
resumeRecording一時停止していた録音を再開します。
stopRecording現在の録音を停止し、録音したオーディオを保存します。
cancelRecording現在の録音をキャンセルし、キャプチャしたオーディオを破棄します。
getRecordingStatus現在の録音ステータスを取得します。
getCurrentAmplitude現在の入力振幅(マイクレベル)を正規化された数値として取得します。 [0, 1] 範囲。
checkPermissionsマイクへのアクセス権限の現在の状態を返します。
requestPermissionsマイクへのアクセス権限をリクエストします。
addListener録音エラーをリッスンします。
addListener録音の一時停止時に発行される pause イベントをリッスンします。
addListener録音完了イベントをリッスンします。
removeAllListeners登録されているすべてのリスナーを削除します。
getPluginVersionネイティブの Capacitor プラグインのバージョンを取得します。

このリファレンスは以下から同期されています: src/definitions.ts における capacitor-audio-recorder.

@capgo/capacitor-audio-recorderから続ける

セクション「@capgo/capacitor-audio-recorderから続ける」

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