Kiolesura cha Audio Player na kichwa cha mfano.
Kiolesura cha Audio Player na kichwa cha mfano.
← Miongozo yote ya Bubble Native

Xodera Plugins · Bubble Native

Xodera Audio Player Native

Ongeza kichezaji cha sauti kilicho wazi kwenye masomo, ujumbe wa sauti au rekodi za bidhaa. Ruhusu watu kusikiliza, kubadilisha kasi na kuendelea kutoka sehemu waliyoihifadhi.

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.

Nyaraka zilizokaguliwa 6 Novemba 2026

Mifano ya vitendo

Ujumbe wa sauti ndani ya mazungumzo ya usaidizi

Kiungo cha faili kilicho wazi humpeleka watumiaji mbali na mazungumzo na humfanya mapitio ya majibu marefu kuwa magumu.

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

Weka kichezaji katika maelezo ya ujumbe uliochaguliwa. Ruhusu mtumiaji Play/Pause, Seek hadi hatua yenye manufaa na Set speed. Unganisha `is_active` na mazungumzo yaliyofunguliwa.

Tumia `is_playing`, `current_time` na `duration` kuonyesha maendeleo. Hifadhi kitambulisho cha Message katika programu yako ili tukio la kuchelewa lisoweze kusasisha mazungumzo mengine.

Wakati wa `player_error`, onyesha `error_code` na toa Reload source; hifadhi ujumbe na usiuiweke alisikiliwa baada ya hitilafu.

Usikilizi tu. Programu yako huhifadhi maendeleo ya kusikiliza.

Endelea na somo la lugha kutoka nafasi iliyohifadhiwa

Wanafunzi wanahitaji kurudia kipande kigumu badala ya kuanza upya somo lote.

`source_url = Current Lesson’s audio URL`; `title = Current Lesson’s name`; nafasi ya mwisho ni ya mwanafunzi huyo na somo katika hifadhidata yako.

Baada ya `ready` kwa somo la sasa, Seek hadi sekunde zilizohifadhiwa na subiri mtumiaji a Play. Tumia Set speed kwa kusikiliza polepole. Hifadhi maendeleo kwa mtiririko wa kazi wa programu yako.

Soma `current_time` na `duration`. Katika `playback_ended`, programu yako inaweza kurekodi hatua ya kusikiliza kwa Lesson ya sasa.

Kama chanzo kimebadilika, puuza nafasi ya zamani hadi somo hilo lipakiwe. Usichukue kukamilika kwa kusikiliza kama ushahidi kwamba mwanafunzi alielewa au alipita mtihani.

Usikilizi tu. Programu yako huhifadhi maendeleo ya kusikiliza.

Kagua kiambatisho cha sauti chenye maoni yaliyo na alama za wakati

Wahariri au wakufunzi wanahitaji kuruka kutoka kwa maoni hadi wakati unaofaa katika rekodi.

`source_url = Selected Review’s recording URL`; kila Maoni yanayomilikiwa na programu huhifadhi thamani yake ya sekunde; `waveform_peaks_json` ya hiari ina kilele halisi kwa rekodi ile ile.

Bofya Maoni → Seek hadi sekunde zake → Play. Wakati wa mabadiliko ya chanzo, badilisha au futa kilele na uunganishe Tathmini iliyochaguliwa tena.

Onyesha `current_time` kando ya mhariri wa maoni yako. `waveform_available` inaambia UI yako ikiwa kilele kilichotolewa halisi kinapatikana.

Katika programu yako, rekebisha alama za muda zilizopitwa na wakati ili ziwe ndani ya muda wa rekodi ya sasa, au uzikatae. Ikiwa hakuna vilele halisi, onyesha kidhibiti cha kawaida cha maendeleo badala ya uchambuzi wa sauti uliobuniwa.

Usikilizi tu. Programu yako huhifadhi maendeleo ya kusikiliza.

