Audio Player ինտերֆեյս օրինակային վերնագրով.

Xodera Plugins · Bubble Native

Xodera Audio Player Native

Ավելացրեք պարզ ձայնային պլեյեր դասերին, ձայնային հաղորդագրություններին կամ ապրանքի գրառումների մեջ։ Թույլ տվեք լսել, փոխել արագությունը և շարունակել պահպանված դիրքից։

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.

Ստեղծեք աշխատանքային հոսքը ↓Պլագինի կարգավորումներ ↗Native Lab

Փաստաթղթերը վերանայված 6 նոյեմբեր 2026

Պրակտիկ օրինակներ

Ձայնագրություններ աջակցման զրույցի ներսում

Պարզ ֆայլի հղումը ուղարկում է օգտատերերին զրույցից դուրս և բերում է երկար պատասխանների վերանայումին դժվարություն։

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

Դիրքադրեք պլեյերը ընտրված-հաղորդագրության մանրամասում։ Թույլ տվեք օգտատիրոջը Play/Pause, Seek օգտակար կետում և Set speed։ Կապեք `is_active` բաց զրույցին։

Օգտագործեք `is_playing`, `current_time` և `duration`՝ առաջընթացը ցույց տալու համար։ Պահեք Message ID-ը ձեր հավելվածում, որպեսզի ուշ իրադարձությունը չկարողանա թարմացնել այլ զրույց։

`player_error`-ի դեպքում, ցույց տվեք `error_code` և առաջարկեք Reload source; պահպանեք հաղորդագրությունը և երբեք չնշեք, որ այն լսված է սխալի հետո։

Միայն վերարտադրում։ Ձեր հավելվածը պահում է լսման առաջընթացը։

Վերսկսեք լեզվի դասը պահպանված դիրքում

Սովորողները պետք է կրկին լսեն դժվար հատվածը, այլ ոչ թե վերամեկնարկեն ամբողջ դասը։

`source_url = Current Lesson’s audio URL`; `title = Current Lesson’s name`; վերջին դիրքը պատկանում է այդ սովորողին և դասին ձեր տվյալների բազայում։

Ընթացիկ դասի համար `ready`-ի հետո, Seek պահպանված վայրկյանների վրա և սպասեք, որ օգտատերը Play։ Օգտագործեք Set speed դանդաղ լսման համար։ Պահեք առաջընթացը ձեր սեփական հավելվածի աշխատանքային հոսքով։

Կարդացեք `current_time` և `duration`։ `playback_ended`-ի դեպքում, ձեր հավելվածը կարող է գրանցել լսման կարևոր կետ ընթացիկ Lesson-ի համար։

Եթե աղբյուրը փոխվել է, հեռացրեք հին դիրքը, մինչև այդ դասը բեռնվի։ Մի համարեք լսման ավարտը ապացույց, որ սովորողը հասկացել է կամ անցել է թեստը։

Միայն վերարտադրում։ Ձեր հավելվածը պահում է լսման առաջընթացը։

Վերանայեք ձայնային կցվածքը ժամանականշաններով մեկնաբանություններով

Խմբագրերը կամ մարզիչները պետք է անցնեն մեկնաբանությունից համապատասխան պահին ձայնագրությունում։

`source_url = Selected Review’s recording URL`; յուրաքանչյուր հավելվածի Comment պահում է իր վայրկյանների արժեքը; ընտրովի `waveform_peaks_json` պարունակում է իրական գագաթներ նույն ձայնագրության համար։

Կտտացրեք Comment → Seek նրա վայրկյանների վրա → Play։ Աղբյուրի փոփոխության դեպքում, փոխարինեք կամ մաքրեք գագաթները և նորից կապեք ընտրված Review-ը։

Ցուցադրեք `current_time` ձեր մեկնաբանության կազմողի կողքին։ `waveform_available`-ը տեղեկացնում է ձեր UI-ին, թե արդյոք իրական տրամադրված գագաթները հասանելի են։

Ձեր հավելվածում հնացած ժամանականշանները սահմանափակեք ընթացիկ տևողության միջակայքով կամ մերժեք դրանք։ Եթե ալիքի ձևի իրական գագաթներ չկան, ցույց տվեք սովորական առաջընթացի կառավարումը՝ հորինված աուդիո վերլուծության փոխարեն։

Միայն վերարտադրում։ Ձեր հավելվածը պահում է լսման առաջընթացը։

Ինչ է աշխատում հիմա

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.

Ստեղծեք աշխատանքային հոսքը

Օգտագործեք ներքևում մատչելի բետա գործողությունները և փորձարկեք արդյունքը ձեր նպատակային սարքերում։

Այս օրինակները օգտագործում են հավելվածի գրառումներ, ինչպիսիք են Lesson, Message և Order։ Փոխարինեք դրանք ձեր տվյալների տեսակներով և տարրերի անուններով։ Օրինակների մեդիա հասցեները պետք է փոխարինվեն ձեր սեփական ֆայլերով։

