Audio Player viðmót með dæmi um titil.
Audio Player viðmót með dæmi um titil.
← Allar leiðbeiningar fyrir native-viðbætur

Xodera Plugins · Bubble Native

Xodera Audio Player Native

Bættu við hreinum hljóðspilara í kennsluefni, talboð eða vöruskrár. Leyfðu fólki að hlusta, breyta hraða og halda áfram frá vistuðum stað.

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.

Skjölun yfirfarin 6 nóvember 2026

Hagnýt dæmi

Röddaskýringar í stuðningssamræðu

Einfaldur skráartengill sendir notendur í burtu frá samtalinu og gerir löngum svörum erfitt að yfirfara.

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

Settu spilarann í upplýsingasýn valinna skilaboða. Leyfðu notandanum að nota Play/Pause, Seek til að fara á gagnlegan stað og Set speed. Tengdu `is_active` við það hvort samtalið er opið.

Notaðu `is_playing`, `current_time` og `duration` til að sýna framvindu. Haltu Message auðkenni í forritinu þínu svo seint atvik geti ekki uppfært annað samtal.

Við `player_error`, sýndu `error_code` og bjóðaðu Reload source; varðveittu skilaboðið og merkja það aldrei sem hlustað eftir villu.

Aðeins afspilun. Forritið þitt vistar hlustunarframvindu.

Halda áfram í tungumálakennslu á vistuðu stað.

Nemendur þurfa að endurspila erfiðan kafla í stað þess að hefja alla kennsluna upp á nýtt.

`source_url = Current Lesson’s audio URL`; `title = Current Lesson’s name`; síðasti staðsetningin tilheyrir þeim nemanda og kennslu í gagnagrunninum þínum.

Eftir `ready` fyrir núverandi kennslu, Seek í vistuðu sekúndum og bíddu eftir að notandinn Play. Notaðu Set speed til hægari hlustunar. Vistaðu framvindu með eigin forritsflæði.

Lesið `current_time` og `duration`. Við `playback_ended` getur forritið þitt skráð hlustunarmörk fyrir núverandi Lesson.

Ef uppruni breytist, hafðu gömlu staðsetningunni til hliðar þar til kennslan er hlaðin. Ekki líta á lokun hlustunar sem sönnun um að nemandi hafi skilið eða staðist próf.

Aðeins afspilun. Forritið þitt vistar hlustunarframvindu.

Endurskoða hljóðviðhengi með tímamerktum athugasemdum

Ritstjórar eða þjálfarar þurfa að hoppa frá athugasemd til viðeigandi augnabliks í upptöku.

`source_url = Selected Review’s recording URL`; hver athugasemd í forritinu geymir sinn eigin sekúndugildi; valfrjáls `waveform_peaks_json` inniheldur raunveruleg toppar fyrir sömu upptöku.

Smelltu á athugasemd → Seek í sekúndurnar → Play. Við breytingu á uppruna, skiptu út eða hreinsaðu toppana og binddu valda Endurskoðun aftur.

Sýndu `current_time` við hlið reitsins þar sem athugasemdin er skrifuð. `waveform_available` segir viðmótinu hvort raunverulegir toppar sem þú hefur látið í té séu tiltækir.

Færðu úrelt tímamerki innan marka núverandi lengdar upptökunnar í forritinu eða hafnaðu þeim. Þegar engir raunverulegir toppar eru til staðar skaltu sýna venjulega framvindustýringu í stað uppspunninnar hljóðgreiningar.

Aðeins afspilun. Forritið þitt vistar hlustunarframvindu.

Hvað virkar núna

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.

Búðu til vinnuflæðið

Notaðu tiltækar beta-aðgerðir hér að neðan og prófaðu niðurstöðuna á marktækjunum þínum.

Þessi dæmi nota gagnaskrár forritsins, svo sem Lesson, Message og Order. Skiptu þeim út fyrir þínar eigin gagnategundir og nöfn viðmótsþátta. Skiptu slóðum að dæmismiðlum út fyrir slóðir að þínum eigin skrám.

  1. Bættu við hljóðatriðinu. Stilltu source_url = Selected Message's audio_url, title = Selected Message's sender_label og subtitle = Selected Message's date_label.

  2. Ef þú hefur raunveruleg bylgjulínugögn fyrir þessa upptöku, gefðu þau í waveform_peaks_json. Annars skaltu láta það vera tómt.

  3. Þegar atburðurinn ready á sér stað, notaðu Seek með vistuðum sekúndum ef þarf. Leyfðu notandanum að ýta á Play. Notaðu Pause, Seek og Set speed fyrir spilarhnappa.

  4. Sýndu current_time og duration. Á playback_ended, vistaðu hlustun framvindu fyrir valið skeyti eða kennslu. Stilltu is_active eftir því hvort þessi sýn er opin.

Vinnuflæðiritning — ekki skjámynd forrits

Stilla einu sinni

