コンテンツにスキップ

Getting Started

GitHub

インストール

Install

AI-Assisted Setupを使用してプラグインをインストールすることができます。AIツールにCapgoスキルを追加するには、以下のコマンドを実行してください。

Terminal画面
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-audio-recorder` plugin in my project.

Manual Setupを使用する場合は、以下のコマンドを実行してプラグインをインストールし、以下のプラットフォーム固有の指示に従ってください。

Terminal画面
bun add @capgo/capacitor-audio-recorder
bunx cap sync

Import

Import
import { CapacitorAudioRecorder } from '@capgo/capacitor-audio-recorder';

API 在给一个回算的给果为屿生的简三中文给果为屿生的简三

Section titled “API Overview”

帮一给果的回算四常用给果的回算四常用给果的回算四

import { CapacitorAudioRecorder } from '@capgo/capacitor-audio-recorder';
await CapacitorAudioRecorder.startRecording();

Pause the ongoing recording. Only available on Android (API 24+), iOS, and Web.

import { CapacitorAudioRecorder } from '@capgo/capacitor-audio-recorder';
await CapacitorAudioRecorder.pauseRecording();

回算的给果为屿生的简三中文给果为屿生的简三

import { CapacitorAudioRecorder } from '@capgo/capacitor-audio-recorder';
await CapacitorAudioRecorder.resumeRecording();

現在の録音を停止し、記録した音声を保存します。

import { CapacitorAudioRecorder } from '@capgo/capacitor-audio-recorder';
await CapacitorAudioRecorder.stopRecording();

現在の録音をキャンセルし、記録した音声を破棄します。

import { CapacitorAudioRecorder } from '@capgo/capacitor-audio-recorder';
await CapacitorAudioRecorder.cancelRecording();

現在の録音の状態を取得します。

import { CapacitorAudioRecorder } from '@capgo/capacitor-audio-recorder';
await CapacitorAudioRecorder.getRecordingStatus();

マイクの入力レベルを、0 から 1 の範囲で表した正規化された数値で取得します。 [0, 1] 録音中にライブビジュアライゼーションとしてVUメーターまたは波形を表示するために使用します。

戻り値 0 __CAPGO_KEEP_0__の録音が有効になっていない場合に使用します。 UIレートポーリング用に設計されています — 60–100 msの間隔は、波形の良い出発点です。 それを緊急ループ内で呼び出すのを避けます;各呼び出しはJS/ネイティブ橋を渡ります。

import { CapacitorAudioRecorder } from '@capgo/capacitor-audio-recorder';
await CapacitorAudioRecorder.getCurrentAmplitude();

マイクへのアクセスを許可するために現在の許可状態を返します。

import { CapacitorAudioRecorder } from '@capgo/capacitor-audio-recorder';
await CapacitorAudioRecorder.checkPermissions();

マイクへのアクセスを許可するために許可を求めます。

import { CapacitorAudioRecorder } from '@capgo/capacitor-audio-recorder';
await CapacitorAudioRecorder.requestPermissions();

.に渡されるオプション

export interface StartRecordingOptions {
/**
* The audio session category options for recording. Only available on iOS.
*
* @since 1.0.0
*/
audioSessionCategoryOptions?: AudioSessionCategoryOption[];
/**
* The audio session mode for recording. Only available on iOS.
*
* @since 1.0.0
*/
audioSessionMode?: AudioSessionMode;
/**
* The audio bit rate in bytes per second.
* Only available on Android and iOS.
*
* @since 1.0.0
*/
bitRate?: number;
/**
* The audio sample rate in Hz.
* Only available on Android and iOS.
*
* @since 1.0.0
*/
sampleRate?: number;
}

. から返される結果

export interface StopRecordingResult {
/**
* The recorded audio as a Blob. Only available on Web.
*
* @since 1.0.0
*/
blob?: Blob;
/**
* The duration of the recording in milliseconds.
*
* @since 1.0.0
*/
duration?: number;
/**
* The URI pointing to the recorded file. Only available on Android and iOS.
*
* @since 1.0.0
*/
uri?: string;
}

. から返される結果

export interface GetRecordingStatusResult {
/**
* The current recording status.
*
* @since 1.0.0
*/
status: RecordingStatus;
}

. から返される結果

export interface GetCurrentAmplitudeResult {
/**
* The current input amplitude normalized to the `[0, 1]` range, where `0`
* represents silence and `1` represents the maximum level the platform can
* report. The value is `0` when no recording is active.
*
* Note: the source signal differs between platforms — Android reports the
* peak sample amplitude since the last call, iOS reports the average power
* in dB converted to linear, and Web reports the RMS of the latest frame.
* Consumers that need cross-platform parity may want to apply a
* per-platform scaling curve.
*
* @since 8.1.0
*/
value: number;
}

および から返される許可情報

export interface PermissionStatus {
/**
* The permission state for audio recording.
*
* @since 1.0.0
*/
recordAudio: PermissionState;
}

レコーディング中にエラーが発生したときに発行されるイベント。

export interface RecordingErrorEvent {
/**
* The error message.
*
* @since 1.0.0
*/
message: string;
}

レコーディングが完了したときに発行されるイベント。

export type RecordingStoppedEvent = StopRecordingResult;

iOSで利用可能なオーディオセッションカテゴリオプション。

export enum AudioSessionCategoryOption {
AllowAirPlay = 'ALLOW_AIR_PLAY',
AllowBluetooth = 'ALLOW_BLUETOOTH',
AllowBluetoothA2DP = 'ALLOW_BLUETOOTH_A2DP',
DefaultToSpeaker = 'DEFAULT_TO_SPEAKER',
DuckOthers = 'DUCK_OTHERS',
InterruptSpokenAudioAndMixWithOthers = 'INTERRUPT_SPOKEN_AUDIO_AND_MIX_WITH_OTHERS',
MixWithOthers = 'MIX_WITH_OTHERS',
OverrideMutedMicrophoneInterruption = 'OVERRIDE_MUTED_MICROPHONE_INTERRUPTION',
}

iOSで利用可能なオーディオセッションモード。

export enum AudioSessionMode {
Default = 'DEFAULT',
GameChat = 'GAME_CHAT',
Measurement = 'MEASUREMENT',
SpokenAudio = 'SPOKEN_AUDIO',
VideoChat = 'VIDEO_CHAT',
VideoRecording = 'VIDEO_RECORDING',
VoiceChat = 'VOICE_CHAT',
}

レコーディングのステータス

export enum RecordingStatus {
Inactive = 'INACTIVE',
Recording = 'RECORDING',
Paused = 'PAUSED',
}

Capacitorでサポートされるプラットフォームパーミッションの状態

export type PermissionState = 'prompt' | 'prompt-with-rationale' | 'granted' | 'denied';

このページはプラグインの src/definitions.tsAPIの公開バージョンがアップストリームで変更された場合に再度Syncを実行してください

Getting Startedから続けてください

「Getting Started」から続けて」

あなたが「Getting Started」を使用している場合 Getting Started native mediaとinterface behaviorを計画するには、__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-audio-recorderと接続する native capabilityのcapgo/capacitor-audio-recorderの使用 native capabilityのcapgo/capacitor-live-activitiesの使用 native capabilityのcapgo/capacitor-live-activities native capabilityのcapgo/capacitor-live-activitiesの実装詳細 native capabilityのcapgo/capacitor-video-playerの使用 native capabilityのcapgo/capacitor-video-playerの使用 native capabilityのcapgo/capacitor-video-playerの実装詳細 native capabilityのcapgo/capacitor-video-playerの実装詳細 @capgo/capacitor-video-player @capgo/capacitor-video-player