Audio Player‑koppelvlak met ’n voorbeeldtitel.
Audio Player‑koppelvlak met ’n voorbeeldtitel.
← Alle inheemse gidse

Xodera Plugins · Bubble Native

Xodera Audio Player Native

Voeg 'n duidelike klankspeler by lesse, stemboodskappe of produkrekords. Laat mense luister, spoed verander en voortgaan vanaf hul gestoorde posisie.

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.

Dokumentasie hersien 6 November 2026

Praktiese voorbeelde

Stemnotas binne 'n ondersteuningsgesprek

'n Eenvoudige lêer skakel stuur gebruikers weg van die gesprek en maak lang antwoorde moeilik om te hersien.

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

Plaas die speler in die geselekteerde-boodskapdetail. Laat die gebruiker Play/Pause, Seek tot 'n nuttige punt en Set speed. Bind `is_active` aan die oop gesprek.

Gebruik `is_playing`, `current_time` en `duration` om voortgang te wys. Hou die Message ID in jou app sodat 'n laat gebeurtenis nie 'n ander gesprek kan opdateer nie.

Op `player_error`, wys `error_code` en bied Reload source aan; bewaar die boodskap en merk dit nooit as geluister na 'n fout nie.

Slegs terugspeel. Jou app stoor luistervoortgang.

Hervat 'n taalles op die gestoorde posisie

Leerders moet 'n moeilike gedeelte herhaal in plaas van die hele les te herbegin.

`source_url = Current Lesson’s audio URL`; `title = Current Lesson’s name`; die laaste posisie behoort aan daardie leerder en les in jou databasis.

Na `ready` vir die huidige les, Seek na die gestoorde sekondes en wag vir die gebruiker om Play. Gebruik Set speed vir stadiger luister. Stoor voortgang met jou eie app-werkstroom.

Lees `current_time` en `duration`. Op `playback_ended`, mag jou app 'n luistermylpaal vir die huidige Lesson registreer.

As die bron verander het, gooi die ou posisie weg totdat daardie les gelaai is. Beskou voltooiing van luister nie as bewys dat die leerder verstaan of 'n toets geslaag het nie.

Slegs terugspeel. Jou app stoor luistervoortgang.

Hersien 'n klankaanhegsel met tydstempelkommente

Redakteurs of opleiers moet van 'n opmerking na die relevante oomblik in 'n opname spring.

`source_url = Selected Review’s recording URL`; elke app-eienaarskommentaar stoor sy eie sekonde-waarde; opsionele `waveform_peaks_json` bevat werklike pieke vir daardie selfde opname.

Klik 'n kommentaar → Seek na sy sekondes → Play. By bronverandering, vervang of skoon die pieke en bind die geselekteerde hersiening weer.

Vertoon `current_time` langs jou kommentaar-samesteller. `waveform_available` sê vir jou UI of werklike verskafde pieke beskikbaar is.

Klem of verwerp verouderde tydstempels teen die huidige duur in jou app. As geen werklike pieke bestaan nie, wys die gewone voortgangbeheer in plaas van gekonstrueerde klankontleding.

Slegs terugspeel. Jou app stoor luistervoortgang.

Wat nou werk

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.

Bou die werkvloei

Gebruik die beskikbare beta-aksies hieronder en toets die resultaat op jou teiken-toestelle.

Hierdie voorbeelde gebruik app-rekords soos Lesson, Message en Order. Vervang dit met jou eie datatipes en elementname. Voorbeeldmedia-adresse moet met jou eie lêers vervang word.

  1. Voeg die klank-element by. Stel source_url = Selected Message's audio_url, title = Selected Message's sender_label en subtitle = Selected Message's date_label.

  2. As jy werklike golfvormdata vir hierdie opname het, gee dit in waveform_peaks_json aan. Laat dit andersins leeg.

  3. Wanneer die gebeurtenis ready plaasvind, gebruik Seek met die gestoorde aantal sekondes indien nodig. Laat die gebruiker Play druk. Gebruik Pause, Seek en Set speed vir die spelerknoppies.

  4. Wys current_time en duration. Op playback_ended, stoor luistervoortgang vir die gekose boodskap of les. Stel is_active in op of hierdie aansig oop is.

Werkvloediagram — nie 'n app-skermkiekie nie

Stel een keer op

Skep of kies jou Bubble-appprojek in BestPlugins → Dashboard → Plugins. Kies Xodera Audio Player Native, kopieer die sleutel, open dan Bubble → Plugins → Xodera Audio Player Native en plak dit in licensing_api_key. Stoor een keer; gebruik dan die aksies hieronder. Elke inprop in elke projek het sy eie sleutel.

