Audio Player‑interface met een voorbeeldtitel.
Audio Player‑interface met een voorbeeldtitel.
← Alle native gidsen

Xodera Plugins · Bubble Native

Xodera Audio Player Native

Voeg een duidelijke audiospeler toe aan lessen, spraakberichten of productrecords. Laat mensen luisteren, de snelheid aanpassen en doorgaan vanaf hun opgeslagen positie.

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.

Documentatie beoordeeld 6 november 2026

Praktische voorbeelden

Spraaknotities binnen een ondersteuningsgesprek

Een eenvoudige bestandslink stuurt gebruikers weg van het gesprek en maakt lange antwoorden moeilijk te beoordelen.

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

Plaats de speler in de detailweergave van het geselecteerde bericht. Laat de gebruiker Play/Pause, Seek naar een nuttig punt en Set speed. Koppel `is_active` aan het geopende gesprek.

Gebruik `is_playing`, `current_time` en `duration` om voortgang te tonen. Houd de Message‑ID in uw app zodat een laat evenement geen ander gesprek kan bijwerken.

Op `player_error`, toon `error_code` en bied Reload source aan; bewaar het bericht en markeer het nooit als beluisterd na een fout.

Alleen afspelen. Uw app slaat luistervoortgang op.

Hervat een taalles op de opgeslagen positie

Leerlingen moeten een moeilijk fragment opnieuw afspelen in plaats van de hele les opnieuw te starten.

`source_url = Current Lesson’s audio URL`; `title = Current Lesson’s name`; de laatste positie behoort tot die leerling en les in uw database.

Na `ready` voor de huidige les, Seek naar de opgeslagen seconden en wacht tot de gebruiker Play. Gebruik Set speed voor langzamer luisteren. Sla de voortgang op met je eigen app-werkstroom.

Lees `current_time` en `duration`. Op `playback_ended` mag uw app een luistermijlpaal vastleggen voor de huidige Lesson.

Als de bron is gewijzigd, verwijder dan de oude positie totdat die les is geladen. Beschouw het voltooien van het luisteren niet als bewijs dat de leerling het begrepen heeft of een test heeft gehaald.

Alleen afspelen. Uw app slaat luistervoortgang op.

Beoordeel een audio‑bijlage met tijdstempels in opmerkingen

Editors of trainers moeten van een opmerking naar het relevante moment in een opname springen.

`source_url = Selected Review’s recording URL`; elke door de app beheerde Opmerking slaat zijn eigen secondenwaarde op; optionele `waveform_peaks_json` bevat echte pieken voor diezelfde opname.

Klik op een Opmerking → Seek naar de seconden → Play. Bij bronwijziging vervang of wis de pieken en koppel de geselecteerde Review opnieuw.

Toon `current_time` naast uw reactie‑schrijver. `waveform_available` geeft uw UI aan of werkelijke geleverde pieken beschikbaar zijn.

Beperk of verwerp verouderde tijdstempels ten opzichte van de huidige duur in je app. Wanneer er geen echte pieken zijn, toon dan de gewone voortgangsregel in plaats van verzonnen audio-analyse.

Alleen afspelen. Uw app slaat luistervoortgang op.

Wat nu werkt

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.

Bouw de workflow

Gebruik de beschikbare bèta-acties hieronder en test het resultaat op uw doelapparaten.

Deze voorbeelden gebruiken app‑records zoals Lesson, Message en Order. Vervang ze door uw eigen gegevenstypen en elementnamen. Voorbeeld‑mediapaden moeten worden vervangen door uw eigen bestanden.

  1. Voeg het audio‑element toe. Stel source_url = Selected Message's audio_url, title = Selected Message's sender_label en subtitle = Selected Message's date_label in.

  2. Als u echte golfvormgegevens voor deze opname heeft, geef deze door in waveform_peaks_json. Laat het anders leeg.

  3. Wanneer het event ready optreedt, gebruik Seek met het opgeslagen aantal seconden indien nodig. Laat de gebruiker op Play drukken. Gebruik Pause, Seek en Set speed voor de spelersknoppen.

  4. Toon current_time en duration. Bij playback_ended, sla de luistervoortgang op voor het geselecteerde bericht of de les. Stel is_active in op of deze weergave open is.

Workflow‑diagram — geen appscreenshot

Eenmalig configureren

Maak of kies uw Bubble app‑project in BestPlugins → Dashboard → Plugins. Kies Xodera Audio Player Native, kopieer de sleutel, open vervolgens Bubble → Plugins → Xodera Audio Player Native en plak deze in licensing_api_key. Sla één keer op; gebruik daarna de acties hieronder. Elke plug‑in in elk project heeft zijn eigen sleutel.

