Xodera Plugins · Bubble Native
Xodera Audio Player Native
Pridajte čistý audio prehrávač do lekcií, hlasových správ alebo záznamov produktov. Nechajte ľudí počúvať, meniť rýchlosť a pokračovať od ich uloženého miesta.
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.
Dokumentácia skontrolovaná 6 november 2026
Praktické príklady
Hlasové poznámky v rámci konverzácie podpory
Jednoduchý odkaz na súbor odosiela používateľov mimo konverzácie a sťažuje prehľad dlhých odpovedí.
`source_url = Selected Message’s audio URL`; `title = Selected Message’s sender label`; `subtitle = Selected Message’s timestamp`.
Umiestnite prehrávač do podrobností vybranej správy. Nech používateľ Play/Pause, Seek na užitočný bod a Set speed. Prepojte `is_active` s otvorenou konverzáciou.
Použite `is_playing`, `current_time` a `duration` na zobrazenie postupu. Uchovajte ID Message vo svojej aplikácii, aby neskoršia udalosť nemohla aktualizovať inú konverzáciu.
Pri `player_error` zobrazte `error_code` a ponúknite Reload source; zachovajte správu a nikdy ju neoznačte ako vypočutú po chybe.
Iba prehrávanie. Vaša aplikácia ukladá postup počúvania.
Pokračujte v jazykovej lekcii od uloženého miesta
Študenti potrebujú prehrať ťažký úsek namiesto toho, aby reštartovali celú lekciu.
`source_url = Current Lesson’s audio URL`; `title = Current Lesson’s name`; posledná pozícia patrí tomuto študentovi a lekcii vo vašej databáze.
Po `ready` pre aktuálnu lekciu Seek na uložené sekundy a počkajte, kým používateľ Play. Použite Set speed pre pomalšie počúvanie. Uložte postup pomocou vlastného pracovného postupu aplikácie.
Prečítajte `current_time` a `duration`. Pri `playback_ended` môže vaša aplikácia zaznamenať míľnik počúvania pre aktuálny Lesson.
Ak sa zdroj zmenil, zahodte starú pozíciu, kým sa načíta daná lekcia. Nepovažujte dokončenie počúvania za dôkaz, že študent pochopil alebo absolvoval test.
Iba prehrávanie. Vaša aplikácia ukladá postup počúvania.
Preveriť audio prílohu s časovo označenými komentármi
Editorom alebo trénerom je potrebné preskočiť z komentára na relevantný okamih v nahrávke.
`source_url = Selected Review’s recording URL`; každý komentár vlastnený aplikáciou ukladá svoju vlastnú hodnotu sekúnd; voliteľný `waveform_peaks_json` obsahuje skutočné špičky pre tú istú nahrávku.
Kliknite na komentár → Seek na jeho sekundy → Play. Pri zmene zdroja nahraďte alebo vymažte špičky a znova prepojte vybranú recenziu.
Zobrazte `current_time` vedľa vášho tvorcu komentárov. `waveform_available` informuje vaše UI, či sú k dispozícii skutočné poskytnuté špičky.
Obmedziť alebo odmietnuť zastarané časové značky voči aktuálnej dĺžke vo vašej aplikácii. Ak neexistujú skutočné špičky, zobrazte bežný ovládací prvok postupu namiesto vymyslenej analýzy zvuku.
Iba prehrávanie. Vaša aplikácia ukladá postup počúvania.
Čo funguje teraz
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.
Vytvorte pracovný postup
Použite dostupné beta akcie nižšie a otestujte výsledok na svojich cieľových zariadeniach.
Tieto príklady používajú záznamy aplikácie, ako sú Lesson, Message a Order. Nahraďte ich vlastnými typmi údajov a názvami prvkov. Príkladové mediálne adresy musia byť nahradené vašimi vlastnými súbormi.
Pridajte audio element. Nastavte source_url = Selected Message's audio_url, title = Selected Message's sender_label a subtitle = Selected Message's date_label.
Ak máte skutočné dáta vlnovej formy pre toto nahrávanie, odovzdajte ich v waveform_peaks_json. Inak nechajte prázdne.
Keď nastane udalosť ready, použite Seek s uloženým počtom sekúnd, ak je to potrebné. Nechajte používateľa stlačiť Play. Použite Pause, Seek a Set speed pre tlačidlá prehrávača.
Zobrazte current_time a duration. Na playback_ended uložte pokrok počúvania pre vybranú správu alebo lekciu. Nastavte is_active na to, či je toto zobrazenie otvorené.
Nastavte raz
Vytvorte alebo vyberte svoj Bubble projekt v BestPlugins → Dashboard → Plugins. Vyberte Xodera Audio Player Native, skopírujte jeho kľúč a potom otvorte Bubble → Plugins → Xodera Audio Player Native a vložte ho do licensing_api_key. Uložte raz; potom použite akcie nižšie. Každý plugin v každom projekte má svoj vlastný kľúč.
Použite priamu adresu audio súboru, ktorú aplikácia dokáže otvoriť. Prehrávanie audia nevyžaduje prístup k mikrofónu ani kamere.
Nastavte raz
- Vytvorte alebo vyberte svoj Bubble projekt na BestPlugins → Dashboard → Plugins.
- Vyberte tento plugin a skopírujte jeho projektový kľúč.
- Open Bubble → Plugins → this plugin. Paste its project key into licensing_api_key and save.
- Pridajte element, vyberte svoje údaje aplikácie a zostavte pracovný postup nižšie.
- 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.
Inštalácia a predplatné
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.
Uložte výsledok do svojej aplikácie
Príklad ListeningProgress: owner = Current User, lesson = Selected Lesson, seconds = Audio Player's current_time, duration = Audio Player's duration. Uložte, keď používateľ pozastaví alebo opustí lekciu, namiesto pri každej aktualizácii obrazovky.
Zlyhanie, zrušenie a obnovenie
Na player_error zobrazte error_code a ponúknite Reload source. Zachovajte správu alebo záznam lekcie. Keď je vybrané iné nahrávanie, načítajte jeho vlastnú uloženú pozíciu. Návrat do zobrazenia nespustí prehrávanie automaticky.
Možnosti a limity
Rýchlosti prehrávania: 1, 1.5 a 2. Hlasitosť: 0–1. Dáta vlnovej formy: 2–2048 hodnoty medzi 0 a 1. Podporované audio formáty závisia od zariadenia. Prehrávač nenahráva, neprepisuje ani trvalo neukladá audio pre offline použitie. Prehrávanie na pozadí a pri zamknutej obrazovke nie je zaručené.
Nastavenia, akcie a výsledky
Použite tieto názvy v Bubble. Plánované funkcie sú označené samostatne.
Dostupné beta nastavenia
Nastavenia prvku
source_url · textwaveform_peaks_json · texttitle · textsubtitle · textplayback_rate · numbervolume · numberloop · yes_nois_active · yes_nodisabled · yes_noui_text_json · textlanguage · textStavy
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 · textUdalosti
readyplayback_startedplayback_pausedplayback_endedseek_completedrate_changedplayer_errorAkcie a ich vstupy
PlayPauseToggleStopSeekSet speedSet volumeReload sourceNastavenia prvku · 11
source_urltext · Predvolené: ""- Ukážková hodnota
https://bestplugins.online/native-samples/lesson.mp3 - Príklad Bubble výraz
Selected Message's audio_url - Adresa vybraného audio, video alebo obrazového súboru. Použite typ súboru, ktorý tento plugin podporuje.
waveform_peaks_jsontext · Predvolené: ""- Ukážková hodnota
[0.1,0.4,0.2,0.7] - Príklad Bubble výraz
Selected Message's waveform_peaks_json - Skutočné normalizované hodnoty amplitúdy pre toto nahrávanie; ponechajte prázdne, ak nie sú k dispozícii.
titletext · Predvolené: ""- Ukážková hodnota
Lesson 4 — review - Príklad Bubble výraz
Selected Lesson's name - Viditeľný text aplikácie; prázdne použije vstavanú lokalizovanú verziu, ak je podporovaná. Žiadne poverenia.
subtitletext · Predvolené: ""- Ukážková hodnota
Teacher · today - Príklad Bubble výraz
Selected Message's sender_label - Viditeľný text aplikácie; prázdne použije vstavanú lokalizovanú verziu, ak je podporovaná. Žiadne poverenia.
playback_ratenumber · Predvolené: 1- Ukážková hodnota
1.5 - Príklad Bubble výraz
Current User's listening_speed - Použite hodnotu aktuálneho obchodného záznamu; overte ju voči nižšie uvedeným limitom.
volumenumber · Predvolené: 1- Ukážková hodnota
0.8 - Príklad Bubble výraz
Volume Slider's value - Použite hodnotu aktuálneho obchodného záznamu; overte ju voči nižšie uvedeným limitom.
loopyes_no · Predvolené: false- Ukážková hodnota
no - Príklad Bubble výraz
Selected Lesson's repeat_enabled - Použite hodnotu aktuálneho obchodného záznamu; overte ju voči nižšie uvedeným limitom.
is_activeyes_no · Predvolené: true- Ukážková hodnota
yes - Príklad Bubble výraz
GuideHost's view_is_active (your yes/no custom state) - Nastavte áno, kým je tento pohľad otvorený. Nastavte nie pri odchode, aby sa prehrávanie alebo aktuálna práca mohla zastaviť.
disabledyes_no · Predvolené: false- Ukážková hodnota
no - Príklad Bubble výraz
GuideHost's is_busy (your yes/no custom state) - Zakážte prvok, keď je vaša aplikácia zaneprázdnená alebo je táto akcia nedostupná.
ui_text_jsontext · Predvolené: ""- Ukážková hodnota
{} - Príklad Bubble výraz
App Settings' player_labels_json (supported keys only) - Voliteľný JSON s podporovanými popiskami tlačidiel. Ponechajte prázdne pre použitie vstavaného textu.
languagetext · Predvolené: "auto"- Ukážková hodnota
uk - Príklad Bubble výraz
Current User's preferred_language - Nastavte language=auto, aby sledoval podporované zariadenie alebo jazyk prehliadača. Zadajte podporovaný kód jazyka pre jeho explicitný výber.
Akcie a ich vstupy · 8
Play
Žiadne parametre akcie
Pause
Žiadne parametre akcie
Toggle
Žiadne parametre akcie
Stop
Žiadne parametre akcie
Seek
secondsnumber · Predvolené: —- Ukážková hodnota
12 - Príklad Bubble výraz
Selected Comment's seconds - Použite hodnotu aktuálneho obchodného záznamu; overte ju voči nižšie uvedeným limitom.
Set speed
ratenumber · Predvolené: —- Ukážková hodnota
1.5 - Príklad Bubble výraz
Speed Dropdown's value - Použite hodnotu aktuálneho obchodného záznamu; overte ju voči nižšie uvedeným limitom.
Set volume
volumenumber · Predvolené: —- Ukážková hodnota
0.8 - Príklad Bubble výraz
Volume Slider's value - Použite hodnotu aktuálneho obchodného záznamu; overte ju voči nižšie uvedeným limitom.
Reload source
Žiadne parametre akcie
Stavy a udalosti
Stavy
player_status · textAktuálny výsledok tejto akcie. Použite zodpovedajúcu udalosť dokončenia pred uložením úspechu.
is_playing · yes_noAktuálna hodnota vybranej položky. Prečítajte ju po súvisiacej udalosti.
is_loaded · yes_noAktuálna hodnota vybranej položky. Prečítajte ju po súvisiacej udalosti.
is_buffering · yes_noAktuálna hodnota vybranej položky. Prečítajte ju po súvisiacej udalosti.
current_time · numberAktuálna hodnota vybranej položky. Prečítajte ju po súvisiacej udalosti.
duration · numberAktuálna hodnota vybranej položky. Prečítajte ju po súvisiacej udalosti.
progress · numberAktuálna hodnota vybranej položky. Prečítajte ju po súvisiacej udalosti.
playback_rate · numberAktuálna hodnota vybranej položky. Prečítajte ju po súvisiacej udalosti.
volume · numberAktuálna hodnota vybranej položky. Prečítajte ju po súvisiacej udalosti.
is_looping · yes_noAktuálna hodnota vybranej položky. Prečítajte ju po súvisiacej udalosti.
waveform_available · yes_noAktuálna hodnota vybranej položky. Prečítajte ju po súvisiacej udalosti.
waveform_status · textAktuálny výsledok tejto akcie. Použite zodpovedajúcu udalosť dokončenia pred uložením úspechu.
error_code · textInformácie o chybe poslednej akcie. Zobrazte užitočnú správu a ponúknite príslušný opätovný pokus.
Udalosti
readyKeď nastane táto udalosť, prečítajte súvisiace stavy z rovnakého prvku.
playback_startedKeď nastane táto udalosť, prečítajte súvisiace stavy z rovnakého prvku.
playback_pausedKeď nastane táto udalosť, prečítajte súvisiace stavy z rovnakého prvku.
playback_endedKeď nastane táto udalosť, prečítajte súvisiace stavy z rovnakého prvku.
seek_completedKeď nastane táto udalosť, prečítajte súvisiace stavy z rovnakého prvku.
rate_changedKeď nastane táto udalosť, prečítajte súvisiace stavy z rovnakého prvku.
player_errorKeď nastane táto udalosť, prečítajte súvisiace stavy z rovnakého prvku.
Otázky, ktoré kladú vývojári
Vytvára to vlnový tvar?
Nie. Poskytnite skutočné normalizované špičky pre tento zdroj; bežný postup funguje aj bez nich.
Ako funguje predplatné?
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.
Súvisiace návody
Pre pomoc nám povedzte, ktorý plugin a zariadenie používate, akú akciu ste skúšali a čo sa stalo. Použite príklad bez osobných údajov. Nikdy nezdieľajte svoj kľúč ani súkromné súbory.