Kinachofanya kazi sasa

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.

Jenga mtiririko wa kazi

Tumia vitendo vya beta vinavyopatikana hapa chini na jaribu matokeo kwenye vifaa unavyolenga.

Mifano hii inatumia rekodi za programu kama Lesson, Message na Order. Zibadilishe kwa aina zako za data na majina ya vipengele. Anwani za media za mfano lazima zibadilishwe na faili zako.

  1. Ongeza kipengele cha sauti. Weka source_url = Selected Message's audio_url, title = Selected Message's sender_label na subtitle = Selected Message's date_label.

  2. Kama una data halisi ya waveform kwa rekodi hii, ipitie katika waveform_peaks_json. Vinginevyo iache tupu.

  3. Wakati tayari inatokea, tumia Seek pamoja na idadi ya sekunde zilizohifadhiwa ikiwa inahitajika. Ruhusu mtumiaji kubofya Play. Tumia Pause, Seek na Set speed kwa vitufe vya kichezaji.

  4. Onyesha current_time na muda. Katika playback_ended, hifadhi maendeleo ya kusikiliza kwa ujumbe au somo lililochaguliwa. Weka is_active kulingana na iwapo mtazamo huu umefunguliwa.

Mchoro wa mtiririko wa kazi — si picha ya programu

Sanidi mara moja

Unda au chagua mradi wako wa Bubble katika BestPlugins → Dashboard → Plugins. Chagua Xodera Audio Player Native, nakili ufunguo wake, kisha fungua Bubble → Plugins → Xodera Audio Player Native na ubandike ndani ya licensing_api_key. Hifadhi mara moja; kisha tumia vitendo hapa chini. Kila plugin katika kila mradi ina ufunguo wake.

Tumia anwani ya faili ya sauti ya moja kwa moja ambayo programu inaweza kufungua. Kucheza sauti hakihitaji ufikiaji wa maikrofoni au kamera.

Sanidi mara moja
  1. Unda au chagua mradi wako wa Bubble katika BestPlugins → Dashboard → Plugins.
  2. Chagua plugin hii na nakili ufunguo wa mradi wake.
  3. Open Bubble → Plugins → this plugin. Paste its project key into licensing_api_key and save.
  4. Ongeza kipengele, chagua data ya programu yako na jenga mtiririko wa kazi hapa chini.
  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.
Ufungaji na usajili

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.

Hifadhi matokeo katika programu yako

Mfano ListeningProgress: owner = Current User, lesson = Selected Lesson, seconds = Audio Player's current_time, duration = Audio Player's duration. Hifadhi wakati mtumiaji anapumzika au kuondoka kwenye somo, badala ya kwenye kila sasisho la skrini.

Kushindwa, kughairi na urejeshaji

Katika player_error, onyesha error_code na toa Reload source. Hifadhi rekodi ya ujumbe au somo. Wakati rekodi tofauti itachaguliwa, pakia nafasi yake iliyohifadhiwa. Kurudi kwenye mtazamo hakuanzishi kucheza kiotomatiki.

Uwezo na vikwazo

Kasi za kucheza: 1, 1.5 na 2. Kiasi cha sauti: 0–1. Data ya waveform: 2–2048 thamani kati ya 0 na 1. Formati za sauti zinazotumika zinategemea kifaa. Kichezaji hakirekodi, hakibadili sauti kuwa maandishi, wala hakihifadhi sauti kwa kudumu kwa matumizi nje ya mtandao. Uchezaji katika mandharinyuma na skrini ya kufunga haujahakikishwa.

Mipangilio, vitendo na matokeo

Tumia majina haya katika Bubble. Vipengele vilivyopangwa vimewekwa alama kando.

Mipangilio ya beta inayopatikana

Mipangilio ya kipengele

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

Hali

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

Matukio

readyplayback_startedplayback_pausedplayback_endedseek_completedrate_changedplayer_error

