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.
Документација прегледана 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` ви кажува дали се достапни реалните доставени врвови.
Ограничете ги застарените временски ознаки на тековната должина во вашата апликација или одбијте ги. Кога нема реални врвови, прикажете ја обичната контрола за напредок наместо измислена аудиоанализа.
Само репродукција. Вашата апликација ги зачувува напредоците на слушање.
Што работи сега
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) - Поставете да доколку овој поглед е отворен. Поставете не кога се напушта, за да се застане репродукцијата или тековната работа.
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Тековна вредност за избраниот елемент. Прочитајте ја по поврзаниот настан.
is_loaded · yes_noТековна вредност за избраниот елемент. Прочитајте ја по поврзаниот настан.
is_buffering · yes_noТековна вредност за избраниот елемент. Прочитајте ја по поврзаниот настан.
current_time · numberТековна вредност за избраниот елемент. Прочитајте ја по поврзаниот настан.
duration · numberТековна вредност за избраниот елемент. Прочитајте ја по поврзаниот настан.
progress · numberТековна вредност за избраниот елемент. Прочитајте ја по поврзаниот настан.
playback_rate · numberТековна вредност за избраниот елемент. Прочитајте ја по поврзаниот настан.
volume · numberТековна вредност за избраниот елемент. Прочитајте ја по поврзаниот настан.
is_looping · yes_noТековна вредност за избраниот елемент. Прочитајте ја по поврзаниот настан.
waveform_available · yes_noТековна вредност за избраниот елемент. Прочитајте ја по поврзаниот настан.
waveform_status · textТековен резултат на оваа акција. Користете соодветен настан за завршување пред да зачувате успех.
error_code · textИнформации за грешка за последната акција. Прикажете корисна порака и понудете соодветен повторен обид.
Настани
readyКога се случи овој настан, прочитајте ги поврзаните состојби од истиот елемент.
playback_startedКога се случи овој настан, прочитајте ги поврзаните состојби од истиот елемент.
playback_pausedКога се случи овој настан, прочитајте ги поврзаните состојби од истиот елемент.
playback_endedКога се случи овој настан, прочитајте ги поврзаните состојби од истиот елемент.
seek_completedКога се случи овој настан, прочитајте ги поврзаните состојби од истиот елемент.
rate_changedКога се случи овој настан, прочитајте ги поврзаните состојби од истиот елемент.
player_errorКога се случи овој настан, прочитајте ги поврзаните состојби од истиот елемент.
Прашања што ги поставуваат развивачите
Дали создава waveform?
Не. Обезбедете реални нормализирани врвови за тој извор; обичниот напредок работи без нив.
Како функционира претплатата?
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.
Поврзани упатства
За помош, кажете ни кој приклучок и уред користите, која акција ја испробавте и што се случи. Користете пример без лични податоци. Никогаш не споделувајте го вашиот клуч или приватни датотеки.