Xodera Plugins · Bubble Native
Xodera Audio Player Native
Tambahkan pemain audio yang jelas ke pelajaran, mesej suara atau rekod produk. Biarkan orang mendengar, menukar kelajuan dan meneruskan dari kedudukan yang disimpan.
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.
Dokumentasi disemak 6 November 2026
Contoh praktikal
Nota suara dalam perbualan sokongan
Pautan fail biasa menghantar pengguna keluar dari perbualan dan menjadikan balasan panjang sukar untuk disemak.
`source_url = Selected Message’s audio URL`; `title = Selected Message’s sender label`; `subtitle = Selected Message’s timestamp`.
Letakkan pemain dalam butiran mesej terpilih. Biarkan pengguna Play/Pause, Seek ke titik berguna dan Set speed. Ikat `is_active` kepada perbualan terbuka.
Gunakan `is_playing`, `current_time` dan `duration` untuk menunjukkan kemajuan. Simpan ID Message dalam aplikasi anda supaya acara lewat tidak dapat mengemas kini perbualan lain.
Pada `player_error`, tunjukkan `error_code` dan tawarkan Reload source; kekalkan mesej dan jangan sekali-kali menandanya sebagai telah didengar selepas ralat.
Hanya main balik. Aplikasi anda menyimpan kemajuan mendengar.
Sambung semula pelajaran bahasa pada kedudukan yang disimpan
Pelajar perlu mengulang semula bahagian sukar daripada memulakan semula keseluruhan pelajaran.
`source_url = Current Lesson’s audio URL`; `title = Current Lesson’s name`; kedudukan terakhir milik pelajar dan pelajaran itu dalam pangkalan data anda.
Selepas `ready` untuk pelajaran semasa, Seek ke saat yang disimpan dan tunggu pengguna Play. Gunakan Set speed untuk mendengar lebih perlahan. Simpan kemajuan dengan aliran kerja aplikasi anda sendiri.
Baca `current_time` dan `duration`. Pada `playback_ended`, aplikasi anda boleh merekod pencapaian mendengar untuk Lesson semasa.
Jika sumber berubah, buang kedudukan lama sehingga pelajaran itu dimuatkan. Jangan anggap penyelesaian mendengar sebagai bukti pelajar memahami atau lulus ujian.
Hanya main balik. Aplikasi anda menyimpan kemajuan mendengar.
Semak lampiran audio dengan komen berpenanda masa
Penyunting atau jurulatih perlu melompat dari komen ke saat yang berkaitan dalam rakaman.
`source_url = Selected Review’s recording URL`; setiap Komen milik aplikasi menyimpan nilai saatnya sendiri; `waveform_peaks_json` pilihan mengandungi puncak sebenar untuk rakaman yang sama.
Klik Komen → Seek ke saatnya → Play. Pada perubahan sumber, ganti atau kosongkan puncak dan ikat semula Ulasan terpilih.
Paparkan `current_time` di sebelah penyusun komen anda. `waveform_available` memberitahu UI anda sama ada puncak sebenar yang disediakan tersedia.
Kekang atau tolak cap masa lapuk berbanding tempoh semasa dalam aplikasi anda. Apabila tiada puncak sebenar, tunjukkan kawalan kemajuan biasa dan bukannya analisis audio yang direka.
Hanya main balik. Aplikasi anda menyimpan kemajuan mendengar.
Apa yang berfungsi sekarang
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.
Bina aliran kerja
Gunakan tindakan beta yang tersedia di bawah dan uji hasilnya pada peranti sasaran anda.
Contoh-contoh ini menggunakan rekod aplikasi seperti Lesson, Message dan Order. Gantikan mereka dengan jenis data dan nama elemen anda sendiri. Alamat media contoh mesti diganti dengan fail anda sendiri.
Tambah elemen audio. Tetapkan source_url = Selected Message's audio_url, title = Selected Message's sender_label dan subtitle = Selected Message's date_label.
Jika anda mempunyai data bentuk gelombang sebenar untuk rakaman ini, serahkan dalam waveform_peaks_json. Jika tidak, biarkan kosong.
Apabila peristiwa ready berlaku, gunakan Seek dengan jumlah saat yang disimpan jika diperlukan. Biarkan pengguna menekan Play. Gunakan Pause, Seek dan Set speed untuk butang pemain.
Tunjukkan current_time dan duration. Pada playback_ended, simpan kemajuan mendengar untuk mesej atau pelajaran terpilih. Tetapkan is_active kepada sama ada paparan ini dibuka.
Konfigurasi sekali
Buat atau pilih projek aplikasi Bubble anda dalam BestPlugins → Dashboard → Plugins. Pilih Xodera Audio Player Native, salin kuncinya, kemudian buka Bubble → Plugins → Xodera Audio Player Native dan tampal ke dalam licensing_api_key. Simpan sekali; kemudian gunakan tindakan di bawah. Setiap plugin dalam setiap projek mempunyai kunci masing‑masing.
Gunakan alamat fail audio langsung yang dapat dibuka oleh aplikasi. Memainkan audio tidak memerlukan akses mikrofon atau kamera.
Konfigurasi sekali
- Buat atau pilih projek aplikasi Bubble anda di BestPlugins → Dashboard → Plugins.
- Pilih plugin ini dan salin kunci projeknya.
- Open Bubble → Plugins → this plugin. Paste its project key into licensing_api_key and save.
- Tambah elemen, pilih data aplikasi anda dan bina alur kerja di bawah.
- 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.
Pemasangan dan langganan
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.
Simpan hasil dalam aplikasi anda
Contoh ListeningProgress: owner = Current User, lesson = Selected Lesson, seconds = Audio Player's current_time, duration = Audio Player's duration. Simpan bila pengguna menjeda atau meninggalkan pelajaran, bukannya pada setiap kemas kini skrin.
Kegagalan, pembatalan dan pemulihan
Pada player_error, tunjukkan error_code dan tawarkan Reload source. Simpan rekod mesej atau pelajaran. Bila rakaman lain dipilih, muat kedudukan tersimpan masing‑masing. Kembali ke paparan tidak memulakan playback secara automatik.
Keupayaan dan had
Kelajuan playback: 1, 1.5 dan 2. Volum: 0–1. Data bentuk gelombang: 2–2048 nilai antara 0 dan 1. Format audio yang disokong bergantung pada peranti. Pemain tidak merakam, mentranskripsi atau menyimpan audio secara kekal untuk penggunaan luar talian. Playback latar belakang dan skrin kunci tidak dijamin.
Tetapan, tindakan dan hasil
Gunakan nama-nama ini dalam Bubble. Ciri yang dirancang ditandakan secara berasingan.
Tetapan beta tersedia
Tetapan elemen
source_url · textwaveform_peaks_json · texttitle · textsubtitle · textplayback_rate · numbervolume · numberloop · yes_nois_active · yes_nodisabled · yes_noui_text_json · textlanguage · textKeadaan
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 · textAcara
readyplayback_startedplayback_pausedplayback_endedseek_completedrate_changedplayer_errorTindakan dan inputnya
PlayPauseToggleStopSeekSet speedSet volumeReload sourceTetapan elemen · 11
source_urltext · Lalai: ""- Nilai contoh
https://bestplugins.online/native-samples/lesson.mp3 - Contoh ungkapan Bubble
Selected Message's audio_url - Alamat fail audio, video atau imej yang dipilih. Gunakan jenis fail yang disokong plugin ini.
waveform_peaks_jsontext · Lalai: ""- Nilai contoh
[0.1,0.4,0.2,0.7] - Contoh ungkapan Bubble
Selected Message's waveform_peaks_json - Nilai amplitud normalisasi sebenar untuk rakaman ini; biarkan kosong jika tidak tersedia.
titletext · Lalai: ""- Nilai contoh
Lesson 4 — review - Contoh ungkapan Bubble
Selected Lesson's name - Teks aplikasi yang dipaparkan; jika dikosongkan, teks terbina dalam yang dilokalkan digunakan jika disokong. Jangan masukkan maklumat pengesahan.
subtitletext · Lalai: ""- Nilai contoh
Teacher · today - Contoh ungkapan Bubble
Selected Message's sender_label - Teks aplikasi yang dipaparkan; jika dikosongkan, teks terbina dalam yang dilokalkan digunakan jika disokong. Jangan masukkan maklumat pengesahan.
playback_ratenumber · Lalai: 1- Nilai contoh
1.5 - Contoh ungkapan Bubble
Current User's listening_speed - Gunakan nilai rekod perniagaan semasa; sahkan ia terhadap had di bawah.
volumenumber · Lalai: 1- Nilai contoh
0.8 - Contoh ungkapan Bubble
Volume Slider's value - Gunakan nilai rekod perniagaan semasa; sahkan ia terhadap had di bawah.
loopyes_no · Lalai: false- Nilai contoh
no - Contoh ungkapan Bubble
Selected Lesson's repeat_enabled - Gunakan nilai rekod perniagaan semasa; sahkan ia terhadap had di bawah.
is_activeyes_no · Lalai: true- Nilai contoh
yes - Contoh ungkapan Bubble
GuideHost's view_is_active (your yes/no custom state) - Tetapkan ya semasa pandangan ini dibuka. Tetapkan tidak apabila keluar, supaya main semula atau kerja semasa dapat dihentikan.
disabledyes_no · Lalai: false- Nilai contoh
no - Contoh ungkapan Bubble
GuideHost's is_busy (your yes/no custom state) - Lumpuhkan elemen semasa aplikasi anda sibuk atau tindakan ini tidak tersedia.
ui_text_jsontext · Lalai: ""- Nilai contoh
{} - Contoh ungkapan Bubble
App Settings' player_labels_json (supported keys only) - JSON pilihan dengan label butang yang disokong. Biarkan kosong untuk menggunakan teks terbina dalam.
languagetext · Lalai: "auto"- Nilai contoh
uk - Contoh ungkapan Bubble
Current User's preferred_language - Tetapkan language=auto untuk mengikuti peranti atau bahasa pelayar yang disokong. Masukkan kod bahasa yang disokong untuk memilihnya secara eksplisit.
Tindakan dan inputnya · 8
Play
Tiada parameter tindakan
Pause
Tiada parameter tindakan
Toggle
Tiada parameter tindakan
Stop
Tiada parameter tindakan
Seek
secondsnumber · Lalai: —- Nilai contoh
12 - Contoh ungkapan Bubble
Selected Comment's seconds - Gunakan nilai rekod perniagaan semasa; sahkan ia terhadap had di bawah.
Set speed
ratenumber · Lalai: —- Nilai contoh
1.5 - Contoh ungkapan Bubble
Speed Dropdown's value - Gunakan nilai rekod perniagaan semasa; sahkan ia terhadap had di bawah.
Set volume
volumenumber · Lalai: —- Nilai contoh
0.8 - Contoh ungkapan Bubble
Volume Slider's value - Gunakan nilai rekod perniagaan semasa; sahkan ia terhadap had di bawah.
Reload source
Tiada parameter tindakan
Keadaan dan peristiwa
Keadaan
player_status · textKeputusan semasa tindakan ini. Gunakan acara selesai yang sepadan sebelum menyimpan kejayaan.
is_playing · yes_noNilai semasa untuk item yang dipilih. Baca selepas acara berkaitan.
is_loaded · yes_noNilai semasa untuk item yang dipilih. Baca selepas acara berkaitan.
is_buffering · yes_noNilai semasa untuk item yang dipilih. Baca selepas acara berkaitan.
current_time · numberNilai semasa untuk item yang dipilih. Baca selepas acara berkaitan.
duration · numberNilai semasa untuk item yang dipilih. Baca selepas acara berkaitan.
progress · numberNilai semasa untuk item yang dipilih. Baca selepas acara berkaitan.
playback_rate · numberNilai semasa untuk item yang dipilih. Baca selepas acara berkaitan.
volume · numberNilai semasa untuk item yang dipilih. Baca selepas acara berkaitan.
is_looping · yes_noNilai semasa untuk item yang dipilih. Baca selepas acara berkaitan.
waveform_available · yes_noNilai semasa untuk item yang dipilih. Baca selepas acara berkaitan.
waveform_status · textKeputusan semasa tindakan ini. Gunakan acara selesai yang sepadan sebelum menyimpan kejayaan.
error_code · textMaklumat ralat untuk tindakan terakhir. Tunjukkan mesej bantuan dan tawarkan percubaan semula yang relevan.
Acara
readyApabila acara ini berlaku, baca keadaan berkaitan dari elemen yang sama.
playback_startedApabila acara ini berlaku, baca keadaan berkaitan dari elemen yang sama.
playback_pausedApabila acara ini berlaku, baca keadaan berkaitan dari elemen yang sama.
playback_endedApabila acara ini berlaku, baca keadaan berkaitan dari elemen yang sama.
seek_completedApabila acara ini berlaku, baca keadaan berkaitan dari elemen yang sama.
rate_changedApabila acara ini berlaku, baca keadaan berkaitan dari elemen yang sama.
player_errorApabila acara ini berlaku, baca keadaan berkaitan dari elemen yang sama.
Soalan yang ditanya pembangun
Adakah ia menghasilkan bentuk gelombang?
Tidak. Sediakan puncak ternormalkan sebenar untuk sumber itu; kemajuan biasa berfungsi tanpa mereka.
Bagaimana langganan berfungsi?
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.
Panduan berkaitan
Untuk bantuan, beritahu kami plugin dan peranti yang anda gunakan, tindakan yang anda cuba serta apa yang terjadi. Gunakan contoh tanpa data peribadi. Jangan sekali-kali kongsikan kunci atau fail peribadi anda.