Xodera Plugins · Bubble Native
Xodera Audio Player Native
Lisää selkeä äänensoitin oppitunteihin, ääniviesteihin tai tuotetietueisiin. Anna käyttäjien kuunnella, säätää nopeutta ja jatkaa tallennetusta kohdasta.
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.
Dokumentaatio tarkistettu 6 marraskuussa 2026
Käytännön esimerkit
Äänimuistiinpanot tukikeskustelun sisällä
Tavallinen tiedostolinkki ohjaa käyttäjät pois keskustelusta ja tekee pitkistä vastauksista vaikeita tarkastella.
`source_url = Selected Message’s audio URL`; `title = Selected Message’s sender label`; `subtitle = Selected Message’s timestamp`.
Siirrä toistin valitun viestin tarkennukseen. Anna käyttäjän Play/Pause, Seek hyödylliseen kohtaan ja Set speed. Sidota `is_active` avoimeen keskusteluun.
Käytä `is_playing`, `current_time` ja `duration` edistymisen näyttämiseen. Säilytä Message‑tunnus sovelluksessasi, jotta myöhäinen tapahtuma ei voi päivittää toista keskustelua.
`player_error`:n yhteydessä näytä `error_code` ja tarjoa Reload source; säilytä viesti äläkä koskaan merkitse sitä kuulluksi virheen jälkeen.
Vain toisto. Sovelluksesi tallentaa kuuntelun edistymisen.
Jatka kielituntia tallennetusta kohdasta
Oppijoiden täytyy toistaa vaikea kohta sen sijaan, että aloittaisivat koko oppitunnin alusta.
`source_url = Current Lesson’s audio URL`; `title = Current Lesson’s name`; viimeinen sijainti kuuluu kyseiselle oppijalle ja oppitunnille tietokannassasi.
Kun `ready` on suoritettu nykyiselle oppitunnille, Seek tallennettuihin sekunteihin ja odota käyttäjän Play. Käytä Set speed hitaampaan kuunteluun. Tallenna edistyminen omassa sovellusprosessissasi.
Lue `current_time` ja `duration`. `playback_ended`:n yhteydessä sovelluksesi voi tallentaa kuuntelun virstanpylvään nykyiselle Lesson:lle.
Jos lähde on vaihtunut, hylkää vanha sijainti, kunnes oppitunti on ladattu. Älä pidä kuuntelun päättymistä todisteena siitä, että oppija on ymmärtänyt tai läpäissyt testin.
Vain toisto. Sovelluksesi tallentaa kuuntelun edistymisen.
Tarkastele ääniliitettä aikaleimatuilla kommenteilla
Editoreiden tai kouluttajien täytyy siirtyä kommentista tallenteen asiaankuuluvaan hetkeen.
`source_url = Selected Review’s recording URL`; jokainen sovelluksen hallinnoima kommentti tallentaa oman sekuntiarvonsa; valinnainen `waveform_peaks_json` sisältää todelliset huiput samalle tallenteelle.
Napsauta kommenttia → Seek sen sekunteihin → Play. Lähteen vaihtuessa korvaa tai tyhjennä huiput ja yhdistä valittu arviointi uudelleen.
Näytä `current_time` kommenttieditorin vieressä. `waveform_available` kertoo käyttöliittymällesi, ovatko todelliset toimitetut huiput saatavilla.
Rajoita tai hylkää vanhentuneet aikaleimat sovelluksesi nykyistä kestoa vastaan. Jos todellisia huippuja ei ole, näytä tavallinen edistymiskontrolli keksittyjen äänianalyysien sijaan.
Vain toisto. Sovelluksesi tallentaa kuuntelun edistymisen.
Mikä toimii nyt
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.
Rakenna työnkulku
Käytä alla olevia saatavilla olevia beta‑toimintoja ja testaa tulosta kohdelaitteillasi.
Nämä esimerkit käyttävät sovellustietueita, kuten Lesson, Message ja Order. Korvaa ne omilla tietotyypeilläsi ja elementtien nimillä. Esimerkkimediaosoitteet on korvattava omilla tiedostoillasi.
Lisää äänielementti. Aseta source_url = Selected Message's audio_url, title = Selected Message's sender_label ja subtitle = Selected Message's date_label.
Jos sinulla on todellista aaltomuotodataa tälle tallenteelle, anna se waveform_peaks_json:ssä. Muussa tapauksessa jätä se tyhjäksi.
ready-tapahtuman jälkeen, käytä Seek tallennetun sekuntimäärän kanssa tarvittaessa. Anna käyttäjän painaa Play. Käytä Pause, Seek ja Set speed soittimen painikkeina.
Näytä current_time ja duration. playback_ended:ssä tallenna kuuntelun edistyminen valitulle viestille tai oppitunnille. Aseta is_active sen mukaan, onko tämä näkymä avoinna.
Määritä kerran
Luo tai valitse Bubble‑sovellusprojekti BestPlugins → Dashboard → Plugins. Valitse Xodera Audio Player Native, kopioi sen avain, avaa sitten Bubble → Plugins → Xodera Audio Player Native ja liitä se licensing_api_key:ään. Tallenna kerran; käytä sitten alla olevia toimintoja. Jokaisella liitännäisellä jokaisessa projektissa on oma avain.
Käytä suoraa äänitiedoston osoitetta, jonka sovellus voi avata. Äänen toistaminen ei vaadi mikrofonin tai kameran käyttöoikeutta.
Määritä kerran
- Luo tai valitse Bubble‑sovellusprojekti BestPlugins → Dashboard → Plugins.
- Valitse tämä liitännäinen ja kopioi sen projektin avain.
- Open Bubble → Plugins → this plugin. Paste its project key into licensing_api_key and save.
- Lisää elementti, valitse sovellustietosi ja rakenna alla oleva työnkulku.
- 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.
Asennus ja tilaus
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.
Tallenna tulos sovellukseesi
Esimerkki ListeningProgress: owner = Current User, lesson = Selected Lesson, seconds = Audio Player's current_time, duration = Audio Player's duration. Tallenna, kun käyttäjä keskeyttää tai poistuu oppitunnilta, sen sijaan että tallentaisit jokaisella näytön päivityksellä.
Epäonnistuminen, peruutus ja palautus
player_error:ssä näytä error_code ja tarjoa Reload source. Säilytä viesti- tai oppituntitietue. Kun valitaan eri tallenne, lataa sen oma tallennettu sijainti. Paluu näkymään ei käynnistä toistoa automaattisesti.
Ominaisuudet ja rajoitukset
Toistonopeudet: 1, 1.5 ja 2. Äänenvoimakkuus: 0–1. Aaltomuotodataa: 2–2048 arvot 0 ja 1 välillä. Tuetut äänitiedostomuodot riippuvat laitteesta. Soitin ei tallenna, litteroi tai säilytä ääntä pysyvästi offline‑käyttöä varten. Taustatoistoa ja lukitusnäytön toistoa ei voida taata.
Asetukset, toiminnot ja tulokset
Käytä näitä nimiä Bubble:ssa. Suunnitellut ominaisuudet on merkitty erikseen.
Käytettävissä olevat beta-asetukset
Elementin asetukset
source_url · textwaveform_peaks_json · texttitle · textsubtitle · textplayback_rate · numbervolume · numberloop · yes_nois_active · yes_nodisabled · yes_noui_text_json · textlanguage · textTilat
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 · textTapahtumat
readyplayback_startedplayback_pausedplayback_endedseek_completedrate_changedplayer_errorToiminnot ja niiden syötteet
PlayPauseToggleStopSeekSet speedSet volumeReload sourceElementin asetukset · 11
source_urltext · Oletus: ""- Esimerkkisarvo
https://bestplugins.online/native-samples/lesson.mp3 - Esimerkki Bubble -lauseke
Selected Message's audio_url - Valitun ääni-, video- tai kuvatiedoston osoite. Käytä tiedostotyyppiä, jota tämä liitännäinen tukee.
waveform_peaks_jsontext · Oletus: ""- Esimerkkisarvo
[0.1,0.4,0.2,0.7] - Esimerkki Bubble -lauseke
Selected Message's waveform_peaks_json - Tämän tallenteen todelliset normalisoidut amplitudiarvot; jätä tyhjäksi, jos ei saatavilla.
titletext · Oletus: ""- Esimerkkisarvo
Lesson 4 — review - Esimerkki Bubble -lauseke
Selected Lesson's name - Näkyvä sovellusteksti; tyhjä käyttää sisäänrakennettua lokalisoitua tekstiä, jos tuettu. Ei tunnistetietoja.
subtitletext · Oletus: ""- Esimerkkisarvo
Teacher · today - Esimerkki Bubble -lauseke
Selected Message's sender_label - Näkyvä sovellusteksti; tyhjä käyttää sisäänrakennettua lokalisoitua tekstiä, jos tuettu. Ei tunnistetietoja.
playback_ratenumber · Oletus: 1- Esimerkkisarvo
1.5 - Esimerkki Bubble -lauseke
Current User's listening_speed - Käytä nykyisen liiketoimintatietueen arvoa; tarkista se alla olevia rajoja vastaan.
volumenumber · Oletus: 1- Esimerkkisarvo
0.8 - Esimerkki Bubble -lauseke
Volume Slider's value - Käytä nykyisen liiketoimintatietueen arvoa; tarkista se alla olevia rajoja vastaan.
loopyes_no · Oletus: false- Esimerkkisarvo
no - Esimerkki Bubble -lauseke
Selected Lesson's repeat_enabled - Käytä nykyisen liiketoimintatietueen arvoa; tarkista se alla olevia rajoja vastaan.
is_activeyes_no · Oletus: true- Esimerkkisarvo
yes - Esimerkki Bubble -lauseke
GuideHost's view_is_active (your yes/no custom state) - Aseta kyllä, kun tämä näkymä on auki. Aseta ei, kun poistutaan, jotta toisto tai nykyinen työ voi pysähtyä.
disabledyes_no · Oletus: false- Esimerkkisarvo
no - Esimerkki Bubble -lauseke
GuideHost's is_busy (your yes/no custom state) - Poista elementti käytöstä, kun sovelluksesi on kiireinen tai tämä toiminto ei ole saatavilla.
ui_text_jsontext · Oletus: ""- Esimerkkisarvo
{} - Esimerkki Bubble -lauseke
App Settings' player_labels_json (supported keys only) - Valinnainen JSON tuetuilla painikkeen teksteillä. Jätä tyhjäksi käyttääksesi sisäänrakennettua tekstiä.
languagetext · Oletus: "auto"- Esimerkkisarvo
uk - Esimerkki Bubble -lauseke
Current User's preferred_language - Aseta language=auto seuraamaan tuettua laitetta tai selaimen kieltä. Syötä tuettu kielikoodi valitaksesi sen eksplisiittisesti.
Toiminnot ja niiden syötteet · 8
Play
Ei toiminto‑parametreja
Pause
Ei toiminto‑parametreja
Toggle
Ei toiminto‑parametreja
Stop
Ei toiminto‑parametreja
Seek
secondsnumber · Oletus: —- Esimerkkisarvo
12 - Esimerkki Bubble -lauseke
Selected Comment's seconds - Käytä nykyisen liiketoimintatietueen arvoa; tarkista se alla olevia rajoja vastaan.
Set speed
ratenumber · Oletus: —- Esimerkkisarvo
1.5 - Esimerkki Bubble -lauseke
Speed Dropdown's value - Käytä nykyisen liiketoimintatietueen arvoa; tarkista se alla olevia rajoja vastaan.
Set volume
volumenumber · Oletus: —- Esimerkkisarvo
0.8 - Esimerkki Bubble -lauseke
Volume Slider's value - Käytä nykyisen liiketoimintatietueen arvoa; tarkista se alla olevia rajoja vastaan.
Reload source
Ei toiminto‑parametreja
Tilat ja tapahtumat
Tilat
player_status · textTämän toiminnon nykyinen tulos. Käytä vastaavaa valmistumistapahtumaa ennen onnistuneen tallennuksen tekemistä.
is_playing · yes_noValitun kohteen nykyinen arvo. Lue se liittyvän tapahtuman jälkeen.
is_loaded · yes_noValitun kohteen nykyinen arvo. Lue se liittyvän tapahtuman jälkeen.
is_buffering · yes_noValitun kohteen nykyinen arvo. Lue se liittyvän tapahtuman jälkeen.
current_time · numberValitun kohteen nykyinen arvo. Lue se liittyvän tapahtuman jälkeen.
duration · numberValitun kohteen nykyinen arvo. Lue se liittyvän tapahtuman jälkeen.
progress · numberValitun kohteen nykyinen arvo. Lue se liittyvän tapahtuman jälkeen.
playback_rate · numberValitun kohteen nykyinen arvo. Lue se liittyvän tapahtuman jälkeen.
volume · numberValitun kohteen nykyinen arvo. Lue se liittyvän tapahtuman jälkeen.
is_looping · yes_noValitun kohteen nykyinen arvo. Lue se liittyvän tapahtuman jälkeen.
waveform_available · yes_noValitun kohteen nykyinen arvo. Lue se liittyvän tapahtuman jälkeen.
waveform_status · textTämän toiminnon nykyinen tulos. Käytä vastaavaa valmistumistapahtumaa ennen onnistuneen tallennuksen tekemistä.
error_code · textViimeisen toiminnon virhetiedot. Näytä hyödyllinen viesti ja tarjoa asiaankuuluva uudelleenyritys.
Tapahtumat
readyKun tämä tapahtuma tapahtuu, lue siihen liittyvät tilat samasta elementistä.
playback_startedKun tämä tapahtuma tapahtuu, lue siihen liittyvät tilat samasta elementistä.
playback_pausedKun tämä tapahtuma tapahtuu, lue siihen liittyvät tilat samasta elementistä.
playback_endedKun tämä tapahtuma tapahtuu, lue siihen liittyvät tilat samasta elementistä.
seek_completedKun tämä tapahtuma tapahtuu, lue siihen liittyvät tilat samasta elementistä.
rate_changedKun tämä tapahtuma tapahtuu, lue siihen liittyvät tilat samasta elementistä.
player_errorKun tämä tapahtuma tapahtuu, lue siihen liittyvät tilat samasta elementistä.
Kysymykset, joita kehittäjät esittävät
Luo se aaltomuodon?
Ei. Toimita todelliset normalisoidut huiput kyseiselle lähteelle; tavallinen edistyminen toimii ilman niitä.
Miten tilaus toimii?
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.
Aiheeseen liittyvät oppaat
Avun saamiseksi kerro, mitä lisäosaa ja laitetta käytät, mitä toimintoa yritit ja mitä tapahtui. Käytä esimerkkiä ilman henkilötietoja. Älä koskaan jaa avaintasi tai yksityisiä tiedostoja.