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

Xodera Plugins · Bubble Native

Xodera Audio Player Native

Dodajte jasan audio reproduktor lekcijama, glasovnim porukama ili zapisima proizvoda. Omogućite korisnicima slušanje, promjenu brzine i nastavak s njihovog 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 studeni 2026

Praktični primjeri

Glasovne bilješke unutar razgovora podrške

Jednostavna poveznica na datoteku odvodi korisnike iz razgovora i otežava pregledavanje 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. Omogućite korisniku Play/Pause, Seek do korisne točke i Set speed. Povežite `is_active` s otvorenim razgovorom.

Koristite `is_playing`, `current_time` i `duration` za prikaz napretka. Zadržite 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čni lekciju na spremljenoj poziciji

Polaznici trebaju ponovno reproducirati težak odlomak umjesto da ponovno započnu cijelu lekciju.

`source_url = Current Lesson’s audio URL`; `title = Current Lesson’s name`; posljednja pozicija pripada tom polazniku 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. Spremite 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 polaznik razumio ili položio test.

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

Pregledajte audio privitak s vremenski označenim komentarima

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

`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 zapis.

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

Prikažite `current_time` uz vaš uređivač komentara. `waveform_available` govori vašem sučelju jesu li stvarni dostavljeni vrhovi dostupni.

Ograničite ili odbacite zastarjele vremenske oznake u odnosu na trenutni trajanje u vašoj aplikaciji. Kada ne postoje stvarni vrhunci, prikažite obični kontroler napretka umjesto izmišljene audio analize.

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

Što trenutno funkcionira

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 vlastitim 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 valnog oblika za ovu snimku, proslijedite ih u waveform_peaks_json. U suprotnom ostavite prazno.

  3. Kad se pojavi događaj ready, upotrijebite Seek s spremljenim brojem sekundi ako je potrebno. Dopustite korisniku da pritisne Play. Upotrijebite Pause, Seek i Set speed za tipke reproduktora.

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

Dijagram radnog toka — nije snimka aplikacije

Postavite jednom

Stvorite ili odaberite svoj 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. Spremite jednom; zatim koristite radnje ispod. Svaki dodatak u svakom projektu ima svoj ključ.

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

Postavite jednom
  1. Stvorite ili odaberite svoj 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 izradite 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.

Spremite rezultat u svoju aplikaciju

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

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 valnog oblika: 2–2048 vrijednosti između 0 i 1. Podržani audio formati ovise o uređaju. Reproduktor ne snima, ne transkribira niti trajno ne sprema zvuk za izvanmrežnu upotrebu. Reprodukcija u pozadini i na zaključanom zaslonu nije zajamčena.

Postavke, radnje i rezultati

Koristite ove nazive u Bubble. Planirane značajke 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 · Zadano: ""
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 · Zadano: ""
Primjer vrijednosti[0.1,0.4,0.2,0.7]
Primjer Bubble izrazaSelected Message's waveform_peaks_json
Stvarne normalizirane amplitude za ovu snimku; ostavite prazno ako nije dostupno.
titletext · Zadano: ""
Primjer vrijednostiLesson 4 — review
Primjer Bubble izrazaSelected Lesson's name
Vidljivi tekst aplikacije; prazno koristi ugrađeni lokalizirani tekst gdje je podržano. Nema vjerodajnica.
subtitletext · Zadano: ""
Primjer vrijednostiTeacher · today
Primjer Bubble izrazaSelected Message's sender_label
Vidljivi tekst aplikacije; prazno koristi ugrađeni lokalizirani tekst gdje je podržano. Nema vjerodajnica.
playback_ratenumber · Zadano: 1
Primjer vrijednosti1.5
Primjer Bubble izrazaCurrent User's listening_speed
Koristite vrijednost trenutnog poslovnog zapisa; provjerite je li unutar donjih granica.
volumenumber · Zadano: 1
Primjer vrijednosti0.8
Primjer Bubble izrazaVolume Slider's value
Koristite vrijednost trenutnog poslovnog zapisa; provjerite je li unutar donjih granica.
loopyes_no · Zadano: false
Primjer vrijednostino
Primjer Bubble izrazaSelected Lesson's repeat_enabled
Koristite vrijednost trenutnog poslovnog zapisa; provjerite je li unutar donjih granica.
is_activeyes_no · Zadano: true
Primjer vrijednostiyes
Primjer Bubble izrazaGuideHost's view_is_active (your yes/no custom state)
Postavite da je da dok je ovaj prikaz otvoren. Postavite da je ne kada napuštate, kako bi se reprodukcija ili trenutni rad mogli zaustaviti.
disabledyes_no · Zadano: false
Primjer vrijednostino
Primjer Bubble izrazaGuideHost's is_busy (your yes/no custom state)
Onemogućite element dok je vaša aplikacija zauzeta ili je ova radnja nedostupna.
ui_text_jsontext · Zadano: ""
Primjer vrijednosti{}
Primjer Bubble izrazaApp Settings' player_labels_json (supported keys only)
Opcionalni JSON s podržanim oznakama gumba. Ostavite prazno za korištenje ugrađenog teksta.
languagetext · Zadano: "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 za izričitu odabir.
Radnje i njihovi ulazi · 8
Play

Nema parametara radnje

Pause

Nema parametara radnje

Toggle

Nema parametara radnje

Stop

Nema parametara radnje

Seek
secondsnumber · Zadano: —
Primjer vrijednosti12
Primjer Bubble izrazaSelected Comment's seconds
Koristite vrijednost trenutnog poslovnog zapisa; provjerite je li unutar donjih granica.
Set speed
ratenumber · Zadano: —
Primjer vrijednosti1.5
Primjer Bubble izrazaSpeed Dropdown's value
Koristite vrijednost trenutnog poslovnog zapisa; provjerite je li unutar donjih granica.
Set volume
volumenumber · Zadano: —
Primjer vrijednosti0.8
Primjer Bubble izrazaVolume Slider's value
Koristite vrijednost trenutnog poslovnog zapisa; provjerite je li unutar donjih granica.
Reload source

Nema parametara radnje

Stanja i događaji

Stanja

player_status · text

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

is_playing · yes_no

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

is_loaded · yes_no

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

is_buffering · yes_no

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

current_time · number

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

duration · number

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

progress · number

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

playback_rate · number

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

volume · number

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

is_looping · yes_no

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

waveform_available · yes_no

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

waveform_status · text

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

error_code · text

Informacije o pogreš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 povezane stanje iz istog elementa.

playback_started

Kada se ovaj događaj dogodi, pročitajte povezane stanje iz istog elementa.

playback_paused

Kada se ovaj događaj dogodi, pročitajte povezane stanje iz istog elementa.

playback_ended

Kada se ovaj događaj dogodi, pročitajte povezane stanje iz istog elementa.

seek_completed

Kada se ovaj događaj dogodi, pročitajte povezane stanje iz istog elementa.

rate_changed

Kada se ovaj događaj dogodi, pročitajte povezane stanje iz istog elementa.

player_error

Kada se ovaj događaj dogodi, pročitajte povezane stanje iz istog elementa.

Pitanja koja programeri postavljaju

Stvara li to valni oblik?

Ne. Dostavite stvarne normalizirane vrhove za taj izvor; običan napredak funkcionira 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 priručnici

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