Gebruik een direct audiobestand‑adres dat de app kan openen. Het afspelen van audio vereist geen toegang tot microfoon of camera.

Eenmalig configureren
  1. Maak of kies uw Bubble app‑project op BestPlugins → Dashboard → Plugins.
  2. Kies deze plug‑in en kopieer de projectsleutel.
  3. Open Bubble → Plugins → this plugin. Paste its project key into licensing_api_key and save.
  4. Voeg het element toe, kies uw app‑gegevens en bouw de workflow 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.
Installatie en abonnement

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.

Sla het resultaat op in je app

Voorbeeld ListeningProgress: owner = Current User, lesson = Selected Lesson, seconds = Audio Player's current_time, duration = Audio Player's duration. Sla op wanneer de gebruiker de les pauzeert of verlaat, in plaats van bij elke schermupdate.

Fout, annulering en herstel

Op player_error, toon error_code en bied Reload source aan. Bewaar het bericht‑ of lesrecord. Wanneer een andere opname wordt geselecteerd, laad de eigen opgeslagen positie. Terugkeren naar de weergave start de afspeling niet automatisch.

Mogelijkheden en limieten

Afspelsnelheden: 1, 1.5 en 2. Volume: 0–1. Golfvormgegevens: 2–2048 waarden tussen 0 en 1. Ondersteunde audioformaten zijn afhankelijk van het apparaat. De speler neemt geen audio op, transcribeert niet en slaat audio niet permanent op voor offline gebruik. Achtergrond‑ en vergrendelingsscherm‑afspelen zijn niet gegarandeerd.

Instellingen, acties en resultaten

Gebruik deze namen in Bubble. Geplande functies worden apart gemarkeerd.

Beschikbare bètainstellingen

Elementinstellingen

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

Statussen

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

Evenementen

readyplayback_startedplayback_pausedplayback_endedseek_completedrate_changedplayer_error

Acties en hun invoer

PlayPauseToggleStopSeekSet speedSet volumeReload source
Elementinstellingen · 11
source_urltext · Standaard: ""
Voorbeeldwaardehttps://bestplugins.online/native-samples/lesson.mp3
Voorbeeld Bubble-expressieSelected Message's audio_url
Adres van het geselecteerde audio‑, video‑ of afbeeldingsbestand. Gebruik een bestandstype dat deze plug‑in ondersteunt.
waveform_peaks_jsontext · Standaard: ""
Voorbeeldwaarde[0.1,0.4,0.2,0.7]
Voorbeeld Bubble-expressieSelected Message's waveform_peaks_json
Werkelijke genormaliseerde amplitude‑waarden voor deze opname; laat leeg indien niet beschikbaar.
titletext · Standaard: ""
VoorbeeldwaardeLesson 4 — review
Voorbeeld Bubble-expressieSelected Lesson's name
Zichtbare app‑tekst; leeg laat ingebouwde gelokaliseerde tekst gebruiken waar ondersteund. Geen inloggegevens.
subtitletext · Standaard: ""
VoorbeeldwaardeTeacher · today
Voorbeeld Bubble-expressieSelected Message's sender_label
Zichtbare app‑tekst; leeg laat ingebouwde gelokaliseerde tekst gebruiken waar ondersteund. Geen inloggegevens.
playback_ratenumber · Standaard: 1
Voorbeeldwaarde1.5
Voorbeeld Bubble-expressieCurrent User's listening_speed
Gebruik de waarde van het huidige bedrijfsrecord; valideer deze tegen de onderstaande limieten.
volumenumber · Standaard: 1
Voorbeeldwaarde0.8
Voorbeeld Bubble-expressieVolume Slider's value
Gebruik de waarde van het huidige bedrijfsrecord; valideer deze tegen de onderstaande limieten.
loopyes_no · Standaard: false
Voorbeeldwaardeno
Voorbeeld Bubble-expressieSelected Lesson's repeat_enabled
Gebruik de waarde van het huidige bedrijfsrecord; valideer deze tegen de onderstaande limieten.
is_activeyes_no · Standaard: true
Voorbeeldwaardeyes
Voorbeeld Bubble-expressieGuideHost's view_is_active (your yes/no custom state)
Stel ja in zolang dit overzicht geopend is. Stel nee in bij verlaten, zodat afspelen of huidig werk kan stoppen.
disabledyes_no · Standaard: false
Voorbeeldwaardeno
Voorbeeld Bubble-expressieGuideHost's is_busy (your yes/no custom state)
Schakel het element uit terwijl uw app bezig is of deze actie niet beschikbaar is.
ui_text_jsontext · Standaard: ""
Voorbeeldwaarde{}
Voorbeeld Bubble-expressieApp Settings' player_labels_json (supported keys only)
Optionele JSON met ondersteunde knoplabels. Laat leeg om de ingebouwde tekst te gebruiken.
languagetext · Standaard: "auto"
Voorbeeldwaardeuk
Voorbeeld Bubble-expressieCurrent User's preferred_language
Stel language=auto in om een ondersteund apparaat of browsertaal te volgen. Voer een ondersteunde taalcodes in om deze expliciet te kiezen.
Acties en hun invoer · 8
Play

