Rhyngwyneb Audio Player gyda theitl enghreifftiol.
Rhyngwyneb Audio Player gyda theitl enghreifftiol.
← Pob canllaw Bubble Native

Xodera Plugins · Bubble Native

Xodera Audio Player Native

Ychwanegwch chwaraewr sain clir i wersyiadau, negeseuon llais neu gofnodion cynnyrch. Caniatáu i bobl wrando, newid cyflymder a pharhau o'u lle wedi'i gadw.

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.

Dogfennaeth wedi’i hadolygu ar 6 Tachwedd 2026

Enghreifftiau ymarferol

Nodiadau llais o fewn sgwrs cymorth

Mae dolen ffeil syml yn anfon defnyddwyr i ffwrdd o'r sgwrs ac yn gwneud atebion hir yn anodd i'w hadolygu.

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

Gosodwch y chwaraewr yn fanylion y neges a ddewiswyd. Gadewch i'r defnyddiwr Play/Pause, Seek i bwynt defnyddiol a Set speed. Cysylltwch `is_active` â'r sgwrs agored.

Defnyddiwch `is_playing`, `current_time` a `duration` i ddangos cynnydd. Cadwch yr ID Message yn eich app fel na all digwyddiad hwyr ddiweddaru sgwrs wahanol.

Ar `player_error`, dangoswch `error_code` a chynnig Reload source; cadwch y neges a pheidiwch byth â'i marcio fel un y gwrandawyd arni ar ôl gwall.

Chwarae'n ôl yn unig. Mae eich app yn cadw cynnydd gwrando.

Parhau â gwers iaith o'r safle a gadwyd

Mae angen i ddysgwyr ailchwarae darn anodd yn lle ailgychwyn y wers gyfan.

`source_url = Current Lesson’s audio URL`; `title = Current Lesson’s name`; mae'r safle olaf yn perthyn i'r dysgwr a'r gwers hwnnw yn eich cronfa ddata.

Ar ôl `ready` ar gyfer y gwers gyfredol, Seek i'r eiliadau a gadwyd a disgwyl i'r defnyddiwr Play. Defnyddiwch Set speed ar gyfer gwrando araf. Cadwch y cynnydd gyda llif gwaith eich app eich hun.

Darllen `current_time` a `duration`. Ar `playback_ended`, gall eich app gofnodi marc gwrando ar gyfer y Lesson cyfredol.

Os yw'r ffynhonnell wedi newid, diystyrwch yr hen safle nes bod y wers honno wedi'i llwytho. Peidiwch â thrin cwblhau'r gwrando fel prawf bod y dysgwr wedi deall neu wedi pasio prawf.

Chwarae'n ôl yn unig. Mae eich app yn cadw cynnydd gwrando.

Adolygu atodiad sain gyda sylwadau wedi'u stampio amser

Mae golygyddion neu hyfforddwyr angen neidio o sylw i'r eiliad perthnasol mewn recordiad.

`source_url = Selected Review’s recording URL`; mae pob cofnod Comment sy'n eiddo i'r ap yn storio ei werth eiliadau ei hun; mae'r `waveform_peaks_json` dewisol yn cynnwys gwerthoedd brig gwirioneddol ar gyfer yr un recordiad.

Cliciwch ar Comment → Seek i'w eiliadau → Play. Pan fydd y ffynhonnell yn newid, disodlwch neu gliriwch y gwerthoedd brig a rhwymwch y Review a ddewiswyd eto.

Dangoswch `current_time` wrth ymyl eich maes ysgrifennu sylwadau. Mae `waveform_available` yn dweud wrth eich UI a oes gwerthoedd brig gwirioneddol wedi'u darparu.

Cyfyngwch hen stampiau amser i'r hyd cyfredol yn eich ap, neu eu gwrthod. Pan nad oes gwerthoedd brig gwirioneddol, dangoswch y rheolydd cynnydd arferol yn hytrach na dadansoddiad sain wedi'i ddyfeisio.

Chwarae'n ôl yn unig. Mae eich app yn cadw cynnydd gwrando.

Beth sy'n gweithio nawr

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.

Creu'r gweithdull

Defnyddiwch y gweithredoedd beta sydd ar gael isod a phrofwch y canlyniad ar eich dyfeisiau targed.

