Audio Player interfejs s primjerom naslova.
Audio Player interfejs s primjerom naslova.
← Svi izvorni vodiči

Xodera Plugins · Bubble Native

Xodera Audio Player Native

Dodajte jasan audio plejer u lekcije, glasovne poruke ili zapise proizvoda. Omogućite korisnicima da slušaju, mijenjaju brzinu i nastave od spremljenog mjesta.

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 novembar 2026

Praktični primjeri

Glasovne bilješke u razgovoru podrške

Obična poveznica na datoteku odvodi korisnike iz razgovora i otežava pregled dugih odgovora.

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

Postavite reproduktor u detalj odabrane poruke. Neka korisnik Play/Pause, Seek do korisne tačke i Set speed. Povežite `is_active` s otvorenim razgovorom.

Koristite `is_playing`, `current_time` i `duration` za prikaz napretka. Sačuvajte Message ID u aplikaciji kako kasni događaj ne bi mogao ažurirati drugi razgovor.

Na `player_error`, prikažite `error_code` i ponudite Reload source; sačuvajte poruku i nikada je ne označavajte kao preslušanu nakon greške.

Samo reprodukcija. Vaša aplikacija sprema napredak slušanja.

Nastavite jezičku lekciju na spremljenoj poziciji

Učenici trebaju ponovo reproducirati težak odlomak umjesto da ponovo započnu cijelu lekciju.

`source_url = Current Lesson’s audio URL`; `title = Current Lesson’s name`; posljednja pozicija pripada tom učeniku i lekciji u vašoj bazi podataka.

Nakon `ready` za trenutnu lekciju, Seek na spremljene sekunde i čekajte da korisnik Play. Koristite Set speed za sporije slušanje. Sačuvajte napredak vlastitim radnim tokom aplikacije.

Pročitajte `current_time` i `duration`. Na `playback_ended`, vaša aplikacija može zabilježiti prekretnicu slušanja za trenutni Lesson.

Ako se izvor promijeni, odbacite staru poziciju dok se lekcija ne učita. Nemojte smatrati završetak slušanja dokazom da je učenik razumio ili položio test.

Samo reprodukcija. Vaša aplikacija sprema napredak slušanja.

Pregledajte audio prilog s vremenski označenim komentarima

Urednici ili treneri trebaju skočiti iz komentara na relevantni trenutak u snimku.

`source_url = Selected Review’s recording URL`; svaki komentar u aplikaciji pohranjuje svoju vrijednost sekundi; opcionalni `waveform_peaks_json` sadrži stvarne vrhove za isti snimak.

Kliknite na komentar → Seek na njegove sekunde → Play. Pri promjeni izvora, zamijenite ili očistite vrhove i ponovo povežite odabrani pregled.

Prikažite `current_time` pored vašeg sastavljača komentara. `waveform_available` govori vašem UI‑ju da li su stvarni dostavljeni vrhovi dostupni.

Ograniči ili odbaci zastarjele vremenske oznake u odnosu na trenutnu dužinu u aplikaciji. Kada ne postoje stvarni vrhunci, prikaži običnu kontrolu napretka umjesto izmišljene audio analize.

Samo reprodukcija. Vaša aplikacija sprema napredak slušanja.

Šta trenutno radi

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.

Izradite radni tok

Koristite dostupne beta radnje ispod i testirajte rezultat na svojim ciljanim uređajima.

Ovi primjeri koriste zapise aplikacije poput Lesson, Message i Order. Zamijenite ih svojim tipovima podataka i nazivima elemenata. Primjer adresa medija mora biti zamijenjen vašim vlastitim datotekama.

  1. Dodajte audio element. Postavite source_url = Selected Message's audio_url, title = Selected Message's sender_label i subtitle = Selected Message's date_label.

  2. Ako imate stvarne podatke o obliku talasa za ovu snimku, proslijedite ih u waveform_peaks_json. U suprotnom ostavite prazno.

  3. Kada se dogodi događaj ready, koristite Seek sa spremljenim brojem sekundi ako je potrebno. Dozvolite korisniku da pritisne Play. Koristite Pause, Seek i Set speed za dugmad plejera.

  4. Prikažite current_time i duration. Na playback_ended, sačuvajte napredak slušanja za odabranu poruku ili lekciju. Postavite is_active na stanje da li je ovaj prikaz otvoren.

Dijagram radnog toka — nije snimak ekrana aplikacije

Jednom konfigurirajte