Geen actieparameters

Pause

Geen actieparameters

Toggle

Geen actieparameters

Stop

Geen actieparameters

Seek
secondsnumber · Standaard: —
Voorbeeldwaarde12
Voorbeeld Bubble-expressieSelected Comment's seconds
Gebruik de waarde van het huidige bedrijfsrecord; valideer deze tegen de onderstaande limieten.
Set speed
ratenumber · Standaard: —
Voorbeeldwaarde1.5
Voorbeeld Bubble-expressieSpeed Dropdown's value
Gebruik de waarde van het huidige bedrijfsrecord; valideer deze tegen de onderstaande limieten.
Set volume
volumenumber · Standaard: —
Voorbeeldwaarde0.8
Voorbeeld Bubble-expressieVolume Slider's value
Gebruik de waarde van het huidige bedrijfsrecord; valideer deze tegen de onderstaande limieten.
Reload source

Geen actieparameters

Statussen en gebeurtenissen

Statussen

player_status · text

Huidig resultaat van deze actie. Gebruik het bijpassende voltooiings‑event vóór het opslaan van succes.

is_playing · yes_no

Huidige waarde voor het geselecteerde item. Lees deze na het gerelateerde event.

is_loaded · yes_no

Huidige waarde voor het geselecteerde item. Lees deze na het gerelateerde event.

is_buffering · yes_no

Huidige waarde voor het geselecteerde item. Lees deze na het gerelateerde event.

current_time · number

Huidige waarde voor het geselecteerde item. Lees deze na het gerelateerde event.

duration · number

Huidige waarde voor het geselecteerde item. Lees deze na het gerelateerde event.

progress · number

Huidige waarde voor het geselecteerde item. Lees deze na het gerelateerde event.

playback_rate · number

Huidige waarde voor het geselecteerde item. Lees deze na het gerelateerde event.

volume · number

Huidige waarde voor het geselecteerde item. Lees deze na het gerelateerde event.

is_looping · yes_no

Huidige waarde voor het geselecteerde item. Lees deze na het gerelateerde event.

waveform_available · yes_no

Huidige waarde voor het geselecteerde item. Lees deze na het gerelateerde event.

waveform_status · text

Huidig resultaat van deze actie. Gebruik het bijpassende voltooiings‑event vóór het opslaan van succes.

error_code · text

Foutinformatie voor de laatste actie. Toon een nuttig bericht en bied de relevante herpoging aan.

Evenementen

ready

Wanneer dit evenement plaatsvindt, lees dan de gerelateerde toestanden van hetzelfde element.

playback_started

Wanneer dit evenement plaatsvindt, lees dan de gerelateerde toestanden van hetzelfde element.

playback_paused

Wanneer dit evenement plaatsvindt, lees dan de gerelateerde toestanden van hetzelfde element.

playback_ended

Wanneer dit evenement plaatsvindt, lees dan de gerelateerde toestanden van hetzelfde element.

seek_completed

Wanneer dit evenement plaatsvindt, lees dan de gerelateerde toestanden van hetzelfde element.

rate_changed

Wanneer dit evenement plaatsvindt, lees dan de gerelateerde toestanden van hetzelfde element.

player_error

Wanneer dit evenement plaatsvindt, lees dan de gerelateerde toestanden van hetzelfde element.

Vragen die ontwikkelaars stellen

Maakt het de golfvorm?

Nee. Lever echte genormaliseerde pieken voor die bron; gewone voortgang werkt zonder.

Hoe werkt het abonnement?

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.

Gerelateerde handleidingen

Voor hulp, vertel ons welke plugin en welk apparaat u gebruikt, welke actie u probeerde en wat er gebeurde. Gebruik een voorbeeld zonder persoonlijke gegevens. Deel nooit uw sleutel of privé‑bestanden.