Defnyddir y enghreifftiau hyn cofnodion app fel Lesson, Message a Order. Disodlwch nhw gyda'ch mathau data eich hun a enwau elfennau. Rhaid disodli cyfeiriadau cyfryngau enghreifftiol gyda'ch ffeiliau eich hun.

  1. Ychwanegwch yr elfen sain. Gosod source_url = Selected Message's audio_url, title = Selected Message's sender_label a subtitle = Selected Message's date_label.

  2. Os oes gennych ddata ffurf ton gwirioneddol ar gyfer y recordiad hwn, pasiwch ef i waveform_peaks_json. Fel arall, gadewch iddo fod yn wag.

  3. Pan fydd ready yn digwydd, defnyddiwch Seek gyda'r nifer o eiliadau a gadwyd os oes angen. Gadewch i'r defnyddiwr bwyso Play. Defnyddiwch Pause, Seek a Set speed ar gyfer botymau'r chwaraewr.

  4. Dangoswch current_time a duration. Ar playback_ended, cadwch gynnydd gwrando ar gyfer y neges neu'r wers a ddewiswyd. Gosodwch is_active yn ôl a yw'r olygfa hon ar agor.

Diagram llif gwaith — nid sgrinlun app

Ffurfweddu unwaith

Creuwch neu dewiswch eich prosiect app Bubble yn BestPlugins → Dashboard → Plugins. Dewiswch Xodera Audio Player Native, copïwch ei allwedd, yna agorwch Bubble → Plugins → Xodera Audio Player Native a'i gludo i licensing_api_key. Cadwch unwaith; yna defnyddiwch y gweithredoedd isod. Mae gan bob ategyn mewn pob prosiect ei allwedd ei hun.

Defnyddiwch gyfeiriad ffeil sain uniongyrchol y gall yr app ei agor. Nid oes angen mynediad i'r meicroffon na'r camera i chwarae sain.

Ffurfweddu unwaith
  1. Creuwch neu dewiswch eich prosiect app Bubble yn BestPlugins → Dashboard → Plugins.
  2. Dewiswch yr ategyn hwn a chopiwch ei allwedd prosiect.
  3. Open Bubble → Plugins → this plugin. Paste its project key into licensing_api_key and save.
  4. Ychwanegwch yr elfen, dewiswch eich data app a chreu'r llif gwaith isod.
  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.
Gosod a thanysgrifiad

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.

Cadw'r canlyniad yn eich ap

Enghraifft ListeningProgress: owner = Current User, lesson = Selected Lesson, seconds = Audio Player's current_time, duration = Audio Player's duration. Cadwch pan fydd y defnyddiwr yn seibio neu'n gadael y wers, yn hytrach na phob diweddariad sgrîn.

Methiant, canslo a adfer

Ar player_error, dangos error_code a chynnig Reload source. Cadwch y neges neu'r cofnod wers. Pan ddewisir recordiad gwahanol, llwythwch ei leoliad wedi'i gadw ei hun. Nid yw dychwelyd i'r golwg yn cychwyn y chwarae'n awtomatig.

Galluoedd a chyfyngiadau

Cyflymderau chwarae: 1, 1.5 a 2. Lefel sain: 0–1. Data ffurf ton: 2–2048 gwerthoedd rhwng 0 a 1. Mae'r fformatau sain a gefnogir yn dibynnu ar y ddyfais. Nid yw'r chwaraewr yn recordio, trawsgrifio na chadw sain yn barhaol ar gyfer defnydd all-lein. Nid yw chwarae cefndir a'r sgrîn cloi yn cael eu gwarantu.

Gosodiadau, gweithredoedd a chanlyniadau

Defnyddiwch y enwau hyn yn Bubble. Nodir nodweddion a gynlluniwyd ar wahân.

Gosodiadau beta ar gael

Gosodiadau elfen

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

Cyflyrau

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

Digwyddiadau

readyplayback_startedplayback_pausedplayback_endedseek_completedrate_changedplayer_error

Gweithredoedd a'u mewnbynnau

