Xodera Plugins · Bubble Native
Xodera Audio Player Native
レッスン、音声メッセージ、または製品レコードにクリアなオーディオプレーヤーを追加します。ユーザーは再生し、速度を変更し、保存された位置から続けることができます。
Public beta guides · Haptics instructions are in its Bubble listing
Public beta offer: free Bubble install · 7-day card trial, then US$1.50/month per plugin/project.
ドキュメント確認日：2026年11月6日
実用的な例
サポート会話内の音声メモ
プレーンなファイルリンクは会話からユーザーを離脱させ、長い返信をレビューしにくくします。
`source_url = Selected Message’s audio URL`; `title = Selected Message’s sender label`; `subtitle = Selected Message’s timestamp`.
プレーヤーを選択されたメッセージの詳細に配置します。ユーザーが Play/Pause、Seek を有用な位置にし、Set speed できるようにします。`is_active` を開いている会話にバインドします。
進捗を表示するために `is_playing`、`current_time`、`duration` を使用します。遅延イベントが別の会話を更新できないように、アプリ内で Message ID を保持してください。
`player_error` が発生した際、`error_code` を表示し、Reload source を提供します。メッセージを保持し、エラー後に「聞いた」とマークしないでください。
再生のみ。アプリは再生位置を保存します。
保存された位置から言語レッスンを再開します。
学習者はレッスン全体をやり直すのではなく、難しい箇所を再生する必要があります。
`source_url = Current Lesson’s audio URL`; `title = Current Lesson’s name`; 最後の位置はデータベース内のその学習者とレッスンに属します。
現在のレッスンで`ready`した後、Seekして保存された秒数へ移動し、ユーザーがPlayするのを待ちます。ゆっくり聞く場合はSet speedを使用してください。独自のアプリワークフローで進行状況を保存します。
`current_time` と `duration` を読み取ります。`playback_ended` 発生時、アプリは現在の Lesson のリスニングマイルストーンを記録できる場合があります。
ソースが変更された場合、レッスンがロードされるまで古い位置を破棄してください。再生完了を学習者が理解した、またはテストに合格した証拠として扱わないでください。
再生のみ。アプリは再生位置を保存します。
タイムスタンプ付きコメント付きの音声添付ファイルをレビューする
編集者やトレーナーはコメントから録音の該当箇所へジャンプする必要があります。
`source_url = Selected Review’s recording URL`; アプリ所有の各 Commentはそれぞれ秒数値を保存します。オプションの `waveform_peaks_json` には同じ録音の実際のピークが含まれます。
Comment をクリック → Seek で秒数へ → Play。ソースが変更されたら、ピークを置き換えるかクリアし、選択された Reviewを再度バインドします。
コメント作成ツールの横に `current_time` を表示します。`waveform_available` は、実際に提供されたピークが利用可能かどうかを UI に伝えます。
アプリ内で、古いタイムスタンプを現在の録音の長さに収まるように制限するか、拒否します。実際のピークが存在しない場合は、作り出した音声解析ではなく通常のプログレスコントロールを表示します。
再生のみ。アプリは再生位置を保存します。
現在機能しているもの
Public beta. Use the documented controls and actions; test supported formats, permissions and device behavior in your own native app. Browser preview does not validate native device output.
ワークフローを構築する
以下の利用可能なベータアクションを使用し、対象デバイスで結果をテストしてください。
これらの例は Lesson、Message、Order などのアプリレコードを使用しています。ご自身のデータ型や要素名に置き換えてください。メディアアドレスの例はご自身のファイルに置き換える必要があります。
オーディオ要素を追加し、source_url = Selected Message's audio_url、title = Selected Message's sender_label、subtitle = Selected Message's date_label を設定してください。
この録音の実際の波形データがある場合は waveform_peaks_json に渡してください。ない場合は空欄のままにしてください。
ready が発生したら、必要に応じて保存された秒数と共に Seek を使用してください。ユーザーに Play を押させます。プレーヤーボタンには Pause、Seek、Set speed を使用してください。
current_time と duration を表示します。playback_ended で、選択されたメッセージまたはレッスンの再生進捗を保存してください。is_active をこのビューが開いているかどうかに設定してください。
一度だけ設定する
Bubble アプリプロジェクトを BestPlugins → Dashboard → Plugins で作成または選択します。Xodera Audio Player Native を選び、キーをコピーし、次に Bubble → Plugins → Xodera Audio Player Native を開いて licensing_api_key に貼り付けます。一度保存し、以下のアクションを使用してください。各プロジェクトの各プラグインはそれぞれ固有のキーを持ちます。
アプリが開ける直接のオーディオファイルアドレスを使用してください。オーディオの再生にはマイクやカメラへのアクセスは不要です。
一度だけ設定する
- BestPlugins → Dashboard → Plugins で Bubble アプリプロジェクトを作成または選択してください。
- このプラグインを選択し、プロジェクトキーをコピーしてください。
- Open Bubble → Plugins → this plugin. Paste its project key into licensing_api_key and save.
- 要素を追加し、アプリデータを選択して、以下のワークフローを構築してください。
- In the dashboard, review and confirm the 7-day card trial for this plugin. It then costs US$1.50/month per app project, including development and production. Cancel before the trial ends to avoid the first charge.
インストールとサブスクリプション
For Audio Player, Video Player, Photo Editor, Audio Recorder, Files Kit and Haptics: free Bubble installation, a 7-day trial with a card, then US$1.50 per month per plugin and app project. Development and production are included, with no operation cap. File-size and feature limits still apply. Review billing and cancellation before confirming. Other plugins remain unavailable for purchase.
結果をアプリに保存する
例 ListeningProgress: owner = Current User、lesson = Selected Lesson、seconds = Audio Player's current_time、duration = Audio Player's duration。ユーザーが一時停止またはレッスンを離れたときに保存し、画面更新ごとに保存しないでください。
失敗、キャンセル、リカバリー
player_error 上で error_code を表示し、Reload source を提供します。メッセージまたはレッスン記録は保持してください。別の録音が選択された場合は、その保存位置を読み込みます。ビューに戻っても再生は自動的に開始されません。
機能と制限
再生速度: 1、1.5、2。音量: 0–1。波形データ: 2–2048、値は 0 から 1 の間です。サポートされるオーディオ形式はデバイスに依存します。プレーヤーは録音、文字起こし、またはオフライン使用のための永続的保存は行いません。バックグラウンド再生やロック画面での再生は保証されません。
設定、アクション、結果
Bubbleでこれらの名前を使用してください。計画中の機能は別途マークされています。
利用可能なベータ設定
要素設定
source_url · textwaveform_peaks_json · texttitle · textsubtitle · textplayback_rate · numbervolume · numberloop · yes_nois_active · yes_nodisabled · yes_noui_text_json · textlanguage · textステート
player_status · textis_playing · yes_nois_loaded · yes_nois_buffering · yes_nocurrent_time · numberduration · numberprogress · numberplayback_rate · numbervolume · numberis_looping · yes_nowaveform_available · yes_nowaveform_status · texterror_code · textイベント
readyplayback_startedplayback_pausedplayback_endedseek_completedrate_changedplayer_errorアクションとその入力
PlayPauseToggleStopSeekSet speedSet volumeReload source要素設定 · 11
source_urltext · デフォルト: ""- 例の値
https://bestplugins.online/native-samples/lesson.mp3 - 例 Bubble 式
Selected Message's audio_url - 選択された音声、動画、画像ファイルのアドレスです。このプラグインがサポートするファイルタイプを使用してください。
waveform_peaks_jsontext · デフォルト: ""- 例の値
[0.1,0.4,0.2,0.7] - 例 Bubble 式
Selected Message's waveform_peaks_json - この録音の実際の正規化振幅値です。利用できない場合は空欄のままにしてください。
titletext · デフォルト: ""- 例の値
Lesson 4 — review - 例 Bubble 式
Selected Lesson's name - 表示されるアプリテキストです。空欄の場合は、サポートされている場合に組み込みのローカライズ済みコピーが使用されます。認証情報を含めないでください。
subtitletext · デフォルト: ""- 例の値
Teacher · today - 例 Bubble 式
Selected Message's sender_label - 表示されるアプリテキストです。空欄の場合は、サポートされている場合に組み込みのローカライズ済みコピーが使用されます。認証情報を含めないでください。
playback_ratenumber · デフォルト: 1- 例の値
1.5 - 例 Bubble 式
Current User's listening_speed - 現在のビジネスレコードの値を使用し、以下の制限と照合して検証してください。
volumenumber · デフォルト: 1- 例の値
0.8 - 例 Bubble 式
Volume Slider's value - 現在のビジネスレコードの値を使用し、以下の制限と照合して検証してください。
loopyes_no · デフォルト: false- 例の値
no - 例 Bubble 式
Selected Lesson's repeat_enabled - 現在のビジネスレコードの値を使用し、以下の制限と照合して検証してください。
is_activeyes_no · デフォルト: true- 例の値
yes - 例 Bubble 式
GuideHost's view_is_active (your yes/no custom state) - このビューが開いている間はyesに設定し、離れる際はnoに設定して、再生や現在の作業を停止できるようにします。
disabledyes_no · デフォルト: false- 例の値
no - 例 Bubble 式
GuideHost's is_busy (your yes/no custom state) - アプリがビジー状態またはこのアクションが利用できない場合は要素を無効にします。
ui_text_jsontext · デフォルト: ""- 例の値
{} - 例 Bubble 式
App Settings' player_labels_json (supported keys only) - サポートされているボタンラベルを含むオプションの JSON です。空欄にすると組み込みテキストが使用されます。
languagetext · デフォルト: "auto"- 例の値
uk - 例 Bubble 式
Current User's preferred_language - language=auto を設定して、サポートされているデバイスまたはブラウザ言語に従わせます。サポートされている言語コードを入力して明示的に選択してください。
アクションとその入力 · 8
Play
アクションパラメータなし
Pause
アクションパラメータなし
Toggle
アクションパラメータなし
Stop
アクションパラメータなし
Seek
secondsnumber · デフォルト: —- 例の値
12 - 例 Bubble 式
Selected Comment's seconds - 現在のビジネスレコードの値を使用し、以下の制限と照合して検証してください。
Set speed
ratenumber · デフォルト: —- 例の値
1.5 - 例 Bubble 式
Speed Dropdown's value - 現在のビジネスレコードの値を使用し、以下の制限と照合して検証してください。
Set volume
volumenumber · デフォルト: —- 例の値
0.8 - 例 Bubble 式
Volume Slider's value - 現在のビジネスレコードの値を使用し、以下の制限と照合して検証してください。
Reload source
アクションパラメータなし
ステートとイベント
ステート
player_status · textこのアクションの現在の結果です。成功を保存する前に、対応する完了イベントを使用してください。
is_playing · yes_no選択された項目の現在の値です。関連イベントの後に読み取ります。
is_loaded · yes_no選択された項目の現在の値です。関連イベントの後に読み取ります。
is_buffering · yes_no選択された項目の現在の値です。関連イベントの後に読み取ります。
current_time · number選択された項目の現在の値です。関連イベントの後に読み取ります。
duration · number選択された項目の現在の値です。関連イベントの後に読み取ります。
progress · number選択された項目の現在の値です。関連イベントの後に読み取ります。
playback_rate · number選択された項目の現在の値です。関連イベントの後に読み取ります。
volume · number選択された項目の現在の値です。関連イベントの後に読み取ります。
is_looping · yes_no選択された項目の現在の値です。関連イベントの後に読み取ります。
waveform_available · yes_no選択された項目の現在の値です。関連イベントの後に読み取ります。
waveform_status · textこのアクションの現在の結果です。成功を保存する前に、対応する完了イベントを使用してください。
error_code · text直前のアクションのエラー情報です。役立つメッセージを表示し、該当する再試行を提供してください。
イベント
readyこのイベントが発生したとき、同じ要素から関連する状態を読み取ります。
playback_startedこのイベントが発生したとき、同じ要素から関連する状態を読み取ります。
playback_pausedこのイベントが発生したとき、同じ要素から関連する状態を読み取ります。
playback_endedこのイベントが発生したとき、同じ要素から関連する状態を読み取ります。
seek_completedこのイベントが発生したとき、同じ要素から関連する状態を読み取ります。
rate_changedこのイベントが発生したとき、同じ要素から関連する状態を読み取ります。
player_errorこのイベントが発生したとき、同じ要素から関連する状態を読み取ります。
開発者が尋ねる質問
波形を作成しますか？
いいえ。そのソースに対して正規化されたピークを提供してください。通常の進行はそれらなしで機能します。
サブスクリプションはどのように機能しますか？
For Audio Player, Video Player, Photo Editor, Audio Recorder, Files Kit and Haptics: free Bubble installation, a 7-day trial with a card, then US$1.50 per month per plugin and app project. Development and production are included, with no operation cap. File-size and feature limits still apply. Review billing and cancellation before confirming. Other plugins remain unavailable for purchase.
関連ガイド
サポートが必要な場合は、使用しているプラグインとデバイス、試したアクションと結果をお知らせください。個人データを含まない例を使用してください。キーやプライベートファイルを決して共有しないでください。