Xodera Plugins · Bubble Native
Xodera Audio Player Native
Lisa selge helimängija õppetundidele, hääl-sõnumitele või toote kirjetesse. Luba kasutajatel kuulata, muuta kiirust ja jätkata oma salvestatud kohast.
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.
Dokumentatsioon üle vaadatud 6 novembris 2026
Praktilised näited
Häälmärkused toevestluses
Lihtne failiviide suunab kasutajad vestlusest ära ja muudab pikkade vastuste ülevaatamise keeruliseks.
`source_url = Selected Message’s audio URL`; `title = Selected Message’s sender label`; `subtitle = Selected Message’s timestamp`.
Paiguta mängija valitud sõnumi üksikasjadesse. Lase kasutajal Play/Pause, Seek kasulikule punktile ja Set speed. Seo `is_active` avatud vestlusega.
Kasuta `is_playing`, `current_time` ja `duration` edenemise näitamiseks. Hoia Message ID oma rakenduses, et hilinenud sündmus ei saaks värskendada teist vestlust.
`player_error` korral näita `error_code` ja paku Reload source; säilita sõnum ja ära kunagi märgi seda kuulatud pärast viga.
Ainult taasesitus. Teie rakendus salvestab kuulamise edenemise.
Jätka keeleõpet salvestatud positsioonist
Õpilased peavad keerulist lõiku taasesitama, mitte kogu õppetundi uuesti alustama.
`source_url = Current Lesson’s audio URL`; `title = Current Lesson’s name`; viimane positsioon kuulub sellele õpilasele ja õppetunnile teie andmebaasis.
Pärast `ready` praeguse õppetunni jaoks, Seek salvestatud sekunditele ja oota, kuni kasutaja Play. Kasuta Set speed aeglasemaks kuulamiseks. Salvesta edenemine oma rakenduse töövooga.
Loe `current_time` ja `duration`. `playback_ended` korral võib teie rakendus salvestada kuulamise verstaposti praeguse Lesson jaoks.
Kui allikas on muutunud, visake vana positsioon kõrvale, kuni see õppetund on laaditud. Ärge käsitlege kuulamise lõpetamist tõendina, et õpilane on mõistnud või testist läbinud.
Ainult taasesitus. Teie rakendus salvestab kuulamise edenemise.
Vaadake audio manust läbi ajatemplitud kommentaaridega
Toimetajad või koolitajad peavad hüppama kommentaarist salvestise asjakohasele hetkele.
`source_url = Selected Review’s recording URL`; iga rakendusele kuuluv Comment kirje salvestab oma sekundiväärtuse; valikuline `waveform_peaks_json` sisaldab sama salvestise tegelikke tippe.
Klõpsa Comment kirjel → Seek selle sekundiväärtuseni → Play. Allika muutumisel asenda või tühjenda tipud ja seo valitud Review uuesti.
Kuva `current_time` kommentaari kirjutamise välja kõrval. `waveform_available` näitab kasutajaliidesele, kas tegelikud etteantud tipud on saadaval.
Piira või lükka tagasi aegunud ajatemplitud vastavalt praegusele kestusele teie rakenduses. Kui reaalseid tippu pole, näita tavalist edenemisriba, mitte väljamõeldud helianalüüsi.
Ainult taasesitus. Teie rakendus salvestab kuulamise edenemise.
Mis töötab praegu
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.
Loo töövoog
Kasuta allpool olevaid saadavalolevaid beetategevusi ja testi tulemust oma sihtseadmetel.
Need näited kasutavad rakenduse kirjeid, nagu Lesson, Message ja Order. Asenda need oma andmetüüpide ja elementide nimedega. Näidismeedia aadresse tuleb asendada oma failidega.
Lisa helielement. Määra source_url = Selected Message's audio_url, title = Selected Message's sender_label ja subtitle = Selected Message's date_label.
Kui sul on selle salvestuse jaoks reaalsed lainekuju andmed, edasta need waveform_peaks_json. Vastasel juhul jäta see tühjaks.
Kui toimub ready, kasuta vajaduse korral Seek koos salvestatud sekundite arvuga. Lase kasutajal vajutada Play. Kasuta mängija nuppude jaoks Pause, Seek ja Set speed.
Kuva current_time ja duration. playback_ended korral salvesta valitud sõnumi või õppetunni kuulamise edenemine. Sea is_active selle järgi, kas see vaade on avatud.
Seadista üks kord
Loo või vali oma Bubble rakenduse projekt BestPlugins → Dashboard → Plugins. Vali Xodera Audio Player Native, kopeeri selle võti, seejärel ava Bubble → Plugins → Xodera Audio Player Native ja kleebi see licensing_api_key. Salvesta üks kord; seejärel kasuta allolevaid tegevusi. Igal pistikprogrammil igas projektis on oma võti.
Kasuta otseaudiofaili aadressi, mida rakendus suudab avada. Audio esitamiseks ei ole vaja mikrofoniga ega kaameraga ligipääsu.
Seadista üks kord
- Loo või vali oma Bubble rakenduse projekt BestPlugins → Dashboard → Plugins.
- Vali see pistikprogramm ja kopeeri selle projekti võti.
- Open Bubble → Plugins → this plugin. Paste its project key into licensing_api_key and save.
- Lisa element, vali oma rakenduse andmed ja loo allpool toodud töövoog.
- 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.
Paigaldus ja tellimus
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.
Salvesta tulemus oma rakendusse
Näide ListeningProgress: owner = Current User, lesson = Selected Lesson, seconds = Audio Player's current_time, duration = Audio Player's duration. Salvesta, kui kasutaja peatab või lahkub õppetunnist, mitte iga ekraani värskenduse korral.
Tõrge, tühistamine ja taastamine
player_error puhul näita error_code ja paku Reload source. Säilita sõnumi või õppetunni kirje. Kui valitakse teine salvestus, laadi selle salvestatud asukoht. Vaatesse naasmine ei käivita taasesitust automaatselt.
Võimekused ja piirangud
Taasesituskiirused: 1, 1.5 ja 2. Helitugevus: 0–1. Lainekuju andmed: 2–2048 väärtust vahemikus 0 kuni 1. Toetatud helivormingud sõltuvad seadmest. Mängija ei salvesta ega transkribeeri heli ning ei talleta seda püsivalt võrguühenduseta kasutamiseks. Taustal ja lukustatud ekraanil taasesitust ei garanteerita.
Seaded, toimingud ja tulemused
Kasuta neid nimesid Bubble-s. Planeeritud funktsioonid on märgitud eraldi.
Saadaolevad beetaversiooni seaded
Elemendi seaded
source_url · textwaveform_peaks_json · texttitle · textsubtitle · textplayback_rate · numbervolume · numberloop · yes_nois_active · yes_nodisabled · yes_noui_text_json · textlanguage · textOlekud
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 · textSündmused
readyplayback_startedplayback_pausedplayback_endedseek_completedrate_changedplayer_errorToimingud ja nende sisendid
PlayPauseToggleStopSeekSet speedSet volumeReload sourceElemendi seaded · 11
source_urltext · Vaikimisi: ""- Näidisväärtus
https://bestplugins.online/native-samples/lesson.mp3 - Bubble avaldise näide
Selected Message's audio_url - Valitud audio-, video- või pildifaili aadress. Kasuta failitüüpi, mida see plugin toetab.
waveform_peaks_jsontext · Vaikimisi: ""- Näidisväärtus
[0.1,0.4,0.2,0.7] - Bubble avaldise näide
Selected Message's waveform_peaks_json - Selle salvestuse tegelikud normaliseeritud amplituudiväärtused; jätke tühjaks, kui pole saadaval.
titletext · Vaikimisi: ""- Näidisväärtus
Lesson 4 — review - Bubble avaldise näide
Selected Lesson's name - Nähtav rakenduse tekst; tühja väärtuse korral kasutatakse toetatud juhtudel sisseehitatud tõlgitud teksti. Ära sisesta siia juurdepääsuandmeid.
subtitletext · Vaikimisi: ""- Näidisväärtus
Teacher · today - Bubble avaldise näide
Selected Message's sender_label - Nähtav rakenduse tekst; tühja väärtuse korral kasutatakse toetatud juhtudel sisseehitatud tõlgitud teksti. Ära sisesta siia juurdepääsuandmeid.
playback_ratenumber · Vaikimisi: 1- Näidisväärtus
1.5 - Bubble avaldise näide
Current User's listening_speed - Kasutage praeguse ärirekordi väärtust; kontrollige seda allpool toodud piiride suhtes.
volumenumber · Vaikimisi: 1- Näidisväärtus
0.8 - Bubble avaldise näide
Volume Slider's value - Kasutage praeguse ärirekordi väärtust; kontrollige seda allpool toodud piiride suhtes.
loopyes_no · Vaikimisi: false- Näidisväärtus
no - Bubble avaldise näide
Selected Lesson's repeat_enabled - Kasutage praeguse ärirekordi väärtust; kontrollige seda allpool toodud piiride suhtes.
is_activeyes_no · Vaikimisi: true- Näidisväärtus
yes - Bubble avaldise näide
GuideHost's view_is_active (your yes/no custom state) - Määra yes, kui see vaade on avatud. Vaate sulgemisel määra no, et taasesitus või pooleliolev töö saaks peatuda.
disabledyes_no · Vaikimisi: false- Näidisväärtus
no - Bubble avaldise näide
GuideHost's is_busy (your yes/no custom state) - Keela element, kui teie rakendus on hõivatud või see toiming pole saadaval.
ui_text_jsontext · Vaikimisi: ""- Näidisväärtus
{} - Bubble avaldise näide
App Settings' player_labels_json (supported keys only) - Valikuline JSON toetatud nuppude siltidega. Jäta tühjaks, et kasutada sisseehitatud teksti.
languagetext · Vaikimisi: "auto"- Näidisväärtus
uk - Bubble avaldise näide
Current User's preferred_language - Määra language=auto, et kasutada seadme või brauseri keelt, kui see keel on toetatud. Kindla keele valimiseks sisesta toetatud keelekood.
Toimingud ja nende sisendid · 8
Play
Ei ole toimingu parameetreid
Pause
Ei ole toimingu parameetreid
Toggle
Ei ole toimingu parameetreid
Stop
Ei ole toimingu parameetreid
Seek
secondsnumber · Vaikimisi: —- Näidisväärtus
12 - Bubble avaldise näide
Selected Comment's seconds - Kasutage praeguse ärirekordi väärtust; kontrollige seda allpool toodud piiride suhtes.
Set speed
ratenumber · Vaikimisi: —- Näidisväärtus
1.5 - Bubble avaldise näide
Speed Dropdown's value - Kasutage praeguse ärirekordi väärtust; kontrollige seda allpool toodud piiride suhtes.
Set volume
volumenumber · Vaikimisi: —- Näidisväärtus
0.8 - Bubble avaldise näide
Volume Slider's value - Kasutage praeguse ärirekordi väärtust; kontrollige seda allpool toodud piiride suhtes.
Reload source
Ei ole toimingu parameetreid
Olekud ja sündmused
Olekud
player_status · textSelle toimingu praegune tulemus. Kasuta sobivat lõpetamise sündmust enne edu salvestamist.
is_playing · yes_noValitud üksuse praegune väärtus. Loe seda pärast seotud sündmust.
is_loaded · yes_noValitud üksuse praegune väärtus. Loe seda pärast seotud sündmust.
is_buffering · yes_noValitud üksuse praegune väärtus. Loe seda pärast seotud sündmust.
current_time · numberValitud üksuse praegune väärtus. Loe seda pärast seotud sündmust.
duration · numberValitud üksuse praegune väärtus. Loe seda pärast seotud sündmust.
progress · numberValitud üksuse praegune väärtus. Loe seda pärast seotud sündmust.
playback_rate · numberValitud üksuse praegune väärtus. Loe seda pärast seotud sündmust.
volume · numberValitud üksuse praegune väärtus. Loe seda pärast seotud sündmust.
is_looping · yes_noValitud üksuse praegune väärtus. Loe seda pärast seotud sündmust.
waveform_available · yes_noValitud üksuse praegune väärtus. Loe seda pärast seotud sündmust.
waveform_status · textSelle toimingu praegune tulemus. Kasuta sobivat lõpetamise sündmust enne edu salvestamist.
error_code · textVea teave viimase toimingu kohta. Kuva abistav sõnum ja paku asjakohast kordamist.
Sündmused
readyKui see sündmus toimub, loe seotud olekuid samast elemendist.
playback_startedKui see sündmus toimub, loe seotud olekuid samast elemendist.
playback_pausedKui see sündmus toimub, loe seotud olekuid samast elemendist.
playback_endedKui see sündmus toimub, loe seotud olekuid samast elemendist.
seek_completedKui see sündmus toimub, loe seotud olekuid samast elemendist.
rate_changedKui see sündmus toimub, loe seotud olekuid samast elemendist.
player_errorKui see sündmus toimub, loe seotud olekuid samast elemendist.
Küsimused, mida arendajad esitavad
Kas see loob lainekuju?
Ei. Esitage selle allika jaoks reaalsed normaliseeritud tipud; tavaline edenemine toimib ilma nendeta.
Kuidas tellimus töötab?
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.
Seotud juhendid
Abi saamiseks andke meile teada, millist pistikprogrammi ja seadet kasutate, millist toimingut proovisite ning mis juhtus. Kasutage näidet ilma isikuandmeteta. Ärge kunagi jagage oma võtit ega privaatfaile.