Kreirajte ili odaberite vaš Bubble projekt aplikacije u BestPlugins → Dashboard → Plugins. Odaberite Xodera Audio Player Native, kopirajte njegov ključ, zatim otvorite Bubble → Plugins → Xodera Audio Player Native i zalijepite ga u licensing_api_key. Sačuvajte jednom; zatim koristite radnje ispod. Svaki dodatak u svakom projektu ima svoj ključ.

Koristite direktnu adresu audio‑datoteke koju aplikacija može otvoriti. Reprodukcija zvuka ne zahtijeva pristup mikrofonu ili kameri.

Jednom konfigurirajte
  1. Kreirajte ili odaberite vaš Bubble projekt aplikacije na BestPlugins → Dashboard → Plugins.
  2. Odaberite ovaj dodatak i kopirajte njegov ključ projekta.
  3. Open Bubble → Plugins → this plugin. Paste its project key into licensing_api_key and save.
  4. Dodajte element, odaberite svoje podatke aplikacije i izgradite radni tok ispod.
  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.
Instalacija i pretplata

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.

Sačuvajte rezultat u vašoj aplikaciji

Primjer ListeningProgress: owner = Current User, lesson = Selected Lesson, seconds = Audio Player's current_time, duration = Audio Player's duration. Sačuvajte kada korisnik pauzira ili napusti lekciju, umjesto pri svakom ažuriranju ekrana.

Neuspjeh, otkazivanje i oporavak

Na player_error, prikažite error_code i ponudite Reload source. Zadržite zapis poruke ili lekcije. Kada se odabere druga snimka, učitajte njezinu spremljenu poziciju. Povratak na prikaz ne pokreće reprodukciju automatski.

Mogućnosti i ograničenja

Brzine reprodukcije: 1, 1.5 i 2. Glasnoća: 0–1. Podaci o obliku talasa: 2–2048 vrijednosti između 0 i 1. Podržani audio formati ovise o uređaju. Plejer ne snima, ne transkribuje niti trajno ne sprema audio za offline korištenje. Reprodukcija u pozadini i na zaključanom ekranu nije zajamčena.

Postavke, radnje i rezultati

Koristite ova imena u Bubble. Planirane funkcije su označene odvojeno.

Dostupna beta podešavanja

Postavke 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

Događaji

readyplayback_startedplayback_pausedplayback_endedseek_completedrate_changedplayer_error

Radnje i njihovi ulazi

PlayPauseToggleStopSeekSet speedSet volumeReload source
Postavke elementa · 11
source_urltext · Podrazumevano: ""
Primjer vrijednostihttps://bestplugins.online/native-samples/lesson.mp3
Primjer Bubble izrazaSelected Message's audio_url
Adresa odabrane audio, video ili slikovne datoteke. Koristite tip datoteke koji ovaj dodatak podržava.
waveform_peaks_jsontext · Podrazumevano: ""
Primjer vrijednosti[0.1,0.4,0.2,0.7]
Primjer Bubble izrazaSelected Message's waveform_peaks_json
Stvarne normalizirane amplitude vrijednosti za ovu snimku; ostavite prazno ako nisu dostupne.
titletext · Podrazumevano: ""
Primjer vrijednostiLesson 4 — review
Primjer Bubble izrazaSelected Lesson's name
Vidljivi tekst aplikacije; prazno koristi ugrađenu lokaliziranu kopiju gdje je podržano. Bez vjerodajnica.
subtitletext · Podrazumevano: ""
Primjer vrijednostiTeacher · today
Primjer Bubble izrazaSelected Message's sender_label
Vidljivi tekst aplikacije; prazno koristi ugrađenu lokaliziranu kopiju gdje je podržano. Bez vjerodajnica.
playback_ratenumber · Podrazumevano: 1
Primjer vrijednosti1.5
Primjer Bubble izrazaCurrent User's listening_speed
Koristite vrijednost trenutnog poslovnog zapisa; provjerite je prema donjim ograničenjima.
volumenumber · Podrazumevano: 1
Primjer vrijednosti0.8
Primjer Bubble izrazaVolume Slider's value
Koristite vrijednost trenutnog poslovnog zapisa; provjerite je prema donjim ograničenjima.
loopyes_no · Podrazumevano: false
Primjer vrijednostino
Primjer Bubble izrazaSelected Lesson's repeat_enabled
Koristite vrijednost trenutnog poslovnog zapisa; provjerite je prema donjim ograničenjima.
is_activeyes_no · Podrazumevano: true
Primjer vrijednostiyes
Primjer Bubble izrazaGuideHost's view_is_active (your yes/no custom state)
Postavite da dok je ovaj prikaz otvoren. Postavite ne pri napuštanju, kako reprodukcija ili trenutni rad mogu stati.
disabledyes_no · Podrazumevano: false
Primjer vrijednostino
Primjer Bubble izrazaGuideHost's is_busy (your yes/no custom state)
Onemogućite element dok je aplikacija zauzeta ili je ova radnja nedostupna.
ui_text_jsontext · Podrazumevano: ""
Primjer vrijednosti{}
Primjer Bubble izrazaApp Settings' player_labels_json (supported keys only)
Opcionalni JSON s podržanim oznakama dugmadi. Ostavite prazno da koristite ugrađeni tekst.
languagetext · Podrazumevano: "auto"
Primjer vrijednostiuk
Primjer Bubble izrazaCurrent User's preferred_language
Postavite language=auto da prati podržani uređaj ili jezik preglednika. Unesite podržani kod jezika da ga izričito odaberete.
Radnje i njihovi ulazi · 8
Play