Gebruik 'n direkte klanklêeradres wat die app kan open. Om klank te speel vereis nie mikrofoon- of kamera-toegang nie.

Stel een keer op
  1. Skep of kies jou Bubble-appprojek by BestPlugins → Dashboard → Plugins.
  2. Kies hierdie inprop en kopieer die projek-sleutel.
  3. Open Bubble → Plugins → this plugin. Paste its project key into licensing_api_key and save.
  4. Voeg die element by, kies jou app-data en bou die werkstroom hieronder.
  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.
Installasie en intekening

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.

Stoor die resultaat in jou app

Voorbeeld ListeningProgress: owner = Current User, lesson = Selected Lesson, seconds = Audio Player's current_time, duration = Audio Player's duration. Stoor wanneer die gebruiker die les onderbreek of verlaat, eerder as by elke skermopdatering.

Mislukking, kanselleer en herstel

Op player_error, wys error_code en bied Reload source aan. Hou die boodskap- of lesrekord. Wanneer 'n ander opname gekies word, laai sy eie gestoorde posisie. Terugkeer na die aansig begin nie die afspeel outomaties nie.

Vermoeëns en beperkings

Afspeelspoed: 1, 1.5 en 2. Volume: 0–1. Golfvormdata: 2–2048 waardes tussen 0 en 1. Ondersteunde klankformate hang af van die toestel. Die speler neem nie klank op, transkribeer nie of stoor klank permanent vir vanlyngebruik nie. Agtergrond- en sluitskerm-afspeel word nie gewaarborg nie.

Instellings, aksies en resultate

Gebruik hierdie name in Bubble. Beplande funksies word afsonderlik gemerk.

Beskikbare beta-instellings

Elementinstellings

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

Toestande

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

Gebeurtenisse

readyplayback_startedplayback_pausedplayback_endedseek_completedrate_changedplayer_error

Aksies en hul insette

PlayPauseToggleStopSeekSet speedSet volumeReload source
Elementinstellings · 11
source_urltext · Verstek: ""
Voorbeeldwaardehttps://bestplugins.online/native-samples/lesson.mp3
Voorbeeld Bubble-uitdrukkingSelected Message's audio_url
Adres van die gekose audio-, video- of beeldlêer. Gebruik ’n lêertipe wat hierdie inprop ondersteun.
waveform_peaks_jsontext · Verstek: ""
Voorbeeldwaarde[0.1,0.4,0.2,0.7]
Voorbeeld Bubble-uitdrukkingSelected Message's waveform_peaks_json
Werklike genormaliseerde amplitude-waardes vir hierdie opname; laat leeg indien nie beskikbaar nie.
titletext · Verstek: ""
VoorbeeldwaardeLesson 4 — review
Voorbeeld Bubble-uitdrukkingSelected Lesson's name
Sigbare app-teks; leeg gebruik ingeboude gelokaliseerde kopie waar ondersteund. Geen geloofsbriewe nie.
subtitletext · Verstek: ""
VoorbeeldwaardeTeacher · today
Voorbeeld Bubble-uitdrukkingSelected Message's sender_label
Sigbare app-teks; leeg gebruik ingeboude gelokaliseerde kopie waar ondersteund. Geen geloofsbriewe nie.
playback_ratenumber · Verstek: 1
Voorbeeldwaarde1.5
Voorbeeld Bubble-uitdrukkingCurrent User's listening_speed
Gebruik die huidige besigheidsrekord se waarde; valideer dit teen die onderstaande limiete.
volumenumber · Verstek: 1
Voorbeeldwaarde0.8
Voorbeeld Bubble-uitdrukkingVolume Slider's value
Gebruik die huidige besigheidsrekord se waarde; valideer dit teen die onderstaande limiete.
loopyes_no · Verstek: false
Voorbeeldwaardeno
Voorbeeld Bubble-uitdrukkingSelected Lesson's repeat_enabled
Gebruik die huidige besigheidsrekord se waarde; valideer dit teen die onderstaande limiete.
is_activeyes_no · Verstek: true
Voorbeeldwaardeyes
Voorbeeld Bubble-uitdrukkingGuideHost's view_is_active (your yes/no custom state)
Stel ja wanneer hierdie aansig oop is. Stel nee wanneer dit verlaat word, sodat terugspeel of huidige werk kan stop.
disabledyes_no · Verstek: false
Voorbeeldwaardeno
Voorbeeld Bubble-uitdrukkingGuideHost's is_busy (your yes/no custom state)
Deaktiveer die element terwyl jou app besig is of hierdie aksie nie beskikbaar is nie.
ui_text_jsontext · Verstek: ""
Voorbeeldwaarde{}
Voorbeeld Bubble-uitdrukkingApp Settings' player_labels_json (supported keys only)
Opsioneel JSON met ondersteunde knoppie-etikette. Laat leeg om die ingeboude teks te gebruik.
languagetext · Verstek: "auto"
Voorbeeldwaardeuk
Voorbeeld Bubble-uitdrukkingCurrent User's preferred_language
Stel language=auto in om ’n ondersteunde toestel of blaaier se taal te volg. Voer ’n ondersteunde taalkode in om dit eksplisiet te kies.
Aksies en hul insette · 8
Play

