Xodera Plugins · Bubble Native
Xodera Audio Player Native
Shtoni një lojtës audio të qartë në mësime, mesazhe zanore ose regjistrime produkti. Lejoni përdoruesit të dëgjojnë, të ndryshojnë shpejtësinë dhe të vazhdojnë nga vendi i tyre i ruajtur.
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.
Dokumentacioni i rishikuar 6 November 2026
Shembuj praktikë
Shënime zanore brenda një bisedë mbështetjeje
Një lidhje e thjeshtë skedari dërgon përdoruesit larg bisedës dhe e bën të vështirë rishikimin e përgjigjeve të gjata.
`source_url = Selected Message’s audio URL`; `title = Selected Message’s sender label`; `subtitle = Selected Message’s timestamp`.
Vendoseni lojtësin në detajet e mesazhit të zgjedhur. Lejoni përdoruesin Play/Pause, Seek në një pikë të dobishme dhe Set speed. Lidhni `is_active` me faktin nëse pamja e bisedës është e hapur.
Përdorni `is_playing`, `current_time` dhe `duration` për të shfaqur progresin. Mbani ID-në Message në aplikacionin tuaj që një ngjarje e vonuar të mos përditësojë një bisedë tjetër.
Në `player_error`, shfaqni `error_code` dhe ofroni Reload source; ruani mesazhin dhe mos e shënoni kurrë si i dëgjuar pas një gabimi.
Vetëm riprodhim. Aplikacioni juaj ruan progresin e dëgjimit.
Vazhdoni një mësim gjuhe nga pozicioni i ruajtur
Nxënësit duhet të riprodhojnë një pjesë të vështirë në vend që të rinisin gjithë mësimin.
`source_url = Current Lesson’s audio URL`; `title = Current Lesson’s name`; pozicioni i fundit i përket atij nxënësi dhe mësimit në bazën tuaj të të dhënave.
Pas `ready` për mësimin aktual, Seek te sekondat e ruajtura dhe prisni që përdoruesi të Play. Përdorni Set speed për dëgjim më të ngadalshëm. Ruani progresin me rrjedhën e punës së aplikacionit tuaj.
Lexoni `current_time` dhe `duration`. Në `playback_ended`, aplikacioni juaj mund të regjistrojë një pikë të rëndësishme dëgjimi për Lesson aktual.
Nëse burimi ndryshoi, hidhni pozicionin e vjetër deri sa të ngarkohet ai mësim. Mos e trajtoni përfundimin e dëgjimit si provë se nxënësi e kuptoi ose kaloi një test.
Vetëm riprodhim. Aplikacioni juaj ruan progresin e dëgjimit.
Rishikoni një bashkëngjitje audio me komente me vulë kohore
Redaktorët ose trajnerët duhet të kalojnë nga një koment në momentin përkatës në një regjistrim.
`source_url = Selected Review’s recording URL`; çdo Koment i pronësuar nga aplikacioni ruan vlerën e vet të sekondave; `waveform_peaks_json` opsionale përmban kulmet reale për atë të njëjtën regjistrim.
Klikoni një Koment → Seek te sekondat e tij → Play. Në ndryshim të burimit, zëvendësoni ose pastroni kulmet dhe lidhni përsëri Rishikimin e zgjedhur.
Shfaqni `current_time` pranë fushës ku shkruani komentin. `waveform_available` i tregon UI-së tuaj nëse kulmet e furnizuara aktuale janë të disponueshme.
Kufizoni shenjat kohore të vjetruara brenda kohëzgjatjes aktuale në aplikacionin tuaj ose refuzojini. Kur nuk ka kulme reale, shfaqni kontrollin e zakonshëm të progresit në vend të një analize audio të sajuar.
Vetëm riprodhim. Aplikacioni juaj ruan progresin e dëgjimit.
Çfarë funksionon tani
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.
Krijoni rrjedhën e punës
Përdorni veprimet beta të disponueshme më poshtë dhe testoni rezultatin në pajisjet tuaja të synuara.
Këto shembuj përdorin regjistrime aplikacioni si Lesson, Message dhe Order. Zëvendësoni ato me llojet tuaja të të dhënave dhe emrat e elementeve. Adresat e mediave shembull duhet të zëvendësohen me skedarët tuaj.
Shtoni elementin audio. Vendosni source_url = Selected Message's audio_url, title = Selected Message's sender_label dhe subtitle = Selected Message's date_label.
Nëse keni të dhëna reale të formës valë për këtë regjistrim, kalojini në waveform_peaks_json. Përndryshe lëreni bosh.
Kur ndodh ngjarja ready, përdorni Seek me numrin e ruajtur të sekondave nëse është e nevojshme. Lejoni përdoruesin të shtypë Play. Përdorni Pause, Seek dhe Set speed për butonat e lojtësit.
Shfaqni current_time dhe duration. Në playback_ended, ruani progresin e dëgjimit për mesazhin ose mësimin e zgjedhur. Vendosni is_active sipas faktit nëse kjo pamje është e hapur apo jo.
Konfigurojeni një herë
Krijoni ose zgjidhni projektin tuaj të aplikacionit Bubble në BestPlugins → Dashboard → Plugins. Zgjidhni Xodera Audio Player Native, kopjoni çelësin e tij, pastaj hapni Bubble → Plugins → Xodera Audio Player Native dhe ngjitni në licensing_api_key. Ruani një herë; më pas përdorni veprimet më poshtë. Çdo shtojcë në çdo projekt ka çelësin e vet.
Përdorni një adresë të drejtpërdrejtë të skedarit audio që aplikacioni mund të hapë. Luajtja e audios nuk kërkon akses në mikrofon ose kamerë.
Konfigurojeni një herë
- Krijoni ose zgjidhni projektin tuaj të aplikacionit Bubble në BestPlugins → Dashboard → Plugins.
- Zgjidhni këtë shtojcë dhe kopjoni çelësin e projektit.
- Open Bubble → Plugins → this plugin. Paste its project key into licensing_api_key and save.
- Shtoni elementin, zgjidhni të dhënat e aplikacionit tuaj dhe ndërtoni rrjedhën e punës më poshtë.
- 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.
Instalim dhe abonim
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.
Ruani rezultatin në aplikacionin tuaj
Shembull ListeningProgress: owner = Current User, lesson = Selected Lesson, seconds = Audio Player's current_time, duration = Audio Player's duration. Ruani kur përdoruesi bën pauzë ose largohet nga mësimi, në vend që në çdo përditësim ekrani.
Dështim, anulim dhe rikuperim
Në player_error, shfaq error_code dhe ofro Reload source. Mbani mesazhin ose regjistrin e mësimit. Kur përzgjidhet një regjistrim i ndryshëm, ngarkoni pozicionin e tij të ruajtur. Kthimi në pamje nuk nis luajtjen automatikisht.
Aftësitë dhe kufizimet
Shpejtësitë e luajtjes: 1, 1.5 dhe 2. Volumi: 0–1. Të dhënat e formës valore: 2–2048 vlera midis 0 dhe 1. Formatet audio të mbështetura varen nga pajisja. Lojtësi nuk regjistron, transkribon ose ruan në mënyrë të përhershme audio për përdorim jashtë linje. Luajtja në sfond dhe në ekranin e kyçur nuk garantohet.
Rregullimet, veprimet dhe rezultatet
Përdorni këto emra në Bubble. Veçoritë e planifikuara janë shënuar veçmas.
Cilësimet beta të disponueshme
Rregullimet e elementit
source_url · textwaveform_peaks_json · texttitle · textsubtitle · textplayback_rate · numbervolume · numberloop · yes_nois_active · yes_nodisabled · yes_noui_text_json · textlanguage · textGjendjet
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 · textNgjarjet
readyplayback_startedplayback_pausedplayback_endedseek_completedrate_changedplayer_errorVeprimet dhe inputet e tyre
PlayPauseToggleStopSeekSet speedSet volumeReload sourceRregullimet e elementit · 11
source_urltext · Parazgjedhur: ""- Vlera shembull
https://bestplugins.online/native-samples/lesson.mp3 - Shembull i shprehjes Bubble
Selected Message's audio_url - Adresa e skedarit audio, video ose imazhi të zgjedhur. Përdorni një lloj skedari që ky shtojcë mbulon.
waveform_peaks_jsontext · Parazgjedhur: ""- Vlera shembull
[0.1,0.4,0.2,0.7] - Shembull i shprehjes Bubble
Selected Message's waveform_peaks_json - Vlera reale të normalizuara të amplitudës për këtë regjistrim; lëreni bosh nëse nuk është i disponueshëm.
titletext · Parazgjedhur: ""- Vlera shembull
Lesson 4 — review - Shembull i shprehjes Bubble
Selected Lesson's name - Teksti i dukshëm i aplikacionit; bosh përdor kopjen e brendshme të lokalizuar ku mbështetet. Pa kredenciale.
subtitletext · Parazgjedhur: ""- Vlera shembull
Teacher · today - Shembull i shprehjes Bubble
Selected Message's sender_label - Teksti i dukshëm i aplikacionit; bosh përdor kopjen e brendshme të lokalizuar ku mbështetet. Pa kredenciale.
playback_ratenumber · Parazgjedhur: 1- Vlera shembull
1.5 - Shembull i shprehjes Bubble
Current User's listening_speed - Përdorni vlerën e regjistrimit aktual të biznesit; verifikojeni kundrejt kufijve më poshtë.
volumenumber · Parazgjedhur: 1- Vlera shembull
0.8 - Shembull i shprehjes Bubble
Volume Slider's value - Përdorni vlerën e regjistrimit aktual të biznesit; verifikojeni kundrejt kufijve më poshtë.
loopyes_no · Parazgjedhur: false- Vlera shembull
no - Shembull i shprehjes Bubble
Selected Lesson's repeat_enabled - Përdorni vlerën e regjistrimit aktual të biznesit; verifikojeni kundrejt kufijve më poshtë.
is_activeyes_no · Parazgjedhur: true- Vlera shembull
yes - Shembull i shprehjes Bubble
GuideHost's view_is_active (your yes/no custom state) - Vendosni yes ndërsa kjo pamje është e hapur. Vendosni no kur dilni, në mënyrë që riprodhimi ose puna aktuale të mund të ndalojë.
disabledyes_no · Parazgjedhur: false- Vlera shembull
no - Shembull i shprehjes Bubble
GuideHost's is_busy (your yes/no custom state) - Çaktivizo elementin ndërsa aplikacioni juaj është i zënë ose kjo veprim është i padisponueshëm.
ui_text_jsontext · Parazgjedhur: ""- Vlera shembull
{} - Shembull i shprehjes Bubble
App Settings' player_labels_json (supported keys only) - JSON opsionale me etiketa butonash të mbështetura. Lëreni bosh për të përdorur tekstin e brendshëm.
languagetext · Parazgjedhur: "auto"- Vlera shembull
uk - Shembull i shprehjes Bubble
Current User's preferred_language - Vendosni language=auto për të ndjekur gjuhën e pajisjes ose të shfletuesit, nëse ajo mbështetet. Futni një kod gjuhe të mbështetur për ta zgjedhur gjuhën shprehimisht.
Veprimet dhe inputet e tyre · 8
Play
Pa parametra veprimi
Pause
Pa parametra veprimi
Toggle
Pa parametra veprimi
Stop
Pa parametra veprimi
Seek
secondsnumber · Parazgjedhur: —- Vlera shembull
12 - Shembull i shprehjes Bubble
Selected Comment's seconds - Përdorni vlerën e regjistrimit aktual të biznesit; verifikojeni kundrejt kufijve më poshtë.
Set speed
ratenumber · Parazgjedhur: —- Vlera shembull
1.5 - Shembull i shprehjes Bubble
Speed Dropdown's value - Përdorni vlerën e regjistrimit aktual të biznesit; verifikojeni kundrejt kufijve më poshtë.
Set volume
volumenumber · Parazgjedhur: —- Vlera shembull
0.8 - Shembull i shprehjes Bubble
Volume Slider's value - Përdorni vlerën e regjistrimit aktual të biznesit; verifikojeni kundrejt kufijve më poshtë.
Reload source
Pa parametra veprimi
Gjendjet dhe ngjarjet
Gjendjet
player_status · textRezultati aktual i kësaj veprimi. Përdorni ngjarjen përfundimtare përkatëse përpara se të ruani suksesin.
is_playing · yes_noVlera aktuale për elementin e zgjedhur. Lexojeni pas ngjarjes përkatëse.
is_loaded · yes_noVlera aktuale për elementin e zgjedhur. Lexojeni pas ngjarjes përkatëse.
is_buffering · yes_noVlera aktuale për elementin e zgjedhur. Lexojeni pas ngjarjes përkatëse.
current_time · numberVlera aktuale për elementin e zgjedhur. Lexojeni pas ngjarjes përkatëse.
duration · numberVlera aktuale për elementin e zgjedhur. Lexojeni pas ngjarjes përkatëse.
progress · numberVlera aktuale për elementin e zgjedhur. Lexojeni pas ngjarjes përkatëse.
playback_rate · numberVlera aktuale për elementin e zgjedhur. Lexojeni pas ngjarjes përkatëse.
volume · numberVlera aktuale për elementin e zgjedhur. Lexojeni pas ngjarjes përkatëse.
is_looping · yes_noVlera aktuale për elementin e zgjedhur. Lexojeni pas ngjarjes përkatëse.
waveform_available · yes_noVlera aktuale për elementin e zgjedhur. Lexojeni pas ngjarjes përkatëse.
waveform_status · textRezultati aktual i kësaj veprimi. Përdorni ngjarjen përfundimtare përkatëse përpara se të ruani suksesin.
error_code · textInformacioni i gabimit për veprimin e fundit. Shfaqni një mesazh i dobishëm dhe ofroni riprovimin përkatës.
Ngjarjet
readyKur ndodh kjo ngjarje, lexoni gjendjet përkatëse nga i njëjti element.
playback_startedKur ndodh kjo ngjarje, lexoni gjendjet përkatëse nga i njëjti element.
playback_pausedKur ndodh kjo ngjarje, lexoni gjendjet përkatëse nga i njëjti element.
playback_endedKur ndodh kjo ngjarje, lexoni gjendjet përkatëse nga i njëjti element.
seek_completedKur ndodh kjo ngjarje, lexoni gjendjet përkatëse nga i njëjti element.
rate_changedKur ndodh kjo ngjarje, lexoni gjendjet përkatëse nga i njëjti element.
player_errorKur ndodh kjo ngjarje, lexoni gjendjet përkatëse nga i njëjti element.
Pyetjet që bëjnë zhvilluesit
A e krijon valëformën?
Jo. Furnizoni kulmet e normalizuara realë për atë burim; progresi i zakonshëm funksionon pa to.
Si funksionon abonimi?
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.
Udhëzues të lidhur
Për ndihmë, na tregoni cilin shtojcë dhe pajisje përdorni, veprimin që provuat dhe çfarë ndodhi. Përdorni një shembull pa të dhëna personale. Kurrë mos ndani çelësin tuaj ose skedarët privatë.