Nema parametara akcije

Pause

Nema parametara akcije

Toggle

Nema parametara akcije

Stop

Nema parametara akcije

Seek
secondsnumber · Podrazumevano: —
Primjer vrijednosti12
Primjer Bubble izrazaSelected Comment's seconds
Koristite vrijednost trenutnog poslovnog zapisa; provjerite je prema donjim ograničenjima.
Set speed
ratenumber · Podrazumevano: —
Primjer vrijednosti1.5
Primjer Bubble izrazaSpeed Dropdown's value
Koristite vrijednost trenutnog poslovnog zapisa; provjerite je prema donjim ograničenjima.
Set volume
volumenumber · Podrazumevano: —
Primjer vrijednosti0.8
Primjer Bubble izrazaVolume Slider's value
Koristite vrijednost trenutnog poslovnog zapisa; provjerite je prema donjim ograničenjima.
Reload source

Nema parametara akcije

Stanja i događaji

Stanja

player_status · text

Trenutni rezultat ove radnje. Koristite odgovarajući događaj završetka prije spremanja uspjeha.

is_playing · yes_no

Trenutna vrijednost odabranog elementa. Pročitajte je nakon povezanog događaja.

is_loaded · yes_no

Trenutna vrijednost odabranog elementa. Pročitajte je nakon povezanog događaja.

is_buffering · yes_no

Trenutna vrijednost odabranog elementa. Pročitajte je nakon povezanog događaja.

current_time · number

Trenutna vrijednost odabranog elementa. Pročitajte je nakon povezanog događaja.

duration · number

Trenutna vrijednost odabranog elementa. Pročitajte je nakon povezanog događaja.

progress · number

Trenutna vrijednost odabranog elementa. Pročitajte je nakon povezanog događaja.

playback_rate · number

Trenutna vrijednost odabranog elementa. Pročitajte je nakon povezanog događaja.

volume · number

Trenutna vrijednost odabranog elementa. Pročitajte je nakon povezanog događaja.

is_looping · yes_no

Trenutna vrijednost odabranog elementa. Pročitajte je nakon povezanog događaja.

waveform_available · yes_no

Trenutna vrijednost odabranog elementa. Pročitajte je nakon povezanog događaja.

waveform_status · text

Trenutni rezultat ove radnje. Koristite odgovarajući događaj završetka prije spremanja uspjeha.

error_code · text

Informacije o grešci za posljednju radnju. Prikažite korisnu poruku i ponudite odgovarajući pokušaj ponovo.

Događaji

ready

Kada se ovaj događaj dogodi, pročitajte povezana stanja iz istog elementa.

playback_started

Kada se ovaj događaj dogodi, pročitajte povezana stanja iz istog elementa.

playback_paused

Kada se ovaj događaj dogodi, pročitajte povezana stanja iz istog elementa.

playback_ended

Kada se ovaj događaj dogodi, pročitajte povezana stanja iz istog elementa.

seek_completed

Kada se ovaj događaj dogodi, pročitajte povezana stanja iz istog elementa.

rate_changed

Kada se ovaj događaj dogodi, pročitajte povezana stanja iz istog elementa.

player_error

Kada se ovaj događaj dogodi, pročitajte povezana stanja iz istog elementa.

Pitanja koja programeri postavljaju

Da li kreira valni oblik?

Ne. Dostavite stvarne normalizirane vrhove za taj izvor; običan napredak radi bez njih.

Kako funkcionira pretplata?

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 vodiči

Za pomoć, recite nam koji plugin i uređaj koristite, koju radnju ste pokušali i šta se dogodilo. Koristite primjer bez ličnih podataka. Nikada ne dijelite svoj ključ ili privatne datoteke.