Audio Player vmesnik s primernim naslovom.
Audio Player vmesnik s primernim naslovom.
← Vsi izvorni vodiči

Xodera Plugins · Bubble Native

Xodera Audio Player Native

Dodajte jasen avdio predvajalnik v lekcije, glasovna sporočila ali zapise izdelkov. Uporabnikom omogočite poslušanje, spreminjanje hitrosti in nadaljevanje od shranjenega mesta.

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.

Dokumentacija pregledana 6 november 2026

Praktični primeri

Glasovne opombe v podporni konverzaciji

Navadna povezava do datoteke odpelje uporabnike iz pogovora in oteži pregled dolgih odgovorov.

`source_url = Selected Message’s audio URL`; `title = Selected Message’s sender label`; `subtitle = Selected Message’s timestamp`.

Postavite predvajalnik v podrobnosti izbranega sporočila. Naj uporabnik Play/Pause, Seek do uporabne točke in Set speed. Povežite `is_active` z odprto konverzacijo.

Uporabite `is_playing`, `current_time` in `duration` za prikaz napredka. Ohranite ID Message v aplikaciji, da pozni dogodek ne more posodobiti druge konverzacije.

Ob `player_error` prikažite `error_code` in ponudite Reload source; ohranite sporočilo in ga nikoli ne označite kot poslušano po napaki.

Samo predvajanje. Vaša aplikacija shranjuje napredek poslušanja.

Nadaljujte jezikovno lekcijo na shranjenem mestu

Učenci morajo ponovno predvajati težko odlomko namesto ponovnega začetka celotne lekcije.

`source_url = Current Lesson’s audio URL`; `title = Current Lesson’s name`; zadnje mesto pripada temu učencu in lekciji v vaši bazi podatkov.

Po `ready` za trenutno lekcijo, Seek na shranjene sekunde in počakajte, da uporabnik Play. Uporabite Set speed za počasnejše poslušanje. Shranite napredek s svojim delovnim tokom aplikacije.

Preberite `current_time` in `duration`. Ob `playback_ended` lahko vaša aplikacija zabeleži mejniko poslušanja za trenutni Lesson.

Če se je vir spremenil, zavrzite staro mesto, dokler se lekcija ne naloži. Ne obravnavajte zaključka poslušanja kot dokaz, da je učenec razumel ali opravil test.

Samo predvajanje. Vaša aplikacija shranjuje napredek poslušanja.

Preglejte zvočno priponko s časovno označenimi komentarji

Uredniki ali trenerji morajo skočiti iz komentarja na ustrezen trenutek v posnetku.

`source_url = Selected Review’s recording URL`; vsak komentar v aplikaciji shranjuje svojo vrednost v sekundah; izbirni `waveform_peaks_json` vsebuje dejanske vrhove za isti posnetek.

Kliknite komentar → Seek na njegove sekunde → Play. Ob spremembi vira zamenjajte ali počistite vrhove ter ponovno povežite izbrani pregled.

Prikažite `current_time` poleg vašega ustvarjalca komentarjev. `waveform_available` sporoča vašemu UI, ali so dejanski vrhovi na voljo.

Omeji ali zavrni zastarele časovne žige glede na trenutno trajanje v vaši aplikaciji. Ko ni dejanskih vrhov, prikaži običajni nadzor napredka namesto izmišljene analize zvoka.

Samo predvajanje. Vaša aplikacija shranjuje napredek poslušanja.

Kaj deluje zdaj

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.

Ustvarite delovni tok

Uporabite spodnje razpoložljive beta akcije in preizkusite rezultat na svojih ciljnih napravah.

Ti primeri uporabljajo zapise aplikacije, kot so Lesson, Message in Order. Zamenjajte jih s svojimi vrstami podatkov in imeni elementov. Primeri naslovov medijev je treba zamenjati s svojimi datotekami.

  1. Dodajte avdio element. Nastavite source_url = Selected Message's audio_url, title = Selected Message's sender_label in subtitle = Selected Message's date_label.

  2. Če imate dejanske podatke valovne oblike za to snemanje, jih posredujte v waveform_peaks_json. V nasprotnem primeru pustite prazno.

  3. Ko se sproži dogodek ready, uporabite Seek s shranjenim številom sekund, če je potrebno. Uporabniku omogočite pritisk na Play. Za gumbe predvajalnika uporabite Pause, Seek in Set speed.

  4. Prikažite current_time in duration. Ob playback_ended shranite napredek poslušanja za izbrano sporočilo ali lekcijo. Nastavite is_active glede na to, ali je ta pogled odprt.

Diagram delovnega toka — ne posnetek zaslona aplikacije

Nastavite enkrat