PlayPauseToggleStopSeekSet speedSet volumeReload source
Gosodiadau elfen · 11
source_urltext · Rhagosodedig: ""
Gwerth enghreifftiolhttps://bestplugins.online/native-samples/lesson.mp3
Enghraifft o fynegiad BubbleSelected Message's audio_url
Cyfeiriad y ffeil sain, fideo neu ddelwedd a ddewiswyd. Defnyddiwch fath ffeil y mae'r ategyn hwn yn ei gefnogi.
waveform_peaks_jsontext · Rhagosodedig: ""
Gwerth enghreifftiol[0.1,0.4,0.2,0.7]
Enghraifft o fynegiad BubbleSelected Message's waveform_peaks_json
Gwerthoedd osgled gwirioneddol wedi'u normaleiddio ar gyfer y recordiad hwn; gadewch yn wag os nad ydynt ar gael.
titletext · Rhagosodedig: ""
Gwerth enghreifftiolLesson 4 — review
Enghraifft o fynegiad BubbleSelected Lesson's name
Testun app gweladwy; mae'n wag yn defnyddio copi leoleiddiedig mewnol lle mae'n cael ei gefnogi. Dim manylion mewngofnodi.
subtitletext · Rhagosodedig: ""
Gwerth enghreifftiolTeacher · today
Enghraifft o fynegiad BubbleSelected Message's sender_label
Testun app gweladwy; mae'n wag yn defnyddio copi leoleiddiedig mewnol lle mae'n cael ei gefnogi. Dim manylion mewngofnodi.
playback_ratenumber · Rhagosodedig: 1
Gwerth enghreifftiol1.5
Enghraifft o fynegiad BubbleCurrent User's listening_speed
Defnyddiwch werth y cofnod busnes cyfredol; dilyswch ef yn erbyn y terfynau isod.
volumenumber · Rhagosodedig: 1
Gwerth enghreifftiol0.8
Enghraifft o fynegiad BubbleVolume Slider's value
Defnyddiwch werth y cofnod busnes cyfredol; dilyswch ef yn erbyn y terfynau isod.
loopyes_no · Rhagosodedig: false
Gwerth enghreifftiolno
Enghraifft o fynegiad BubbleSelected Lesson's repeat_enabled
Defnyddiwch werth y cofnod busnes cyfredol; dilyswch ef yn erbyn y terfynau isod.
is_activeyes_no · Rhagosodedig: true
Gwerth enghreifftiolyes
Enghraifft o fynegiad BubbleGuideHost's view_is_active (your yes/no custom state)
Gosodwch yes tra bo'r olygfa hon ar agor. Gosodwch no wrth adael, fel y gall chwarae neu'r gwaith cyfredol stopio.
disabledyes_no · Rhagosodedig: false
Gwerth enghreifftiolno
Enghraifft o fynegiad BubbleGuideHost's is_busy (your yes/no custom state)
Analluogwch yr elfen tra mae eich app yn brysur neu mae'r weithred hon ddim ar gael.
ui_text_jsontext · Rhagosodedig: ""
Gwerth enghreifftiol{}
Enghraifft o fynegiad BubbleApp Settings' player_labels_json (supported keys only)
JSON dewisol gyda labeli botwm sy'n cael eu cefnogi. Gadewch yn wag i ddefnyddio'r testun mewnol.
languagetext · Rhagosodedig: "auto"
Gwerth enghreifftioluk
Enghraifft o fynegiad BubbleCurrent User's preferred_language
Gosodwch language=auto i ddilyn iaith y ddyfais neu'r porwr, os yw'r iaith honno'n cael ei chefnogi. Rhowch god iaith a gefnogir i ddewis yr iaith yn benodol.
Gweithredoedd a'u mewnbynnau · 8
Play

Dim paramedrau gweithred

Pause

Dim paramedrau gweithred

Toggle

Dim paramedrau gweithred

Stop

Dim paramedrau gweithred

Seek
secondsnumber · Rhagosodedig: —
Gwerth enghreifftiol12
Enghraifft o fynegiad BubbleSelected Comment's seconds
Defnyddiwch werth y cofnod busnes cyfredol; dilyswch ef yn erbyn y terfynau isod.
Set speed
ratenumber · Rhagosodedig: —
Gwerth enghreifftiol1.5
Enghraifft o fynegiad BubbleSpeed Dropdown's value
Defnyddiwch werth y cofnod busnes cyfredol; dilyswch ef yn erbyn y terfynau isod.
Set volume
volumenumber · Rhagosodedig: —
Gwerth enghreifftiol0.8
Enghraifft o fynegiad BubbleVolume Slider's value
Defnyddiwch werth y cofnod busnes cyfredol; dilyswch ef yn erbyn y terfynau isod.
Reload source