Búðu til eða veldu Bubble forritaverkefnið í BestPlugins → Dashboard → Plugins. Veldu Xodera Audio Player Native, afritaðu lykilinn, opnaðu síðan Bubble → Plugins → Xodera Audio Player Native og límdu hann í licensing_api_key. Vistaðu einu sinni; notaðu síðan aðgerðirnar hér að neðan. Hver viðbót í hverju verkefni hefur sinn eigin lykil.

Notaðu beina hljóðskráarslóð sem forritið getur opnað. Spilun hljóðs krefst ekki aðgangs að hljóðnema eða myndavél.

Stilla einu sinni
  1. Búðu til eða veldu Bubble forritaverkefnið í BestPlugins → Dashboard → Plugins.
  2. Veldu þessa viðbót og afritaðu verkefnalykilinn.
  3. Open Bubble → Plugins → this plugin. Paste its project key into licensing_api_key and save.
  4. Bættu við atriðinu, veldu forritagögnin þín og byggðu vinnuferlið hér að neðan.
  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.
Uppsetning og áskrift

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.

Vistaðu niðurstöðuna í forritinu þínu

Dæmi ListeningProgress: owner = Current User, lesson = Selected Lesson, seconds = Audio Player's current_time, duration = Audio Player's duration. Vistaðu þegar notandinn gerir hlé eða yfirgefur kennsluna, frekar en við hverja skjáuppfærslu.

Bilun, afturköllun og endurheimt

Á player_error, sýndu error_code og bjóðaðu Reload source. Haltu skeyti eða kennsluskrá. Þegar annað upptaka er valið, hlaða inn eigin vistuðu stöðu. Að fara aftur í sýnina byrjar ekki sjálfkrafa afspilun.

Möguleikar og takmarkanir

Afspilunarhraði: 1, 1.5 og 2. Hljóðstyrkur: 0–1. Bylgjuformsgögn: 2–2048 gildi á bilinu 0 til 1. Studd hljóðsnið fara eftir tækinu. Spilarinn tekur ekki upp hljóð, afritar það ekki í texta og vistar það ekki varanlega til notkunar án nettengingar. Afspilun í bakgrunni eða á lásskjá er ekki tryggð.

Stillingar, aðgerðir og niðurstöður

Notaðu þessi nöfn í Bubble. Áætlaðir eiginleikar eru merktir aðskilt.

Fáanleg beta stillingar

Stillingar atriðis

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

Stöður

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

Atburðir

readyplayback_startedplayback_pausedplayback_endedseek_completedrate_changedplayer_error

Aðgerðir og inntök þeirra

PlayPauseToggleStopSeekSet speedSet volumeReload source
Stillingar atriðis · 11
source_urltext · Sjálfgefið: ""
Dæmi um gildihttps://bestplugins.online/native-samples/lesson.mp3
Dæmi um Bubble-segðSelected Message's audio_url
Slóð að valinni hljóð-, myndskeiðs- eða myndskrá. Notaðu skráargerð sem þessi viðbót styður.
waveform_peaks_jsontext · Sjálfgefið: ""
Dæmi um gildi[0.1,0.4,0.2,0.7]
Dæmi um Bubble-segðSelected Message's waveform_peaks_json
Raunveruleg normalíseruð hljóðstyrksgildi fyrir þessa upptöku; skildu eftir tómt ef ekki tiltækt.
titletext · Sjálfgefið: ""
Dæmi um gildiLesson 4 — review
Dæmi um Bubble-segðSelected Lesson's name
Sýnilegur texti í forritinu; ef reiturinn er tómur er innbyggður staðfærður texti notaður þar sem hann er studdur. Ekki setja inn aðgangsupplýsingar.
subtitletext · Sjálfgefið: ""
Dæmi um gildiTeacher · today
Dæmi um Bubble-segðSelected Message's sender_label
Sýnilegur texti í forritinu; ef reiturinn er tómur er innbyggður staðfærður texti notaður þar sem hann er studdur. Ekki setja inn aðgangsupplýsingar.
playback_ratenumber · Sjálfgefið: 1
Dæmi um gildi1.5
Dæmi um Bubble-segðCurrent User's listening_speed
Notaðu gildi núverandi viðskiptaskrár; staðfestu það gegn takmörkunum hér að neðan.
volumenumber · Sjálfgefið: 1
Dæmi um gildi0.8
Dæmi um Bubble-segðVolume Slider's value
Notaðu gildi núverandi viðskiptaskrár; staðfestu það gegn takmörkunum hér að neðan.
loopyes_no · Sjálfgefið: false
Dæmi um gildino
Dæmi um Bubble-segðSelected Lesson's repeat_enabled
Notaðu gildi núverandi viðskiptaskrár; staðfestu það gegn takmörkunum hér að neðan.
is_activeyes_no · Sjálfgefið: true
Dæmi um gildiyes
Dæmi um Bubble-segðGuideHost's view_is_active (your yes/no custom state)
Stilltu yes á meðan þessi sýn er opin. Stilltu no þegar hún er yfirgefin svo afspilun eða núverandi vinna geti stöðvast.
disabledyes_no · Sjálfgefið: false
Dæmi um gildino
Dæmi um Bubble-segðGuideHost's is_busy (your yes/no custom state)
Óvirkjaðu þennan þátt þegar forritið er upptekið eða aðgerð er ekki tiltæk.
ui_text_jsontext · Sjálfgefið: ""
Dæmi um gildi{}
Dæmi um Bubble-segðApp Settings' player_labels_json (supported keys only)
Valfrjálst JSON með studdum hnappamerkingum. Skildu eftir tómt til að nota innbyggðan texta.
languagetext · Sjálfgefið: "auto"
Dæmi um gildiuk
Dæmi um Bubble-segðCurrent User's preferred_language
Stilltu language=auto til að fylgja tungumáli tækisins eða vafrans ef stuðningur er við það. Sláðu inn studdan tungumálakóða til að velja tungumál sérstaklega.
Aðgerðir og inntök þeirra · 8
Play