Vitendo na ingizo lake

PlayPauseToggleStopSeekSet speedSet volumeReload source
Mipangilio ya kipengele · 11
source_urltext · Chaguo-msingi: ""
Thamani ya mfanohttps://bestplugins.online/native-samples/lesson.mp3
Mfano wa usemi BubbleSelected Message's audio_url
Anwani ya faili ya sauti, video au picha iliyochaguliwa. Tumia aina ya faili ambayo kiendelezi hiki kinasaidia.
waveform_peaks_jsontext · Chaguo-msingi: ""
Thamani ya mfano[0.1,0.4,0.2,0.7]
Mfano wa usemi BubbleSelected Message's waveform_peaks_json
Thamani halisi za amplitudo zilizosawazishwa kwa rekodi hii; iache tupu ikiwa hazipatikani.
titletext · Chaguo-msingi: ""
Thamani ya mfanoLesson 4 — review
Mfano wa usemi BubbleSelected Lesson's name
Maandishi yanayoonekana katika programu; ukiacha tupu, maandishi yaliyotafsiriwa na kujengewa ndani hutumika panapoungwa mkono. Usiweke taarifa za siri za kuingia.
subtitletext · Chaguo-msingi: ""
Thamani ya mfanoTeacher · today
Mfano wa usemi BubbleSelected Message's sender_label
Maandishi yanayoonekana katika programu; ukiacha tupu, maandishi yaliyotafsiriwa na kujengewa ndani hutumika panapoungwa mkono. Usiweke taarifa za siri za kuingia.
playback_ratenumber · Chaguo-msingi: 1
Thamani ya mfano1.5
Mfano wa usemi BubbleCurrent User's listening_speed
Tumia thamani ya rekodi ya biashara ya sasa; thibitisha dhidi ya mipaka ifuatayo.
volumenumber · Chaguo-msingi: 1
Thamani ya mfano0.8
Mfano wa usemi BubbleVolume Slider's value
Tumia thamani ya rekodi ya biashara ya sasa; thibitisha dhidi ya mipaka ifuatayo.
loopyes_no · Chaguo-msingi: false
Thamani ya mfanono
Mfano wa usemi BubbleSelected Lesson's repeat_enabled
Tumia thamani ya rekodi ya biashara ya sasa; thibitisha dhidi ya mipaka ifuatayo.
is_activeyes_no · Chaguo-msingi: true
Thamani ya mfanoyes
Mfano wa usemi BubbleGuideHost's view_is_active (your yes/no custom state)
Weka yes (ndiyo) wakati mwonekano huu uko wazi. Weka no (hapana) unapoondoka, ili uchezaji au kazi ya sasa viweze kusimamishwa.
disabledyes_no · Chaguo-msingi: false
Thamani ya mfanono
Mfano wa usemi BubbleGuideHost's is_busy (your yes/no custom state)
Zima kipengele wakati programu yako ina shughuli au kitendo hiki hakipatikani.
ui_text_jsontext · Chaguo-msingi: ""
Thamani ya mfano{}
Mfano wa usemi BubbleApp Settings' player_labels_json (supported keys only)
JSON ya hiari yenye lebo za vitufe zinazotumika. Iache tupu ili kutumia maandishi yaliyojengewa ndani.
languagetext · Chaguo-msingi: "auto"
Thamani ya mfanouk
Mfano wa usemi BubbleCurrent User's preferred_language
Weka language=auto ili kufuata lugha inayotumika ya kifaa au kivinjari. Ingiza msimbo wa lugha inayotumika ili kuichagua mwenyewe.
Vitendo na ingizo lake · 8
Play

Hakuna vigezo vya kitendo

Pause

Hakuna vigezo vya kitendo

Toggle

Hakuna vigezo vya kitendo

Stop

Hakuna vigezo vya kitendo

