Interface Audio Player cun in titel d'exempel.
Interface Audio Player cun in titel d'exempel.
← Tut las guidas Bubble Native

Xodera Plugins · Bubble Native

Xodera Audio Player Native

Agiuntar in lettor audio cler a lezziuns, messadis vocal u registraziuns da product. Permetter a las persunas da ascultar, midar la velocitad e cuntinuar da lur posiziun salvada.

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.

Documentaziun controllada ils 6 da november 2026

Exemplars pratics

Messadis vocal en ina conversaziun da sustegn

In link simpl a in file manda ils utilisaders lunsch da la conversaziun e renda pli grev da revair rispostas lungas.

`source_url = Selected Message’s audio URL`; `title = Selected Message’s sender label`; `subtitle = Selected Message’s timestamp`.

Plassa il player en il detagl dal messadi selecziunà. Lasa l'utilisader Play/Pause, Seek ad in punct util e Set speed. Associa `is_active` a la conversaziun averta.

Utilisescha `is_playing`, `current_time` e `duration` per mussar il progress. Conserva l'ID Message en tia app uschia che in eveniment tard na po betg actualisar ina conversaziun diversa.

Sin `player_error`, mussa `error_code` e offra Reload source; conserva il messadi e na marcat mai quai sco ascultà suenter in errur.

Mo reproducziun. Tia app memorisescha il progress d'ascultar.

Riprenda ina leziun da lingua a la posiziun memorisada

Ils studenti ston repetar ina passa difficila enstagl da reaviar l'entira leziun.

`source_url = Current Lesson’s audio URL`; `title = Current Lesson’s name`; la ultima posiziun appartegna a quel student e quella leziun en tia banca da datas.

Suenter `ready` per la leziun actuala, Seek als seconds memorisads e spetga che l'utilisader Play. Utilisescha Set speed per ina ascult pli lenta. Memorisescha il progress cun il flux da lavur da tia app.

Legia `current_time` e `duration`. Sin `playback_ended`, tia app po registrar in punct da referenza per l'ascult per il Lesson actual.

Sche la funtauna è cambiada, scarta la veglia posiziun enfin che quella leziun è chargiada. Na considerar betg la fin da l'ascult sco prova che il student ha chapì u ha superà in test.

Mo reproducziun. Tia app memorisescha il progress d'ascultar.

Revedi in annex audio cun commentaris cun marcadurs da temp

Editurs u trainers ston saltar da in commentari al mument pertinent en ina registraziun.

`source_url = Selected Review’s recording URL`; mintga Comment che appartegna a l'app memorisescha sia propria valur en seconds; `waveform_peaks_json` facultativ cuntegna pics real per la medema registraziun.

Clicca sin in Comment → Seek a sias secundas → Play. Sche la funtauna mida, remplazza u stizza ils pics e collia puspè il Review tschernì.

Mostra `current_time` ad incunter dal tes cumponent per scriver commentaris. `waveform_available` inditgescha a tia UI sch'ils pics furnids real èn disponibels.

Limitescha timestamps antiquads a la durada actuala en tia app u refusa els. Sche nagins pics reals n'existan, mussa il controll da progress ordinari empè d'ina analisa audio inventada.

Mo reproducziun. Tia app memorisescha il progress d'ascultar.

Tge che funcziuna ussa

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.

Crear il flus da lavur

Utilisescha las acziuns beta disponiblas sutvart e testa il resultat sin tes apparats mira.

Quests exempels dovran endataziuns da l'app sco Lesson, Message ed Order. Remplazza quellas cun tes agens tips da datas e nums d'elements. Remplazza las adressas da medias d'exempel cun tias atgnas datotecas.

  1. Agiunta l'element audio. Definischa source_url = Selected Message's audio_url, title = Selected Message's sender_label e subtitle = Selected Message's date_label.

  2. Sche ti has datas realas da forma d'onda per questa registraziun, transmettas las en waveform_peaks_json. Autrament las lascha vueidas.

  3. Cura che ready succeda, dovra Seek cun il dumber da secundas memorisà, sche necessari. Lascha l'utilisader cliccar sin Play. Dovra Pause, Seek e Set speed per ils buttuns dal lectur.

  4. Mussa current_time e duration. Sin playback_ended, memorisescha il progress d'ascultar per il messadi u la lecziun tschernida. Definiescha is_active tenor sch'questa vista è averta.

Diagramma dal flus da lavur — betg ina captura d’app

Configurar ina giada

