Audio Player-interfaco kun ekzempla titolo.
Audio Player-interfaco kun ekzempla titolo.
← Ĉiuj gvidiloj pri Bubble Native

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.

  1. 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.

  2. Se vi havas realajn ondformajn datumojn por ĉi tiu registrado, transdonu ilin en waveform_peaks_json. Alie lasu ĝin malplena.

  3. 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.

  4. 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.

Laborflua diagramo — ne aplikaĵa ekrankopio

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
  1. Kreu aŭ elektu vian Bubble-aplikaĵan projekton ĉe BestPlugins → Dashboard → Plugins.
  2. Elektu ĉi tiun kromaĵon kaj kopiu ĝian projektan ŝlosilon.
  3. Open Bubble → Plugins → this plugin. Paste its project key into licensing_api_key and save.
  4. Aldonu la elementon, elektu viajn aplikaĵajn datumojn kaj konstruu la suban laborfluon.
  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.
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 · text

Statoj

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

Eventoj

readyplayback_startedplayback_pausedplayback_endedseek_completedrate_changedplayer_error

Agoj kaj iliaj enigoj

PlayPauseToggleStopSeekSet speedSet volumeReload source
Elementaj agordoj · 11
source_urltext · Defaŭlto: ""
Ekzempla valorohttps://bestplugins.online/native-samples/lesson.mp3
Ekzemplo Bubble esprimoSelected 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 esprimoSelected Message's waveform_peaks_json
Realaj normaligitaj amplitudvaloroj por ĉi tiu registrado; lasu malplena se ne disponebla.
titletext · Defaŭlto: ""
Ekzempla valoroLesson 4 — review
Ekzemplo Bubble esprimoSelected 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 valoroTeacher · today
Ekzemplo Bubble esprimoSelected 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 valoro1.5
Ekzemplo Bubble esprimoCurrent User's listening_speed
Uzu la valoron de la nuna komerca registro; validigu ĝin kontraŭ la subaj limoj.
volumenumber · Defaŭlto: 1
Ekzempla valoro0.8
Ekzemplo Bubble esprimoVolume Slider's value
Uzu la valoron de la nuna komerca registro; validigu ĝin kontraŭ la subaj limoj.
loopyes_no · Defaŭlto: false
Ekzempla valorono
Ekzemplo Bubble esprimoSelected 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 valoroyes
Ekzemplo Bubble esprimoGuideHost'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 valorono
Ekzemplo Bubble esprimoGuideHost'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 esprimoApp Settings' player_labels_json (supported keys only)
Nedeviga JSON kun subtenataj butonetiketoj. Lasu malplena por uzi la enkonstruitan tekston.
languagetext · Defaŭlto: "auto"
Ekzempla valorouk
Ekzemplo Bubble esprimoCurrent 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 valoro12
Ekzemplo Bubble esprimoSelected Comment's seconds
Uzu la valoron de la nuna komerca registro; validigu ĝin kontraŭ la subaj limoj.
Set speed
ratenumber · Defaŭlto: —
Ekzempla valoro1.5
Ekzemplo Bubble esprimoSpeed Dropdown's value
Uzu la valoron de la nuna komerca registro; validigu ĝin kontraŭ la subaj limoj.
Set volume
volumenumber · Defaŭlto: —
Ekzempla valoro0.8
Ekzemplo Bubble esprimoVolume 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 · text

Nuna rezulto de ĉi tiu ago. Uzu la kongruan finigan eventon antaŭ ol konservi sukceson.

is_playing · yes_no

Nuna valoro por la elektita elemento. Legu ĝin post la rilata evento.

is_loaded · yes_no

Nuna valoro por la elektita elemento. Legu ĝin post la rilata evento.

is_buffering · yes_no

Nuna valoro por la elektita elemento. Legu ĝin post la rilata evento.

current_time · number

Nuna valoro por la elektita elemento. Legu ĝin post la rilata evento.

duration · number

Nuna valoro por la elektita elemento. Legu ĝin post la rilata evento.

progress · number

Nuna valoro por la elektita elemento. Legu ĝin post la rilata evento.

playback_rate · number

Nuna valoro por la elektita elemento. Legu ĝin post la rilata evento.

volume · number

Nuna valoro por la elektita elemento. Legu ĝin post la rilata evento.

is_looping · yes_no

Nuna valoro por la elektita elemento. Legu ĝin post la rilata evento.

waveform_available · yes_no

Nuna valoro por la elektita elemento. Legu ĝin post la rilata evento.

waveform_status · text

Nuna rezulto de ĉi tiu ago. Uzu la kongruan finigan eventon antaŭ ol konservi sukceson.

error_code · text

Erarinformoj por la lasta ago. Montru utilan mesaĝon kaj proponu la rilatan reprovon.

Eventoj

ready

Kiam ĉi tiu evento okazas, legu la rilatajn statojn de la sama elemento.

playback_started

Kiam ĉi tiu evento okazas, legu la rilatajn statojn de la sama elemento.

playback_paused

Kiam ĉi tiu evento okazas, legu la rilatajn statojn de la sama elemento.

playback_ended

Kiam ĉi tiu evento okazas, legu la rilatajn statojn de la sama elemento.

seek_completed

Kiam ĉi tiu evento okazas, legu la rilatajn statojn de la sama elemento.

rate_changed

Kiam ĉi tiu evento okazas, legu la rilatajn statojn de la sama elemento.

player_error

Kiam ĉ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.