Seek
secondsnumber · Chaguo-msingi: —
Thamani ya mfano12
Mfano wa usemi BubbleSelected Comment's seconds
Tumia thamani ya rekodi ya biashara ya sasa; thibitisha dhidi ya mipaka ifuatayo.
Set speed
ratenumber · Chaguo-msingi: —
Thamani ya mfano1.5
Mfano wa usemi BubbleSpeed Dropdown's value
Tumia thamani ya rekodi ya biashara ya sasa; thibitisha dhidi ya mipaka ifuatayo.
Set volume
volumenumber · Chaguo-msingi: —
Thamani ya mfano0.8
Mfano wa usemi BubbleVolume Slider's value
Tumia thamani ya rekodi ya biashara ya sasa; thibitisha dhidi ya mipaka ifuatayo.
Reload source

Hakuna vigezo vya kitendo

Hali na matukio

Hali

player_status · text

Matokeo ya sasa ya kitendo hiki. Tumia tukio la kukamilika linalolingana kabla ya kuhifadhi mafanikio.

is_playing · yes_no

Thamani ya sasa ya kipengele kilichochaguliwa. Isome baada ya tukio linalohusiana.

is_loaded · yes_no

Thamani ya sasa ya kipengele kilichochaguliwa. Isome baada ya tukio linalohusiana.

is_buffering · yes_no

Thamani ya sasa ya kipengele kilichochaguliwa. Isome baada ya tukio linalohusiana.

current_time · number

Thamani ya sasa ya kipengele kilichochaguliwa. Isome baada ya tukio linalohusiana.

duration · number

Thamani ya sasa ya kipengele kilichochaguliwa. Isome baada ya tukio linalohusiana.

progress · number

Thamani ya sasa ya kipengele kilichochaguliwa. Isome baada ya tukio linalohusiana.

playback_rate · number

Thamani ya sasa ya kipengele kilichochaguliwa. Isome baada ya tukio linalohusiana.

volume · number

Thamani ya sasa ya kipengele kilichochaguliwa. Isome baada ya tukio linalohusiana.

is_looping · yes_no

Thamani ya sasa ya kipengele kilichochaguliwa. Isome baada ya tukio linalohusiana.

waveform_available · yes_no

Thamani ya sasa ya kipengele kilichochaguliwa. Isome baada ya tukio linalohusiana.

waveform_status · text

Matokeo ya sasa ya kitendo hiki. Tumia tukio la kukamilika linalolingana kabla ya kuhifadhi mafanikio.

error_code · text

Taarifa ya hitilafu ya kitendo cha mwisho. Onyesha ujumbe wenye msaada na utoe chaguo linalofaa la kujaribu tena.

Matukio

ready

Wakati tukio hili litapotokea, soma hali husika kutoka kwa kipengele hicho.

playback_started

Wakati tukio hili litapotokea, soma hali husika kutoka kwa kipengele hicho.

playback_paused

Wakati tukio hili litapotokea, soma hali husika kutoka kwa kipengele hicho.

playback_ended

Wakati tukio hili litapotokea, soma hali husika kutoka kwa kipengele hicho.

seek_completed

Wakati tukio hili litapotokea, soma hali husika kutoka kwa kipengele hicho.

rate_changed

Wakati tukio hili litapotokea, soma hali husika kutoka kwa kipengele hicho.

player_error

Wakati tukio hili litapotokea, soma hali husika kutoka kwa kipengele hicho.

Maswali yanayoulizwa na wasanidi programu

Je, inaunda waveform?

Hapana. Toa vilele halisi vilivyosawazishwa kwa chanzo hicho; kidhibiti cha kawaida cha maendeleo hufanya kazi bila vilele hivyo.

Usajili unafanya kazi vipi?

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.

Miongozo husika

Kwa msaada, tuambie plugin na kifaa unachotumia, kitendo ulichojaribu na kilichotokea. Tumia mfano usio na data binafsi. Usishiriki ufunguo wako wala faili za kibinafsi.