Creescha u tscherna tes project d'app Bubble en BestPlugins → Dashboard → Plugins. Tscherna Xodera Audio Player Native, copia sia clav, suenter avra Bubble → Plugins → Xodera Audio Player Native e incolla ella en licensing_api_key. Salva ina giada; suenter utilisescha las acziuns sutvart. Mintga plugin en mintga project ha sia propria clav.

Utilisescha ina adressa directa da datoteca audio che l'app po avrir. La reproducziun da l'audio na pretenda betg l'access a microfon ni camera.

Configurar ina giada
  1. Creescha u tscherna tes project d'app Bubble en BestPlugins → Dashboard → Plugins.
  2. Tscherna quest plugin e copia sia clav dal project.
  3. Open Bubble → Plugins → this plugin. Paste its project key into licensing_api_key and save.
  4. Agiunta l'element, tscherna tias datas d'app e construescha il flus da lavur sutvart.
  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.
Installaziun e abonnament

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.

Memorisar il resultat en tia app

Exempel ListeningProgress: owner = Current User, lesson = Selected Lesson, seconds = Audio Player's current_time, duration = Audio Player's duration. Salva cura che l'utilisader pausa u banduna la leziun, pli che ad ogni actualisaziun dal visur.

Falliment, annullar e restaurar

Sin player_error, mussa error_code e offra Reload source. Conserva il messadi u la registraziun da la leziun. Cura che ina registraziun diversa è tschernida, chargia sia posiziun salvada. Turnar al visur na cumenza betg la reproducziun automaticamain.

Capacitads e lims

Velocitads da reproducziun: 1, 1.5 e 2. Volum: 0–1. Datas da forma d'onda: 2–2048 valurs tranter 0 e 1. Formats audio sustegnids dependen dal apparat. Il lettor na registra, transcriva ni salva permanentamain audio per l'utilisaziun offline. La reproducziun en il fund e sin il scherm da bloc è betg garantida.

Configuraziuns, acziuns e resultats

Utilisescha quests numens en Bubble. Funcziuns planisadas èn marcadas separadamain.

Configuraziuns beta disponiblas

Configuraziun da l'element

source_url · textwaveform_peaks_json · texttitle · textsubtitle · textplayback_rate · numbervolume · numberloop · yes_nois_active · yes_nodisabled · yes_noui_text_json · textlanguage · text

Stadis

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

Eveniments

readyplayback_startedplayback_pausedplayback_endedseek_completedrate_changedplayer_error

Acziuns e lur inputs

PlayPauseToggleStopSeekSet speedSet volumeReload source
Configuraziun da l'element · 11
source_urltext · Standard: ""
Valur d'exempelhttps://bestplugins.online/native-samples/lesson.mp3
Exempel Bubble expressiunSelected Message's audio_url
Adress da la datoteca audio, video u maletg selecziunada. Utilisescha in tip da datoteca che quest plugin sustegna.
waveform_peaks_jsontext · Standard: ""
Valur d'exempel[0.1,0.4,0.2,0.7]
Exempel Bubble expressiunSelected Message's waveform_peaks_json
Valurs realas normalisadas d'amplitüd per questa registraziun; lascha vid se betg disponibel.
titletext · Standard: ""
Valur d'exempelLesson 4 — review
Exempel Bubble expressiunSelected Lesson's name
Text visibel da l'app; vid duvrar la copia integràda localisada là nua ch'ella è sustegnida. Naginas credenzials.
subtitletext · Standard: ""
Valur d'exempelTeacher · today
Exempel Bubble expressiunSelected Message's sender_label
Text visibel da l'app; vid duvrar la copia integràda localisada là nua ch'ella è sustegnida. Naginas credenzials.
playback_ratenumber · Standard: 1
Valur d'exempel1.5
Exempel Bubble expressiunCurrent User's listening_speed
Utilisescha il valur dal registr da l'interpresa actual; validescha el cun ils limits sutvart.
volumenumber · Standard: 1
Valur d'exempel0.8
Exempel Bubble expressiunVolume Slider's value
Utilisescha il valur dal registr da l'interpresa actual; validescha el cun ils limits sutvart.
loopyes_no · Standard: false
Valur d'exempelno
Exempel Bubble expressiunSelected Lesson's repeat_enabled
Utilisescha il valur dal registr da l'interpresa actual; validescha el cun ils limits sutvart.
is_activeyes_no · Standard: true
Valur d'exempelyes
Exempel Bubble expressiunGuideHost's view_is_active (your yes/no custom state)
Definiescha yes durant che questa vista è averta. Definiescha no cura che ti bandunas ella, per che la reproducziun u il lavur actual possia sa fermar.
disabledyes_no · Standard: false
Valur d'exempelno
Exempel Bubble expressiunGuideHost's is_busy (your yes/no custom state)
Deactiva l'element cura che tia app è occupada u che questa acziun è betg disponibla.
ui_text_jsontext · Standard: ""
Valur d'exempel{}
Exempel Bubble expressiunApp Settings' player_labels_json (supported keys only)
JSON facultativ cun etichettas da buttun sustegnidas. Lascha vid per duvrar il text integrà.
languagetext · Standard: "auto"
Valur d'exempeluk
Exempel Bubble expressiunCurrent User's preferred_language
Definiescha language=auto per suandar la lingua da l'apparat u dal navigatur, sch'ella è sustegnida. Endatescha in code da lingua sustegnì per tscherner quella explicitamain.
Acziuns e lur inputs · 8
Play

