Audio Player interfejs sa primerom naslova.
Audio Player interfejs sa primerom naslova.
← Svi izvorni vodiči

Xodera Plugins · Bubble Native

Xodera Audio Player Native

Dodajte jasan audio plejer lekcijama, glasovnim porukama ili zapisima proizvoda. Omogućite korisnicima da slušaju, menjaju brzinu i nastave od sačuvanog 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 novembar 2026

Praktični primeri

Glasovne beleške u okviru razgovora za podršku

Običan link ka fajlu 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 plejer u detalj odabrane poruke. Dozvolite korisniku Play/Pause, Seek do korisne tačke i Set speed. Povežite `is_active` sa 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 da ažurira 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 čuva napredak slušanja.

Nastavite jezičku lekciju na sačuvanoj poziciji

Polaznici moraju ponovo da reprodukuju težak odlomak umesto da ponovo započnu celu lekciju.

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

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

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

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

Samo reprodukcija. Vaša aplikacija čuva napredak slušanja.

Pregledajte audio prilog sa komentarima označenim vremenskim oznakama

Urednici ili treneri moraju da skoče iz komentara na relevantni trenutak u snimku.

`source_url = Selected Review’s recording URL`; svaki komentar u aplikaciji čuva svoju vrednost sekundi; opciono `waveform_peaks_json` sadrži stvarne vrhove za isti snimak.

Kliknite na komentar → Seek na njegove sekunde → Play. Pri promeni izvora, zamenite 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‑u da li su stvarni dostavljeni vrhovi dostupni.

Ограничите или одбаците застареле временске ознаке у односу на тренутно трајање у вашој апликацији. Када не постоје прави врхунци, прикажите уобичајени контролу напретка уместо измишљене аудио анализе.

Samo reprodukcija. Vaša aplikacija čuva napredak slušanja.

Šta trenutno funkcioniše

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.

Izgradite radni tok

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

Ovi primeri koriste zapise aplikacije kao što su Lesson, Message i Order. Zamenite ih svojim tipovima podataka i imenima elemenata. Primer adresa medija mora biti zamenjen vašim fajlovima.

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

  3. Kada se dogodi događaj ready, koristite Seek sa sačuvanim brojem sekundi po potrebi. 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 izabranu poruku ili lekciju. Postavite is_active na stanje da li je ovaj prikaz otvoren.

Dijagram radnog toka — nije snimak ekrana aplikacije

Konfigurišite jednom

Kreirajte ili izaberite vaš Bubble projekat aplikacije u BestPlugins → Dashboard → Plugins. Izaberite Xodera Audio Player Native, kopirajte njegov ključ, zatim otvorite Bubble → Plugins → Xodera Audio Player Native i nalepite ga u licensing_api_key. Sačuvajte jednom; zatim koristite akcije ispod. Svaki dodatak u svakom projektu ima svoj ključ.

Koristite direktnu adresu audio‑fajla koju aplikacija može da otvori. Puštanje audio zapisa ne zahteva pristup mikrofonu ili kameri.

Konfigurišite jednom
  1. Kreirajte ili izaberite vaš Bubble projekat aplikacije na BestPlugins → Dashboard → Plugins.
  2. Izaberite 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, izaberite vaše podatke aplikacije i izgradite tok rada 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

Primer 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, umesto pri svakom ažuriranju ekrana.

Neuspeh, otkazivanje i oporavak

Na player_error, prikažite error_code i ponudite Reload source. Zadržite zapis poruke ili lekcije. Kada se izabere druga snimka, učitajte njen sačuvani položaj. Povratak na prikaz ne pokreće reprodukciju automatski.

Mogućnosti i ograničenja

Brzine reprodukcije: 1, 1.5 i 2. Jačina zvuka: 0–1. Podaci talasnog oblika: 2–2048 vrednosti između 0 i 1. Podržani audio formati zavise od uređaja. Plejer ne snima, ne transkribuje niti trajno ne čuva audio za offline upotrebu. Reprodukcija u pozadini i na zaključanom ekranu nije garantovana.

Podešavanja, akcije i rezultati

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

Dostupna beta podešavanja

Podešavanja 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

Akcije i njihovi ulazi