Ավելացրեք ձայնային տարրը։ Կարգավորեք source_url = Selected Message's audio_url, title = Selected Message's sender_label և subtitle = Selected Message's date_label։
Եթե ունեք ալիքի ձևի իրական տվյալներ այս ձայնագրության համար, փոխանցեք դրանք waveform_peaks_json-ում։ Հակառակ դեպքում թողեք դատարկ։
Երբ տեղի է ունենում ready իրադարձությունը, օգտագործեք Seek՝ պահպանված վայրկյանների թվով, եթե անհրաժեշտ է։ Թույլ տվեք օգտատիրոջը սեղմել Play։ Օգտագործեք Pause, Seek և Set speed պլեյերի կոճակների համար։
Ցույց տվեք current_time և duration։ playback_ended-ում պահպանեք լսման առաջընթացը ընտրված հաղորդագրության կամ դասի համար։ Սահմանեք is_active-ը՝ ըստ այն բանի, թե այս տեսքը բաց է, թե ոչ։

Աշխատանքային հոսքի դիագրամ — ոչ հավելվածի սկրինշոտ

Կարգավորեք մեկ անգամ

Ստեղծեք կամ ընտրեք ձեր Bubble հավելվածի նախագիծը BestPlugins → Dashboard → Plugins-ում։ Ընտրեք Xodera Audio Player Native, պատճենեք նրա բանալին, ապա բացեք Bubble → Plugins → Xodera Audio Player Native և տեղադրեք այն licensing_api_key-ում։ Պահպանեք մեկ անգամ; ապա օգտագործեք ներքևում գտնվող գործողությունները։ Յուրաքանչյուր պլագին յուրաքանչյուր նախագծում ունի իր սեփական բանալին։

Օգտագործեք ուղղակի ձայնային ֆայլի հասցե, որը հավելվածը կարող է բացել։ Ձայնի նվագարկումը չի պահանջում միկրոֆոն կամ տեսախցիկի հասանելիություն։

Կարգավորեք մեկ անգամ

Ստեղծեք կամ ընտրեք ձեր Bubble հավելվածի նախագիծը BestPlugins → Dashboard → Plugins-ում։
Ընտրեք այս պլագինը և պատճենեք նրա նախագծի բանալին։
Open Bubble → Plugins → this plugin. Paste its project key into licensing_api_key and save.
Ավելացրեք տարրը, ընտրեք ձեր հավելվածի տվյալները և կառուցեք ներքևում գտնվող աշխատանքային հոսքը։
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.

Տեղադրում և բաժանորդագրություն

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.

Պահպանեք արդյունքը ձեր հավելվածում

Օրինակ ListeningProgress՝ owner = Current User, lesson = Selected Lesson, seconds = Audio Player's current_time, duration = Audio Player's duration։ Պահպանեք, երբ օգտատերը դադար է տալիս նվագարկմանը կամ թողնում է դասը, ոչ թե յուրաքանչյուր էկրանի թարմացման ժամանակ։

Ձախողում, չեղարկում և վերականգնում

player_error-ում ցույց տվեք error_code և առաջարկեք Reload source։ Պահպանեք հաղորդագրության կամ դասի գրառումը։ Երբ ընտրվում է այլ ձայնագրություն, բեռնեք նրա սեփական պահպանված դիրքը։ Դիտքին վերադարձնելը ավտոմատ կերպով չի սկսում նվագարկումը։

Հնարավորություններ և սահմանափակումներ

Նվագարկման արագություններ՝ 1, 1.5 և 2։ Ձայնի ուժը՝ 0–1։ Ալիքի ձևի տվյալներ՝ 2–2048 արժեք 0-ի և 1-ի միջև։ Աջակցվող ձայնային ձևաչափերը կախված են սարքից։ Պլեյերը չի ձայնագրում, չի տառագրում և չի պահում ձայնը մշտապես օֆլայն օգտագործման համար։ Ֆոնային և փակ‑էկրանի նվագարկումը երաշխավորված չէ։

Կարգավորումներ, գործողություններ և արդյունքներ

Օգտագործեք այս անունները Bubble-ում։ Պլանավորված հատկությունները նշված են առանձին.

Մատչելի բետա կարգավորումներ

Էլեմենտի կարգավորումներ

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

Կարգավիճակներ

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

Իրադարձություններ

readyplayback_startedplayback_pausedplayback_endedseek_completedrate_changedplayer_error

Գործողություններ և դրանց մուտքերը

PlayPauseToggleStopSeekSet speedSet volumeReload source

Էլեմենտի կարգավորումներ · 11

source_urltext · Դեֆոլտ: "": Օրինակային արժեքhttps://bestplugins.online/native-samples/lesson.mp3; Օրինակ Bubble արտահայտությունSelected Message's audio_url; Ընտրված աուդիո, վիդեո կամ պատկերի ֆայլի հասցեն։ Օգտագործեք ֆայլի տեսակ, որն աջակցում է այս պլագինը։