Ustvarite ali izberite svoj projekt aplikacije Bubble v BestPlugins → Dashboard → Plugins. Izberite Xodera Audio Player Native, kopirajte njegov ključ, nato odprite Bubble → Plugins → Xodera Audio Player Native in ga prilepite v licensing_api_key. Shranite enkrat; nato uporabite spodnje akcije. Vsak vtičnik v vsakem projektu ima svoj ključ.

Uporabite neposreden naslov avdio datoteke, ki jo aplikacija lahko odpre. Predvajanje zvoka ne zahteva dostopa do mikrofona ali kamere.

Nastavite enkrat
  1. Ustvarite ali izberite svoj projekt aplikacije Bubble pri BestPlugins → Dashboard → Plugins.
  2. Izberite ta vtičnik in kopirajte njegov ključ projekta.
  3. Open Bubble → Plugins → this plugin. Paste its project key into licensing_api_key and save.
  4. Dodajte element, izberite svoje podatke aplikacije in sestavite spodnji potek dela.
  5. 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.
Namestitev in naročnina

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.

Shrani rezultat v vašo aplikacijo

Primer ListeningProgress: owner = Current User, lesson = Selected Lesson, seconds = Audio Player's current_time, duration = Audio Player's duration. Shranite, ko uporabnik ustavi ali zapusti lekcijo, namesto pri vsaki posodobitvi zaslona.

Napaka, preklic in obnovitev

Na player_error prikažite error_code in ponudite Reload source. Ohranite zapis sporočila ali lekcije. Ko je izbrano drugo snemanje, naložite njegovo shranjeno pozicijo. Vrnitev v pogled ne začne predvajanja samodejno.

Zmožnosti in omejitve

Hitrost predvajanja: 1, 1.5 in 2. Glasnost: 0–1. Podatki valovne oblike: 2–2048 vrednosti med 0 in 1. Podprti avdio formati so odvisni od naprave. Predvajalnik ne snemlja, ne prepisuje niti trajno ne shranjuje zvoka za uporabo brez povezave. Predvajanje v ozadju in na zaklenjenem zaslonu ni zagotovljeno.

Nastavitve, dejanja in rezultati

Uporabite ta imena v Bubble. Načrtovane funkcije so označene ločeno.

Razpoložljive beta nastavitve

Nastavitve elementa

source_url · textwaveform_peaks_json · texttitle · textsubtitle · textplayback_rate · numbervolume · numberloop · yes_nois_active · yes_nodisabled · yes_noui_text_json · textlanguage · text

Stanja

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

Dogodki

readyplayback_startedplayback_pausedplayback_endedseek_completedrate_changedplayer_error

Dejanja in njihovi vnosi

PlayPauseToggleStopSeekSet speedSet volumeReload source
Nastavitve elementa · 11
source_urltext · Privzeto: ""
Primer vrednostihttps://bestplugins.online/native-samples/lesson.mp3
Primer Bubble izrazaSelected Message's audio_url
Naslov izbrane zvočne, video ali slikovne datoteke. Uporabite vrsto datoteke, ki jo ta vtičnik podpira.
waveform_peaks_jsontext · Privzeto: ""
Primer vrednosti[0.1,0.4,0.2,0.7]
Primer Bubble izrazaSelected Message's waveform_peaks_json
Prave normalizirane amplitude vrednosti za to snemanje; pustite prazno, če ni na voljo.
titletext · Privzeto: ""
Primer vrednostiLesson 4 — review
Primer Bubble izrazaSelected Lesson's name
Vidno besedilo aplikacije; prazno uporablja vgrajeno lokalizirano kopijo, kjer je podprto. Brez poverilnic.
subtitletext · Privzeto: ""
Primer vrednostiTeacher · today
Primer Bubble izrazaSelected Message's sender_label
Vidno besedilo aplikacije; prazno uporablja vgrajeno lokalizirano kopijo, kjer je podprto. Brez poverilnic.
playback_ratenumber · Privzeto: 1
Primer vrednosti1.5
Primer Bubble izrazaCurrent User's listening_speed
Uporabi vrednost trenutnega poslovnega zapisa; preveri jo glede na spodnje omejitve.
volumenumber · Privzeto: 1
Primer vrednosti0.8
Primer Bubble izrazaVolume Slider's value
Uporabi vrednost trenutnega poslovnega zapisa; preveri jo glede na spodnje omejitve.
loopyes_no · Privzeto: false
Primer vrednostino
Primer Bubble izrazaSelected Lesson's repeat_enabled
Uporabi vrednost trenutnega poslovnega zapisa; preveri jo glede na spodnje omejitve.
is_activeyes_no · Privzeto: true
Primer vrednostiyes
Primer Bubble izrazaGuideHost's view_is_active (your yes/no custom state)
Nastavi da, ko je ta pogled odprt. Nastavi ne, ko zapuščate, da se predvajanje ali trenutno delo lahko ustavi.
disabledyes_no · Privzeto: false
Primer vrednostino
Primer Bubble izrazaGuideHost's is_busy (your yes/no custom state)
Onemogoči element, ko je vaša aplikacija zasedena ali ko je to dejanje nedostopno.
ui_text_jsontext · Privzeto: ""
Primer vrednosti{}
Primer Bubble izrazaApp Settings' player_labels_json (supported keys only)
Izbirni JSON s podprtimi oznakami gumbov. Pustite prazno za uporabo vgrajenega besedila.
languagetext · Privzeto: "auto"
Primer vrednostiuk
Primer Bubble izrazaCurrent User's preferred_language
Nastavite language=auto, da sledi podprti napravi ali jeziku brskalnika. Vnesite podprto kodo jezika, da ga izberete izrecno.
Dejanja in njihovi vnosi · 8
Play