Dim paramedrau gweithred

Cyflyrau a digwyddiadau

Cyflyrau

player_status · text

Canlyniad cyfredol y weithred hon. Defnyddiwch y digwyddiad cwblhau cyfatebol cyn arbed llwyddiant.

is_playing · yes_no

Gwerth cyfredol yr eitem a ddewiswyd. Darllenwch ef ar ôl y digwyddiad cysylltiedig.

is_loaded · yes_no

Gwerth cyfredol yr eitem a ddewiswyd. Darllenwch ef ar ôl y digwyddiad cysylltiedig.

is_buffering · yes_no

Gwerth cyfredol yr eitem a ddewiswyd. Darllenwch ef ar ôl y digwyddiad cysylltiedig.

current_time · number

Gwerth cyfredol yr eitem a ddewiswyd. Darllenwch ef ar ôl y digwyddiad cysylltiedig.

duration · number

Gwerth cyfredol yr eitem a ddewiswyd. Darllenwch ef ar ôl y digwyddiad cysylltiedig.

progress · number

Gwerth cyfredol yr eitem a ddewiswyd. Darllenwch ef ar ôl y digwyddiad cysylltiedig.

playback_rate · number

Gwerth cyfredol yr eitem a ddewiswyd. Darllenwch ef ar ôl y digwyddiad cysylltiedig.

volume · number

Gwerth cyfredol yr eitem a ddewiswyd. Darllenwch ef ar ôl y digwyddiad cysylltiedig.

is_looping · yes_no

Gwerth cyfredol yr eitem a ddewiswyd. Darllenwch ef ar ôl y digwyddiad cysylltiedig.

waveform_available · yes_no

Gwerth cyfredol yr eitem a ddewiswyd. Darllenwch ef ar ôl y digwyddiad cysylltiedig.

waveform_status · text

Canlyniad cyfredol y weithred hon. Defnyddiwch y digwyddiad cwblhau cyfatebol cyn arbed llwyddiant.

error_code · text

Gwybodaeth gwall am y weithred diwethaf. Dangoswch neges ddefnyddiol a chynnig y ceisiad ailadrodd perthnasol.

Digwyddiadau

ready

Pan fydd y digwyddiad hwn yn digwydd, darllenwch y cyflyrau cysylltiedig o'r un elfen.

playback_started

Pan fydd y digwyddiad hwn yn digwydd, darllenwch y cyflyrau cysylltiedig o'r un elfen.

playback_paused

Pan fydd y digwyddiad hwn yn digwydd, darllenwch y cyflyrau cysylltiedig o'r un elfen.

playback_ended

Pan fydd y digwyddiad hwn yn digwydd, darllenwch y cyflyrau cysylltiedig o'r un elfen.

seek_completed

Pan fydd y digwyddiad hwn yn digwydd, darllenwch y cyflyrau cysylltiedig o'r un elfen.

rate_changed

Pan fydd y digwyddiad hwn yn digwydd, darllenwch y cyflyrau cysylltiedig o'r un elfen.

player_error

Pan fydd y digwyddiad hwn yn digwydd, darllenwch y cyflyrau cysylltiedig o'r un elfen.

Cwestiynau y mae datblygwyr yn eu gofyn

A yw'n creu'r tonffurf?

Na. Darparwch werthoedd brig gwirioneddol wedi'u normaleiddio ar gyfer y ffynhonnell honno; mae'r cynnydd arferol yn gweithio hebddynt.

Sut mae'r tanysgrifiad yn gweithio?

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.

Canllawiau cysylltiedig

Am gymorth, dywedwch wrthym pa ategyn a dyfais rydych chi'n eu defnyddio, y weithred a cheisiwyd a beth ddigwyddodd. Defnyddiwch enghraifft heb ddata personol. Peidiwch byth â rhannu eich allwedd na'ch ffeiliau preifat.