Geen aksie‑parameters nie

Pause

Geen aksie‑parameters nie

Toggle

Geen aksie‑parameters nie

Stop

Geen aksie‑parameters nie

Seek
secondsnumber · Verstek: —
Voorbeeldwaarde12
Voorbeeld Bubble-uitdrukkingSelected Comment's seconds
Gebruik die huidige besigheidsrekord se waarde; valideer dit teen die onderstaande limiete.
Set speed
ratenumber · Verstek: —
Voorbeeldwaarde1.5
Voorbeeld Bubble-uitdrukkingSpeed Dropdown's value
Gebruik die huidige besigheidsrekord se waarde; valideer dit teen die onderstaande limiete.
Set volume
volumenumber · Verstek: —
Voorbeeldwaarde0.8
Voorbeeld Bubble-uitdrukkingVolume Slider's value
Gebruik die huidige besigheidsrekord se waarde; valideer dit teen die onderstaande limiete.
Reload source

Geen aksie‑parameters nie

Toestande en gebeurtenisse

Toestande

player_status · text

Huidige resultaat van hierdie aksie. Gebruik die ooreenstemmende voltooiingsgebeurtenis voordat sukses gestoor word.

is_playing · yes_no

Huidige waarde vir die gekose item. Lees dit na die verwante gebeurtenis.

is_loaded · yes_no

Huidige waarde vir die gekose item. Lees dit na die verwante gebeurtenis.

is_buffering · yes_no

Huidige waarde vir die gekose item. Lees dit na die verwante gebeurtenis.

current_time · number

Huidige waarde vir die gekose item. Lees dit na die verwante gebeurtenis.

duration · number

Huidige waarde vir die gekose item. Lees dit na die verwante gebeurtenis.

progress · number

Huidige waarde vir die gekose item. Lees dit na die verwante gebeurtenis.

playback_rate · number

Huidige waarde vir die gekose item. Lees dit na die verwante gebeurtenis.

volume · number

Huidige waarde vir die gekose item. Lees dit na die verwante gebeurtenis.

is_looping · yes_no

Huidige waarde vir die gekose item. Lees dit na die verwante gebeurtenis.

waveform_available · yes_no

Huidige waarde vir die gekose item. Lees dit na die verwante gebeurtenis.

waveform_status · text

Huidige resultaat van hierdie aksie. Gebruik die ooreenstemmende voltooiingsgebeurtenis voordat sukses gestoor word.

error_code · text

Foutinligting vir die laaste aksie. Wys 'n nuttige boodskap en bied die toepaslike herprobe aan.

Gebeurtenisse

ready

Wanneer hierdie gebeurtenis plaasvind, lees die verwante toestande vanaf dieselfde element.

playback_started

Wanneer hierdie gebeurtenis plaasvind, lees die verwante toestande vanaf dieselfde element.

playback_paused

Wanneer hierdie gebeurtenis plaasvind, lees die verwante toestande vanaf dieselfde element.

playback_ended

Wanneer hierdie gebeurtenis plaasvind, lees die verwante toestande vanaf dieselfde element.

seek_completed

Wanneer hierdie gebeurtenis plaasvind, lees die verwante toestande vanaf dieselfde element.

rate_changed

Wanneer hierdie gebeurtenis plaasvind, lees die verwante toestande vanaf dieselfde element.

player_error

Wanneer hierdie gebeurtenis plaasvind, lees die verwante toestande vanaf dieselfde element.

Vrae wat ontwikkelaars vra

Skep dit die golfvorm?

Nee. Verskaf werklike genormaliseerde pieke vir daardie bron; gewone voortgang werk sonder hulle.

Hoe werk die intekening?

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.

Verwante gidse

Vir hulp, vertel ons watter plugin en toestel jy gebruik, die aksie wat jy probeer het en wat gebeur het. Gebruik ’n voorbeeld sonder persoonlike data. Deel nooit jou sleutel of private lêers nie.