Ni parametrov dejanja

Pause

Ni parametrov dejanja

Toggle

Ni parametrov dejanja

Stop

Ni parametrov dejanja

Seek
secondsnumber · Privzeto: —
Primer vrednosti12
Primer Bubble izrazaSelected Comment's seconds
Uporabi vrednost trenutnega poslovnega zapisa; preveri jo glede na spodnje omejitve.
Set speed
ratenumber · Privzeto: —
Primer vrednosti1.5
Primer Bubble izrazaSpeed Dropdown's value
Uporabi vrednost trenutnega poslovnega zapisa; preveri jo glede na spodnje omejitve.
Set volume
volumenumber · Privzeto: —
Primer vrednosti0.8
Primer Bubble izrazaVolume Slider's value
Uporabi vrednost trenutnega poslovnega zapisa; preveri jo glede na spodnje omejitve.
Reload source

Ni parametrov dejanja

Stanja in dogodki

Stanja

player_status · text

Trenutni rezultat tega dejanja. Uporabite ustrezen dogodek dokončanja pred shranjevanjem uspeha.

is_playing · yes_no

Trenutna vrednost za izbrani element. Preberite jo po povezanem dogodku.

is_loaded · yes_no

Trenutna vrednost za izbrani element. Preberite jo po povezanem dogodku.

is_buffering · yes_no

Trenutna vrednost za izbrani element. Preberite jo po povezanem dogodku.

current_time · number

Trenutna vrednost za izbrani element. Preberite jo po povezanem dogodku.

duration · number

Trenutna vrednost za izbrani element. Preberite jo po povezanem dogodku.

progress · number

Trenutna vrednost za izbrani element. Preberite jo po povezanem dogodku.

playback_rate · number

Trenutna vrednost za izbrani element. Preberite jo po povezanem dogodku.

volume · number

Trenutna vrednost za izbrani element. Preberite jo po povezanem dogodku.

is_looping · yes_no

Trenutna vrednost za izbrani element. Preberite jo po povezanem dogodku.

waveform_available · yes_no

Trenutna vrednost za izbrani element. Preberite jo po povezanem dogodku.

waveform_status · text

Trenutni rezultat tega dejanja. Uporabite ustrezen dogodek dokončanja pred shranjevanjem uspeha.

error_code · text

Podatki o napaki za zadnje dejanje. Prikažite koristno sporočilo in ponudite ustrezen ponovni poskus.

Dogodki

ready

Ko se ta dogodek zgodi, preberite povezane stanje iz istega elementa.

playback_started

Ko se ta dogodek zgodi, preberite povezane stanje iz istega elementa.

playback_paused

Ko se ta dogodek zgodi, preberite povezane stanje iz istega elementa.

playback_ended

Ko se ta dogodek zgodi, preberite povezane stanje iz istega elementa.

seek_completed

Ko se ta dogodek zgodi, preberite povezane stanje iz istega elementa.

rate_changed

Ko se ta dogodek zgodi, preberite povezane stanje iz istega elementa.

player_error

Ko se ta dogodek zgodi, preberite povezane stanje iz istega elementa.

Vprašanja, ki jih postavljajo razvijalci

Ali ustvari valovno obliko?

Ne. Zagotovite dejanske normalizirane vrhove za ta vir; običajen napredek deluje brez njih.

Kako deluje naročnina?

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.

Povezani vodniki

Za pomoč nam povejte, kateri vtičnik in napravo uporabljate, kakšno dejanje ste poskusili in kaj se je zgodilo. Uporabite primer brez osebnih podatkov. Nikoli ne delite svojega ključa ali zasebnih datotek.