Nagins parameters d'acziun

Pause

Nagins parameters d'acziun

Toggle

Nagins parameters d'acziun

Stop

Nagins parameters d'acziun

Seek
secondsnumber · Standard: —
Valur d'exempel12
Exempel Bubble expressiunSelected Comment's seconds
Utilisescha il valur dal registr da l'interpresa actual; validescha el cun ils limits sutvart.
Set speed
ratenumber · Standard: —
Valur d'exempel1.5
Exempel Bubble expressiunSpeed Dropdown's value
Utilisescha il valur dal registr da l'interpresa actual; validescha el cun ils limits sutvart.
Set volume
volumenumber · Standard: —
Valur d'exempel0.8
Exempel Bubble expressiunVolume Slider's value
Utilisescha il valur dal registr da l'interpresa actual; validescha el cun ils limits sutvart.
Reload source

Nagins parameters d'acziun

Stadis e eveniments

Stadis

player_status · text

Resultat actual da questa acziun. Dovra l'eveniment correspundent che inditgescha la fin da l'acziun avant da memorisar il success.

is_playing · yes_no

Valur actual per l'element selecziunà. Legia el suenter l'eveniment relatà.

is_loaded · yes_no

Valur actual per l'element selecziunà. Legia el suenter l'eveniment relatà.

is_buffering · yes_no

Valur actual per l'element selecziunà. Legia el suenter l'eveniment relatà.

current_time · number

Valur actual per l'element selecziunà. Legia el suenter l'eveniment relatà.

duration · number

Valur actual per l'element selecziunà. Legia el suenter l'eveniment relatà.

progress · number

Valur actual per l'element selecziunà. Legia el suenter l'eveniment relatà.

playback_rate · number

Valur actual per l'element selecziunà. Legia el suenter l'eveniment relatà.

volume · number

Valur actual per l'element selecziunà. Legia el suenter l'eveniment relatà.

is_looping · yes_no

Valur actual per l'element selecziunà. Legia el suenter l'eveniment relatà.

waveform_available · yes_no

Valur actual per l'element selecziunà. Legia el suenter l'eveniment relatà.

waveform_status · text

Resultat actual da questa acziun. Dovra l'eveniment correspundent che inditgescha la fin da l'acziun avant da memorisar il success.

error_code · text

Informaziuns d'error per l'ultima acziun. Mussar in messadi d'agid e porscher il reprovà pertinent.

Eveniments

ready

Sch'quest event succeda, legia ils stadi relatads da l'istess element.

playback_started

Sch'quest event succeda, legia ils stadi relatads da l'istess element.

playback_paused

Sch'quest event succeda, legia ils stadi relatads da l'istess element.

playback_ended

Sch'quest event succeda, legia ils stadi relatads da l'istess element.

seek_completed

Sch'quest event succeda, legia ils stadi relatads da l'istess element.

rate_changed

Sch'quest event succeda, legia ils stadi relatads da l'istess element.

player_error

Sch'quest event succeda, legia ils stadi relatads da l'istess element.

Dumondas che ils sviluppaders fan

Crea ella il diagram da l'onda?

Na. Furnescha pics normalisads real per quella funtauna; il progress ordinari funcziuna senza els.

Co funcziuna l'abunament?

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.

Guidas colliadas

Per agid, indichescha nus tge plugin e tge apparat ti dovras, l'acziun che ti has empruvà e tge succedì. Dovra in exempel senza datas persunalas. Mai cundivida tia clav ni tes files privats.