PlayPauseToggleStopSeekSet speedSet volumeReload source
Podešavanja elementa · 11
source_urltext · Podrazumevano: ""
Primer vrednostihttps://bestplugins.online/native-samples/lesson.mp3
Primer Bubble izrazaSelected Message's audio_url
Адреса изабране аудио, видео или слике датотеке. Користите тип датотеке који овај прикључак подржава.
waveform_peaks_jsontext · Podrazumevano: ""
Primer vrednosti[0.1,0.4,0.2,0.7]
Primer Bubble izrazaSelected Message's waveform_peaks_json
Реална нормализована вредност амплитуде за овај запис; оставите празно ако није доступно.
titletext · Podrazumevano: ""
Primer vrednostiLesson 4 — review
Primer Bubble izrazaSelected Lesson's name
Видљиви текст апликације; празно користи уграђени локализовани текст где је подржан. Без акредитива.
subtitletext · Podrazumevano: ""
Primer vrednostiTeacher · today
Primer Bubble izrazaSelected Message's sender_label
Видљиви текст апликације; празно користи уграђени локализовани текст где је подржан. Без акредитива.
playback_ratenumber · Podrazumevano: 1
Primer vrednosti1.5
Primer Bubble izrazaCurrent User's listening_speed
Користите вредност тренутног пословног записа; проверите је у односу на доње границе.
volumenumber · Podrazumevano: 1
Primer vrednosti0.8
Primer Bubble izrazaVolume Slider's value
Користите вредност тренутног пословног записа; проверите је у односу на доње границе.
loopyes_no · Podrazumevano: false
Primer vrednostino
Primer Bubble izrazaSelected Lesson's repeat_enabled
Користите вредност тренутног пословног записа; проверите је у односу на доње границе.
is_activeyes_no · Podrazumevano: true
Primer vrednostiyes
Primer Bubble izrazaGuideHost's view_is_active (your yes/no custom state)
Поставите „да“ док је овај преглед отворен. Поставите „не“ приликом напуштања, како би репродукција или тренутни рад могли да се зауставе.
disabledyes_no · Podrazumevano: false
Primer vrednostino
Primer Bubble izrazaGuideHost's is_busy (your yes/no custom state)
Онемогућите елемент док је ваша апликација заузета или док је ова радња недоступна.
ui_text_jsontext · Podrazumevano: ""
Primer vrednosti{}
Primer Bubble izrazaApp Settings' player_labels_json (supported keys only)
Опционални JSON са подржаним ознакама дугмади. Оставите празно да се користи уграђени текст.
languagetext · Podrazumevano: "auto"
Primer vrednostiuk
Primer Bubble izrazaCurrent User's preferred_language
Поставите language=auto да прати подржани уређај или језик прегледача. Унесите подржани код језика да бисте га изричито изабрали.
Akcije i njihovi ulazi · 8
Play

Nema parametara akcije

Pause

Nema parametara akcije

Toggle

Nema parametara akcije

Stop

Nema parametara akcije

Seek
secondsnumber · Podrazumevano: —
Primer vrednosti12
Primer Bubble izrazaSelected Comment's seconds
Користите вредност тренутног пословног записа; проверите је у односу на доње границе.
Set speed
ratenumber · Podrazumevano: —
Primer vrednosti1.5
Primer Bubble izrazaSpeed Dropdown's value
Користите вредност тренутног пословног записа; проверите је у односу на доње границе.
Set volume
volumenumber · Podrazumevano: —
Primer vrednosti0.8
Primer Bubble izrazaVolume Slider's value
Користите вредност тренутног пословног записа; проверите је у односу на доње границе.
Reload source

Nema parametara akcije

Stanja i događaji

Stanja

player_status · text

Текући резултат ове радње. Користите одговарајући догађај завршетка пре чувања успеха.

is_playing · yes_no

Текућа вредност за изабрану ставку. Прочитајте је након повезаног догађаја.

is_loaded · yes_no

Текућа вредност за изабрану ставку. Прочитајте је након повезаног догађаја.

is_buffering · yes_no

Текућа вредност за изабрану ставку. Прочитајте је након повезаног догађаја.

current_time · number

Текућа вредност за изабрану ставку. Прочитајте је након повезаног догађаја.

duration · number

Текућа вредност за изабрану ставку. Прочитајте је након повезаног догађаја.

progress · number

Текућа вредност за изабрану ставку. Прочитајте је након повезаног догађаја.

playback_rate · number

Текућа вредност за изабрану ставку. Прочитајте је након повезаног догађаја.

volume · number

Текућа вредност за изабрану ставку. Прочитајте је након повезаног догађаја.

is_looping · yes_no

Текућа вредност за изабрану ставку. Прочитајте је након повезаног догађаја.

waveform_available · yes_no

Текућа вредност за изабрану ставку. Прочитајте је након повезаног догађаја.

waveform_status · text

Текући резултат ове радње. Користите одговарајући догађај завршетка пре чувања успеха.

error_code · text

Информације о грешци за последњу радњу. Прикажите корисну поруку и понудите релевантно поновно покушавање.

Događaji

ready

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

playback_started

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

playback_paused

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

playback_ended

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

seek_completed

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

rate_changed

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

player_error

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

Pitanja koja programeri postavljaju

Da li to kreira talasni oblik?

Ne. Dostavite stvarne normalizovane vrhove za taj izvor; običan napredak funkcioniše bez njih.

Kako funkcioniše 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 dodatak i uređaj koristite, akciju koju ste pokušali i šta se desilo. Koristite primer bez ličnih podataka. Nikada ne delite vaš ključ ili privatne fajlove.