Xodera Plugins · Bubble Native
Xodera Audio Player Native
Pridėkite aiškų garso grotuvą prie pamokų, balso žinučių ar produktų įrašų. Leiskite vartotojams klausytis, keisti greitį ir tęsti nuo išsaugotos vietos.
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.
Dokumentacija peržiūrėta 6 lapkričio 2026
Praktiniai pavyzdžiai
Balso užrašai palaikymo pokalbyje
Paprastas failo nuoroda nukreipia vartotojus iš pokalbio ir apsunkina ilgo atsakymo peržiūrą.
`source_url = Selected Message’s audio URL`; `title = Selected Message’s sender label`; `subtitle = Selected Message’s timestamp`.
Įdėkite grotuvą į pasirinkto pranešimo išsamą informaciją. Leiskite vartotojui Play/Pause, Seek iki naudingos vietos ir Set speed. Susiekite `is_active` su atvira pokalbio sesija.
Naudokite `is_playing`, `current_time` ir `duration` progresui rodyti. Laikykite Message ID savo programoje, kad vėlesnis įvykis negalėtų atnaujinti kito pokalbio.
`player_error` metu rodykite `error_code` ir siūlykite Reload source; išsaugokite pranešimą ir niekada nepažymėkite jo kaip išklausyto po klaidos.
Tik atkūrimas. Jūsų programa išsaugo klausymo progresą.
Tęsti kalbos pamoką iš išsaugotos vietos
Mokiniams reikia pakartoti sudėtingą fragmentą, o ne pradėti visą pamoką iš naujo.
`source_url = Current Lesson’s audio URL`; `title = Current Lesson’s name`; paskutinė pozicija priklauso tam mokiniui ir pamokai jūsų duomenų bazėje.
Po `ready` dabartinei pamokai, Seek iki išsaugotų sekundžių ir lauktite, kol vartotojas Play. Naudokite Set speed lėtesniam klausymui. Išsaugokite progresą naudodami savo programos darbo eigą.
Perskaitykite `current_time` ir `duration`. `playback_ended` metu jūsų programa gali įrašyti klausymo etapą dabartiniam Lesson.
Jei šaltinis pasikeitė, atmesti seną poziciją, kol pamoka nebus įkelta. Nevertinkite klausymo pabaigos kaip įrodymo, kad mokinys suprato arba išlaikė testą.
Tik atkūrimas. Jūsų programa išsaugo klausymo progresą.
Peržiūrėti garso priedą su laiko žymėmis komentarų
Redaktoriai ar treneriai turi peršokti iš komentaro į atitinkamą momentą įraše.
`source_url = Selected Review’s recording URL`; kiekvienas programos valdomas komentaras saugo savo sekundžių reikšmę; neprivalomas `waveform_peaks_json` turi realius viršūnių taškus tam pačiam įrašui.
Spustelėkite komentarą → Seek iki jo sekundžių → Play. Šaltinio pasikeitus, pakeiskite arba išvalykite viršūnes ir vėl susiekite pasirinktą peržiūrą.
Rodykite `current_time` šalia savo komentaro kūrėjo. `waveform_available` informuoja jūsų UI, ar yra prieinamos pateiktos viršūnės.
Apribok arba atmesti pasenusius laiko žymenis pagal dabartinį trukmės laiką programoje. Kai nėra tikrų viršūnių, rodyk įprastą progreso valdiklį, o ne sugalvotą garso analizę.
Tik atkūrimas. Jūsų programa išsaugo klausymo progresą.
Kas veikia dabar
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.
Sukurkite darbo srautą
Naudokite žemiau pateiktas prieinamas beta veiksmus ir išbandykite rezultatą savo tiksliniuose įrenginiuose.
Šie pavyzdžiai naudoja programos įrašus, tokius kaip Lesson, Message ir Order. Pakeiskite juos savo duomenų tipais ir elementų pavadinimais. Pavyzdiniai medijos adresai turi būti pakeisti jūsų failais.
Pridėkite garso elementą. Nustatykite source_url = Selected Message's audio_url, title = Selected Message's sender_label ir subtitle = Selected Message's date_label.
Jei turite tikrus bangos formos duomenis šiam įrašui, perduokite juos waveform_peaks_json. Priešingu atveju palikite tuščią.
Kai įvyksta ready, naudokite Seek su išsaugotu sekundžių skaičiumi, jei reikia. Leiskite vartotojui paspausti Play. Naudokite Pause, Seek ir Set speed grotuvo mygtukams.
Rodykite current_time ir duration. playback_ended atveju, išsaugokite klausymo progresą pasirinktai žinutei arba pamokai. Nustatykite is_active, ar šis vaizdas yra atvertas.
Konfigūruokite vieną kartą
Sukurkite arba pasirinkite savo Bubble programos projektą BestPlugins → Dashboard → Plugins. Pasirinkite Xodera Audio Player Native, nukopijuokite jo raktą, tada atidarykite Bubble → Plugins → Xodera Audio Player Native ir įklijuokite jį į licensing_api_key. Išsaugokite vieną kartą; tada naudokite žemiau esančius veiksmus. Kiekvienas įskiepis kiekviename projekte turi savo raktą.
Naudokite tiesioginį garso failo adresą, kurį programa gali atverti. Garso atkūrimas nereikalauja mikrofono ar kameros prieigos.
Konfigūruokite vieną kartą
- Sukurkite arba pasirinkite savo Bubble programos projektą BestPlugins → Dashboard → Plugins.
- Pasirinkite šį įskiepį ir nukopijuokite jo projekto raktą.
- Open Bubble → Plugins → this plugin. Paste its project key into licensing_api_key and save.
- Pridėkite elementą, pasirinkite savo programos duomenis ir sukurkite žemiau esantį darbo srautą.
- 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.
Įdiegimas ir prenumerata
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.
Išsaugokite rezultatą savo programoje
Pavyzdys ListeningProgress: owner = Current User, lesson = Selected Lesson, seconds = Audio Player's current_time, duration = Audio Player's duration. Išsaugokite, kai vartotojas pristabdo arba palieka pamoką, o ne kiekvieno ekrano atnaujinimo metu.
Gedimas, atšaukimas ir atkūrimas
player_error atveju, rodykite error_code ir siūlykite Reload source. Išsaugokite žinutės arba pamokos įrašą. Kai pasirenkamas kitas įrašas, įkelkite jo išsaugotą poziciją. Grįžus į vaizdą, atkūrimas nepradedamas automatiškai.
Galimybės ir apribojimai
Atkūrimo greičiai: 1, 1.5 ir 2. Garsumas: 0–1. Garso bangos formos duomenys: 2–2048 reikšmės nuo 0 iki 1. Palaikomi garso formatai priklauso nuo įrenginio. Grotuvas neįrašo garso, neatlieka garso transkripcijos ir neišsaugo jo visam laikui naudoti be interneto. Atkūrimas fone ir užrakintame ekrane negarantuojamas.
Nustatymai, veiksmai ir rezultatai
Naudokite šiuos pavadinimus Bubble. Planuojamos funkcijos pažymėtos atskirai.
Prieinami beta nustatymai
Elemento nustatymai
source_url · textwaveform_peaks_json · texttitle · textsubtitle · textplayback_rate · numbervolume · numberloop · yes_nois_active · yes_nodisabled · yes_noui_text_json · textlanguage · textBūsenos
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Įvykiai
readyplayback_startedplayback_pausedplayback_endedseek_completedrate_changedplayer_errorVeiksmai ir jų įvestys
PlayPauseToggleStopSeekSet speedSet volumeReload sourceElemento nustatymai · 11
source_urltext · Numatytasis: ""- Pavyzdinė reikšmė
https://bestplugins.online/native-samples/lesson.mp3 - Pavyzdinis Bubble išraiška
Selected Message's audio_url - Pasirinkto garso, vaizdo arba paveikslėlio failo adresas. Naudokite šio įskiepio palaikomą failo tipą.
waveform_peaks_jsontext · Numatytasis: ""- Pavyzdinė reikšmė
[0.1,0.4,0.2,0.7] - Pavyzdinis Bubble išraiška
Selected Message's waveform_peaks_json - Realios normalizuotos amplitudės reikšmės šiam įrašui; jei neprieinama, palikite tuščią.
titletext · Numatytasis: ""- Pavyzdinė reikšmė
Lesson 4 — review - Pavyzdinis Bubble išraiška
Selected Lesson's name - Matomas programos tekstas; jei tuščias, naudojama įdiegta lokalizuota kopija, kur palaikoma. Nėra kredencialų.
subtitletext · Numatytasis: ""- Pavyzdinė reikšmė
Teacher · today - Pavyzdinis Bubble išraiška
Selected Message's sender_label - Matomas programos tekstas; jei tuščias, naudojama įdiegta lokalizuota kopija, kur palaikoma. Nėra kredencialų.
playback_ratenumber · Numatytasis: 1- Pavyzdinė reikšmė
1.5 - Pavyzdinis Bubble išraiška
Current User's listening_speed - Naudokite dabartinio verslo įrašo reikšmę; patikrinkite ją pagal žemiau pateiktas ribas.
volumenumber · Numatytasis: 1- Pavyzdinė reikšmė
0.8 - Pavyzdinis Bubble išraiška
Volume Slider's value - Naudokite dabartinio verslo įrašo reikšmę; patikrinkite ją pagal žemiau pateiktas ribas.
loopyes_no · Numatytasis: false- Pavyzdinė reikšmė
no - Pavyzdinis Bubble išraiška
Selected Lesson's repeat_enabled - Naudokite dabartinio verslo įrašo reikšmę; patikrinkite ją pagal žemiau pateiktas ribas.
is_activeyes_no · Numatytasis: true- Pavyzdinė reikšmė
yes - Pavyzdinis Bubble išraiška
GuideHost's view_is_active (your yes/no custom state) - Nustatykite taip, kai šis vaizdas atvertas. Nustatykite ne, kai išeinate, kad atkūrimas arba dabartinis darbas galėtų sustoti.
disabledyes_no · Numatytasis: false- Pavyzdinė reikšmė
no - Pavyzdinis Bubble išraiška
GuideHost's is_busy (your yes/no custom state) - Išjunkite elementą, kai programa užimta arba šis veiksmas neprieinamas.
ui_text_jsontext · Numatytasis: ""- Pavyzdinė reikšmė
{} - Pavyzdinis Bubble išraiška
App Settings' player_labels_json (supported keys only) - Pasirenkamas JSON su palaikomais mygtukų etiketėmis. Palikite tuščią, kad naudotumėte įdiegtą tekstą.
languagetext · Numatytasis: "auto"- Pavyzdinė reikšmė
uk - Pavyzdinis Bubble išraiška
Current User's preferred_language - Nustatykite language=auto sekti palaikomą įrenginį arba naršyklės kalbą. Įveskite palaikomą kalbos kodą, kad pasirinktumėte ją tiesiogiai.
Veiksmai ir jų įvestys · 8
Play
Nėra veiksmų parametrų
Pause
Nėra veiksmų parametrų
Toggle
Nėra veiksmų parametrų
Stop
Nėra veiksmų parametrų
Seek
secondsnumber · Numatytasis: —- Pavyzdinė reikšmė
12 - Pavyzdinis Bubble išraiška
Selected Comment's seconds - Naudokite dabartinio verslo įrašo reikšmę; patikrinkite ją pagal žemiau pateiktas ribas.
Set speed
ratenumber · Numatytasis: —- Pavyzdinė reikšmė
1.5 - Pavyzdinis Bubble išraiška
Speed Dropdown's value - Naudokite dabartinio verslo įrašo reikšmę; patikrinkite ją pagal žemiau pateiktas ribas.
Set volume
volumenumber · Numatytasis: —- Pavyzdinė reikšmė
0.8 - Pavyzdinis Bubble išraiška
Volume Slider's value - Naudokite dabartinio verslo įrašo reikšmę; patikrinkite ją pagal žemiau pateiktas ribas.
Reload source
Nėra veiksmų parametrų
Būsenos ir įvykiai
Būsenos
player_status · textDabartinis šio veiksmo rezultatas. Naudokite atitinkamą užbaigimo įvykį prieš išsaugant sėkmę.
is_playing · yes_noDabartinė pasirinkto elemento reikšmė. Perskaitykite ją po susijusio įvykio.
is_loaded · yes_noDabartinė pasirinkto elemento reikšmė. Perskaitykite ją po susijusio įvykio.
is_buffering · yes_noDabartinė pasirinkto elemento reikšmė. Perskaitykite ją po susijusio įvykio.
current_time · numberDabartinė pasirinkto elemento reikšmė. Perskaitykite ją po susijusio įvykio.
duration · numberDabartinė pasirinkto elemento reikšmė. Perskaitykite ją po susijusio įvykio.
progress · numberDabartinė pasirinkto elemento reikšmė. Perskaitykite ją po susijusio įvykio.
playback_rate · numberDabartinė pasirinkto elemento reikšmė. Perskaitykite ją po susijusio įvykio.
volume · numberDabartinė pasirinkto elemento reikšmė. Perskaitykite ją po susijusio įvykio.
is_looping · yes_noDabartinė pasirinkto elemento reikšmė. Perskaitykite ją po susijusio įvykio.
waveform_available · yes_noDabartinė pasirinkto elemento reikšmė. Perskaitykite ją po susijusio įvykio.
waveform_status · textDabartinis šio veiksmo rezultatas. Naudokite atitinkamą užbaigimo įvykį prieš išsaugant sėkmę.
error_code · textPaskutinio veiksmo klaidos informacija. Rodykite naudingą pranešimą ir pasiūlykite atitinkamą pakartojimą.
Įvykiai
readyKai įvyksta šis įvykis, perskaitykite susijusias būsenas iš to paties elemento.
playback_startedKai įvyksta šis įvykis, perskaitykite susijusias būsenas iš to paties elemento.
playback_pausedKai įvyksta šis įvykis, perskaitykite susijusias būsenas iš to paties elemento.
playback_endedKai įvyksta šis įvykis, perskaitykite susijusias būsenas iš to paties elemento.
seek_completedKai įvyksta šis įvykis, perskaitykite susijusias būsenas iš to paties elemento.
rate_changedKai įvyksta šis įvykis, perskaitykite susijusias būsenas iš to paties elemento.
player_errorKai įvyksta šis įvykis, perskaitykite susijusias būsenas iš to paties elemento.
Klausimai, kuriuos užduoda kūrėjai
Ar jis sukuria bangos formą?
Ne. Pateikite realius normalizuotus viršūnių taškus šiam šaltiniui; įprastas progresas veikia be jų.
Kaip veikia prenumerata?
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.
Susijusios gairės
Pagalbos prašym, nurodykite, kurį papildinį ir įrenginį naudojate, kokį veiksmą bandėte ir kas įvyko. Naudokite pavyzdį be asmeninių duomenų. Niekada nesidalinkite savo raktu ar privačiais failais.