
Xodera Plugins · Bubble Native
Xodera Audio Player Native
Aldonu klaran sonludilon al lecionoj, voĉmesaĝoj aŭ produktaj registroj. Permesu al uzantoj aŭskulti, ŝanĝi rapidon kaj daŭrigi de ilia konservita loko.
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.
Dokumentado reviziita 6 novembro 2026
Praktikaj ekzemploj
Voĉaj notoj en subtena konversacio
Simpla dosierligilo forigas uzantojn de la konversacio kaj malfaciligas revizion de longaj respondoj.
`source_url = Selected Message’s audio URL`; `title = Selected Message’s sender label`; `subtitle = Selected Message’s timestamp`.
Metu la ludilon en la detaloj de la elektita mesaĝo. Permesu al la uzanto Play/Pause, Seek al utila punkto kaj Set speed. Ligigu `is_active` al la malferma konversacio.
Uzu `is_playing`, `current_time` kaj `duration` por montri progreson. Konservu la Message‑identigilon en via aplikaĵo, por ke malfrua evento ne povu ĝisdatigi alian konversacion.
Ĉe `player_error`, montru `error_code` kaj proponu Reload source; konservu la mesaĝon kaj neniam marki ĝin aŭskultita post eraro.
Nur ludado. Via aplikaĵo konservas aŭskultan progreson.
Rekomencu lingvan lecionon ĉe la konservita pozicio
Lernantoj bezonas reprodukti malfacilan pason anstataŭ restartigi la tutan lecionon.
`source_url = Current Lesson’s audio URL`; `title = Current Lesson’s name`; la lasta pozicio apartenas al tiu lernanto kaj leciono en via datumbazo.
Post `ready` por la nuna leciono, Seek al la konservitaj sekundoj kaj atendu ke la uzanto Play. Uzu Set speed por pli malrapida aŭskulto. Konservu progreson per via propra aplikaĵa laborfluo.
Legu `current_time` kaj `duration`. Ĉe `playback_ended`, via aplikaĵo povas registri aŭskultan mejloŝtonon por la nuna Lesson.
Se la fonto ŝanĝiĝis, forĵetu la malnovan pozicion ĝis tiu leciono estas ŝargita. Ne traktu la finon de aŭskulto kiel pruvo ke la lernanto komprenis aŭ trapasis teston.
Nur ludado. Via aplikaĵo konservas aŭskultan progreson.
Revizu sonan aldonaĵon kun tempomarkitaj komentoj
Redaktantoj aŭ trejnistoj bezonas salti de komento al la rilata momento en registrado.
`source_url = Selected Review’s recording URL`; ĉiu registro Comment posedata de la aplikaĵo konservas sian propran valoron en sekundoj; la nedeviga `waveform_peaks_json` enhavas realajn pintojn por tiu sama registraĵo.
Alklaku Comment → Seek al ĝia valoro en sekundoj → Play. Ĉe ŝanĝo de la fonto, anstataŭigu aŭ forigu la pintojn kaj denove ligu la elektitan Review.
Montru `current_time` apud via komenta komponanto. `waveform_available` informas vian UI ĉu realaj provizitaj pintoj estas disponeblaj.
Limigu malnovajn tempomarkojn al la nuna daŭro en via aplikaĵo aŭ malakceptu ilin. Kiam realaj pintoj mankas, montru la ordinaran progresregilon anstataŭ elpensitan sonanalizon.
Nur ludado. Via aplikaĵo konservas aŭskultan progreson.
Kio funkcias nun
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.
Kreu la laborfluon
Uzu la disponeblajn beta-agojn sube kaj testu la rezulton sur viaj cela aparatoj.
Ĉi tiuj ekzemploj uzas aplikaĵajn rekordojn kiel Lesson, Message kaj Order. Anstataŭigu ilin per viaj propraj datumtipoj kaj elementnomoj. Ekzemplaj aŭdvida adresoj devas esti anstataŭigitaj per viaj propraj dosieroj.
Aldonu la son-elementon. Agordu source_url = Selected Message's audio_url, title = Selected Message's sender_label kaj subtitle = Selected Message's date_label.
Se vi havas realajn ondformajn datumojn por ĉi tiu registrado, transdonu ilin en waveform_peaks_json. Alie lasu ĝin malplena.
Kiam okazas ready, uzu Seek kun la konservita nombro da sekundoj se necese. Lasu la uzanton premi Play. Uzu Pause, Seek kaj Set speed por la butonoj de la ludilo.
Montru current_time kaj duration. Ĉe playback_ended, konservu la aŭskultan progreson por la elektita mesaĝo aŭ leciono. Agordu is_active laŭ tio, ĉu ĉi tiu vido estas malfermita.
Agordu unufoje
Kreu aŭ elektu vian Bubble-aplikaĵan projekton en BestPlugins → Dashboard → Plugins. Elektu Xodera Audio Player Native, kopiu ĝian ŝlosilon, poste malfermu Bubble → Plugins → Xodera Audio Player Native kaj algluu ĝin en licensing_api_key. Konservu unufoje; poste uzu la subajn agojn. Ĉiu kromaĵo en ĉiu projekto havas sian propran ŝlosilon.
Uzu rektan sondosieradreson, kiun la aplikaĵo povas malfermi. Ludado de sono ne postulas aliron al mikrofono aŭ kamerao.
Agordu unufoje
- Kreu aŭ elektu vian Bubble-aplikaĵan projekton ĉe BestPlugins → Dashboard → Plugins.
- Elektu ĉi tiun kromaĵon kaj kopiu ĝian projektan ŝlosilon.
- Open Bubble → Plugins → this plugin. Paste its project key into licensing_api_key and save.
- Aldonu la elementon, elektu viajn aplikaĵajn datumojn kaj konstruu la suban laborfluon.
- 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.
Instalado kaj abono
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.
Konservu la rezulton en via aplikaĵo
Ekzemplo ListeningProgress: owner = Current User, lesson = Selected Lesson, seconds = Audio Player's current_time, duration = Audio Player's duration. Konservu kiam la uzanto paŭzas aŭ forlasas la lecionon, anstataŭ ĉe ĉiu ekrana ĝisdatigo.
Malsukceso, nuligo kaj restaŭro
Sur player_error, montru error_code kaj proponu Reload source. Konservu la mesaĝon aŭ lecionan registron. Kiam alia registrado estas elektita, ŝargu ĝian propran konservitan pozicion. Revenante al la vido ne komencas ludadon aŭtomate.
Kapabloj kaj limoj
Reproduktaj rapidoj: 1, 1.5 kaj 2. Laŭteco: 0–1. Ondformaj datumoj: 2–2048 valoroj inter 0 kaj 1. Subtenataj sonformatoj dependas de la aparato. La ludilo ne registras, transskribas aŭ permanente konservas sonon por eksterreta uzo. Fonludado kaj ludado sur ŝloskrano ne estas garantitaj.
Agordoj, agoj kaj rezultoj
Uzu ĉi tiujn nomojn en Bubble. Planitaj funkcioj estas markitaj aparte.
Disponeblaj beta-agordoj
Elementaj agordoj
source_url · textwaveform_peaks_json · texttitle · textsubtitle · textplayback_rate · numbervolume · numberloop · yes_nois_active · yes_nodisabled · yes_noui_text_json · textlanguage · textStatoj
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 · textEventoj
readyplayback_startedplayback_pausedplayback_endedseek_completedrate_changedplayer_errorAgoj kaj iliaj enigoj
PlayPauseToggleStopSeekSet speedSet volumeReload sourceElementaj agordoj · 11
source_urltext · Defaŭlto: ""- Ekzempla valoro
https://bestplugins.online/native-samples/lesson.mp3 - Ekzemplo Bubble esprimo
Selected Message's audio_url - Adreso de la elektita audio-, video- aŭ bilddosiero. Uzu dosiertipon subtenatan de ĉi tiu kromaĵo.
waveform_peaks_jsontext · Defaŭlto: ""- Ekzempla valoro
[0.1,0.4,0.2,0.7] - Ekzemplo Bubble esprimo
Selected Message's waveform_peaks_json - Realaj normaligitaj amplitudvaloroj por ĉi tiu registrado; lasu malplena se ne disponebla.
titletext · Defaŭlto: ""- Ekzempla valoro
Lesson 4 — review - Ekzemplo Bubble esprimo
Selected Lesson's name - Videbla teksto de la aplikaĵo; malplena valoro uzas la enkonstruitan tradukitan tekston, kie tio estas subtenata. Ne enmetu akreditaĵojn.
subtitletext · Defaŭlto: ""- Ekzempla valoro
Teacher · today - Ekzemplo Bubble esprimo
Selected Message's sender_label - Videbla teksto de la aplikaĵo; malplena valoro uzas la enkonstruitan tradukitan tekston, kie tio estas subtenata. Ne enmetu akreditaĵojn.
playback_ratenumber · Defaŭlto: 1- Ekzempla valoro
1.5 - Ekzemplo Bubble esprimo
Current User's listening_speed - Uzu la valoron de la nuna komerca registro; validigu ĝin kontraŭ la subaj limoj.
volumenumber · Defaŭlto: 1- Ekzempla valoro
0.8 - Ekzemplo Bubble esprimo
Volume Slider's value - Uzu la valoron de la nuna komerca registro; validigu ĝin kontraŭ la subaj limoj.
loopyes_no · Defaŭlto: false- Ekzempla valoro
no - Ekzemplo Bubble esprimo
Selected Lesson's repeat_enabled - Uzu la valoron de la nuna komerca registro; validigu ĝin kontraŭ la subaj limoj.
is_activeyes_no · Defaŭlto: true- Ekzempla valoro
yes - Ekzemplo Bubble esprimo
GuideHost's view_is_active (your yes/no custom state) - Agordu jes dum ĉi tiu vido estas malfermita. Agordu ne kiam forlasas, por ke reproduktado aŭ nuna laboro povas ĉesi.
disabledyes_no · Defaŭlto: false- Ekzempla valoro
no - Ekzemplo Bubble esprimo
GuideHost's is_busy (your yes/no custom state) - Malebligu la elementon dum via aplikaĵo estas okupata aŭ ĉi tiu ago ne disponeblas.
ui_text_jsontext · Defaŭlto: ""- Ekzempla valoro
{} - Ekzemplo Bubble esprimo
App Settings' player_labels_json (supported keys only) - Nedeviga JSON kun subtenataj butonetiketoj. Lasu malplena por uzi la enkonstruitan tekston.
languagetext · Defaŭlto: "auto"- Ekzempla valoro
uk - Ekzemplo Bubble esprimo
Current User's preferred_language - Agordu language=auto por sekvi subtenatan lingvon de la aparato aŭ retumilo. Enigu subtenatan lingvokodon por elekti ĝin eksplicite.
Agoj kaj iliaj enigoj · 8
Play
Neniuj ago-parametroj
Pause
Neniuj ago-parametroj
Toggle
Neniuj ago-parametroj
Stop
Neniuj ago-parametroj
Seek
secondsnumber · Defaŭlto: —- Ekzempla valoro
12 - Ekzemplo Bubble esprimo
Selected Comment's seconds - Uzu la valoron de la nuna komerca registro; validigu ĝin kontraŭ la subaj limoj.
Set speed
ratenumber · Defaŭlto: —- Ekzempla valoro
1.5 - Ekzemplo Bubble esprimo
Speed Dropdown's value - Uzu la valoron de la nuna komerca registro; validigu ĝin kontraŭ la subaj limoj.
Set volume
volumenumber · Defaŭlto: —- Ekzempla valoro
0.8 - Ekzemplo Bubble esprimo
Volume Slider's value - Uzu la valoron de la nuna komerca registro; validigu ĝin kontraŭ la subaj limoj.
Reload source
Neniuj ago-parametroj
Statoj kaj eventoj
Statoj
player_status · textNuna rezulto de ĉi tiu ago. Uzu la kongruan finigan eventon antaŭ ol konservi sukceson.
is_playing · yes_noNuna valoro por la elektita elemento. Legu ĝin post la rilata evento.
is_loaded · yes_noNuna valoro por la elektita elemento. Legu ĝin post la rilata evento.
is_buffering · yes_noNuna valoro por la elektita elemento. Legu ĝin post la rilata evento.
current_time · numberNuna valoro por la elektita elemento. Legu ĝin post la rilata evento.
duration · numberNuna valoro por la elektita elemento. Legu ĝin post la rilata evento.
progress · numberNuna valoro por la elektita elemento. Legu ĝin post la rilata evento.
playback_rate · numberNuna valoro por la elektita elemento. Legu ĝin post la rilata evento.
volume · numberNuna valoro por la elektita elemento. Legu ĝin post la rilata evento.
is_looping · yes_noNuna valoro por la elektita elemento. Legu ĝin post la rilata evento.
waveform_available · yes_noNuna valoro por la elektita elemento. Legu ĝin post la rilata evento.
waveform_status · textNuna rezulto de ĉi tiu ago. Uzu la kongruan finigan eventon antaŭ ol konservi sukceson.
error_code · textErarinformoj por la lasta ago. Montru utilan mesaĝon kaj proponu la rilatan reprovon.
Eventoj
readyKiam ĉi tiu evento okazas, legu la rilatajn statojn de la sama elemento.
playback_startedKiam ĉi tiu evento okazas, legu la rilatajn statojn de la sama elemento.
playback_pausedKiam ĉi tiu evento okazas, legu la rilatajn statojn de la sama elemento.
playback_endedKiam ĉi tiu evento okazas, legu la rilatajn statojn de la sama elemento.
seek_completedKiam ĉi tiu evento okazas, legu la rilatajn statojn de la sama elemento.
rate_changedKiam ĉi tiu evento okazas, legu la rilatajn statojn de la sama elemento.
player_errorKiam ĉi tiu evento okazas, legu la rilatajn statojn de la sama elemento.
Demandoj, kiujn programistoj demandas
Ĉu ĝi kreas la ondformon?
Ne. Provizu realajn normaligitajn pintojn por tiu fonto; ordinara progreso funkcias sen ili.
Kiel funkcias la abono?
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.
Rilataj gvidiloj
Por helpo, informu nin kiun kromaĵon kaj aparaton vi uzas, la agon kiun vi provis kaj kio okazis. Uzu ekzemplon sen personaj datumoj. Neniam dividu vian ŝlosilon aŭ privatajn dosierojn.