waveform_peaks_jsontext · Դեֆոլտ: "": Օրինակային արժեք[0.1,0.4,0.2,0.7]; Օրինակ Bubble արտահայտությունSelected Message's waveform_peaks_json; Այս ձայնագրության իրական նորմալացված ամպլիտուդի արժեքները․ թողեք դատարկ, եթե հասանելի չեն։

titletext · Դեֆոլտ: "": Օրինակային արժեքLesson 4 — review; Օրինակ Bubble արտահայտությունSelected Lesson's name; Հավելվածում տեսանելի տեքստ․ դատարկ թողնելու դեպքում օգտագործվում է ներկառուցված տեղայնացված տեքստը, եթե այն աջակցվում է։ Մի մուտքագրեք մուտքի գաղտնի տվյալներ։

subtitletext · Դեֆոլտ: "": Օրինակային արժեքTeacher · today; Օրինակ Bubble արտահայտությունSelected Message's sender_label; Հավելվածում տեսանելի տեքստ․ դատարկ թողնելու դեպքում օգտագործվում է ներկառուցված տեղայնացված տեքստը, եթե այն աջակցվում է։ Մի մուտքագրեք մուտքի գաղտնի տվյալներ։

playback_ratenumber · Դեֆոլտ: 1: Օրինակային արժեք1.5; Օրինակ Bubble արտահայտությունCurrent User's listening_speed; Օգտագործեք ընթացիկ բիզնես գրառման արժեքը՝ ստուգելով այն ներքևում նշված սահմանների նկատմամբ։

volumenumber · Դեֆոլտ: 1: Օրինակային արժեք0.8; Օրինակ Bubble արտահայտությունVolume Slider's value; Օգտագործեք ընթացիկ բիզնես գրառման արժեքը՝ ստուգելով այն ներքևում նշված սահմանների նկատմամբ։

loopyes_no · Դեֆոլտ: false: Օրինակային արժեքno; Օրինակ Bubble արտահայտությունSelected Lesson's repeat_enabled; Օգտագործեք ընթացիկ բիզնես գրառման արժեքը՝ ստուգելով այն ներքևում նշված սահմանների նկատմամբ։

is_activeyes_no · Դեֆոլտ: true: Օրինակային արժեքyes; Օրինակ Bubble արտահայտությունGuideHost's view_is_active (your yes/no custom state); Սահմանեք yes, քանի դեռ այս տեսքը բաց է։ Դուրս գալիս սահմանեք no, որպեսզի նվագարկումը կամ ընթացիկ աշխատանքը կարողանա դադարել։

disabledyes_no · Դեֆոլտ: false: Օրինակային արժեքno; Օրինակ Bubble արտահայտությունGuideHost's is_busy (your yes/no custom state); Անջատեք տարրը, երբ ձեր հավելվածը զբաղված է կամ այս գործողությունը անհասանելի է։

ui_text_jsontext · Դեֆոլտ: "": Օրինակային արժեք{}; Օրինակ Bubble արտահայտությունApp Settings' player_labels_json (supported keys only); Ընտրական JSON՝ աջակցված կոճակների պիտակներով։ Դատարկ թողեք՝ օգտագործելով ներառված տեքստը։

languagetext · Դեֆոլտ: "auto": Օրինակային արժեքuk; Օրինակ Bubble արտահայտությունCurrent User's preferred_language; Սահմանեք language=auto՝ հետևելու աջակցված սարքին կամ բրաուզերի լեզվին։ Մուտքագրեք աջակցված լեզվի կոդ՝ այն բացահայտ ընտրելու համար։

Գործողություններ և դրանց մուտքերը · 8

Play

Չկան գործողության պարամետրեր

Pause

Չկան գործողության պարամետրեր

Toggle

Չկան գործողության պարամետրեր

Stop

Չկան գործողության պարամետրեր

Seek

secondsnumber · Դեֆոլտ: —: Օրինակային արժեք12; Օրինակ Bubble արտահայտությունSelected Comment's seconds; Օգտագործեք ընթացիկ բիզնես գրառման արժեքը՝ ստուգելով այն ներքևում նշված սահմանների նկատմամբ։

Set speed

ratenumber · Դեֆոլտ: —: Օրինակային արժեք1.5; Օրինակ Bubble արտահայտությունSpeed Dropdown's value; Օգտագործեք ընթացիկ բիզնես գրառման արժեքը՝ ստուգելով այն ներքևում նշված սահմանների նկատմամբ։

Set volume

volumenumber · Դեֆոլտ: —: Օրինակային արժեք0.8; Օրինակ Bubble արտահայտությունVolume Slider's value; Օգտագործեք ընթացիկ բիզնես գրառման արժեքը՝ ստուգելով այն ներքևում նշված սահմանների նկատմամբ։

Reload source

Չկան գործողության պարամետրեր

Վիճակներ և իրադարձություններ

Կարգավիճակներ

player_status · text

Այս գործողության ընթացիկ արդյունքը։ Օգտագործեք համապատասխան ավարտման իրադարձությունը, նախքան հաջողության պահպանումը։

is_playing · yes_no