Engir aðgerðarbreytur

Pause

Engir aðgerðarbreytur

Toggle

Engir aðgerðarbreytur

Stop

Engir aðgerðarbreytur

Seek
secondsnumber · Sjálfgefið: —
Dæmi um gildi12
Dæmi um Bubble-segðSelected Comment's seconds
Notaðu gildi núverandi viðskiptaskrár; staðfestu það gegn takmörkunum hér að neðan.
Set speed
ratenumber · Sjálfgefið: —
Dæmi um gildi1.5
Dæmi um Bubble-segðSpeed Dropdown's value
Notaðu gildi núverandi viðskiptaskrár; staðfestu það gegn takmörkunum hér að neðan.
Set volume
volumenumber · Sjálfgefið: —
Dæmi um gildi0.8
Dæmi um Bubble-segðVolume Slider's value
Notaðu gildi núverandi viðskiptaskrár; staðfestu það gegn takmörkunum hér að neðan.
Reload source

Engir aðgerðarbreytur

Stöður og atburðir

Stöður

player_status · text

Núverandi niðurstaða þessa aðgerðar. Notaðu samsvarandi lokaatburð áður en þú vistar árangur.

is_playing · yes_no

Núverandi gildi fyrir valinn hlut. Lestu það eftir tengdan atburð.

is_loaded · yes_no

Núverandi gildi fyrir valinn hlut. Lestu það eftir tengdan atburð.

is_buffering · yes_no

Núverandi gildi fyrir valinn hlut. Lestu það eftir tengdan atburð.

current_time · number

Núverandi gildi fyrir valinn hlut. Lestu það eftir tengdan atburð.

duration · number

Núverandi gildi fyrir valinn hlut. Lestu það eftir tengdan atburð.

progress · number

Núverandi gildi fyrir valinn hlut. Lestu það eftir tengdan atburð.

playback_rate · number

Núverandi gildi fyrir valinn hlut. Lestu það eftir tengdan atburð.

volume · number

Núverandi gildi fyrir valinn hlut. Lestu það eftir tengdan atburð.

is_looping · yes_no

Núverandi gildi fyrir valinn hlut. Lestu það eftir tengdan atburð.

waveform_available · yes_no

Núverandi gildi fyrir valinn hlut. Lestu það eftir tengdan atburð.

waveform_status · text

Núverandi niðurstaða þessa aðgerðar. Notaðu samsvarandi lokaatburð áður en þú vistar árangur.

error_code · text

Villumeldingar og aðrar villuupplýsingar fyrir síðustu aðgerð. Sýndu gagnleg skilaboð og bjóddu viðeigandi endurtilraun.

Atburðir

ready

Þegar þessi atburður á sér stað skaltu lesa tengdar stöður úr sama viðmótsþætti.

playback_started

Þegar þessi atburður á sér stað skaltu lesa tengdar stöður úr sama viðmótsþætti.

playback_paused

Þegar þessi atburður á sér stað skaltu lesa tengdar stöður úr sama viðmótsþætti.

playback_ended

Þegar þessi atburður á sér stað skaltu lesa tengdar stöður úr sama viðmótsþætti.

seek_completed

Þegar þessi atburður á sér stað skaltu lesa tengdar stöður úr sama viðmótsþætti.

rate_changed

Þegar þessi atburður á sér stað skaltu lesa tengdar stöður úr sama viðmótsþætti.

player_error

Þegar þessi atburður á sér stað skaltu lesa tengdar stöður úr sama viðmótsþætti.

Spurningar sem þróunaraðilar spyrja

Býr það til bylgjulínuna?

Nei. Veittu raunveruleg normaliseruð toppar fyrir þann uppruna; venjuleg framvinda virkar án þeirra.

Hvernig virkar áskriftin?

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.

Tengdar leiðbeiningar

Fyrir aðstoð, segðu okkur hvaða viðbót og tæki þú notar, aðgerðina sem þú reyndir og hvað gerðist. Notaðu dæmi án persónuupplýsinga. Deildu aldrei lykli þínum eða einkaskrám.