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 във вашето приложение, за да не може късно събитие да актуализира друг разговор.
При `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) - Задайте да, докато този изглед е отворен. Задайте не при изход, за да може възпроизвеждането или текущата работа да спрат.
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Когато това събитие се случи, прочетете свързаните състояния от същия елемент.
Въпроси, които задават разработчиците
Създава ли той вълновата форма?
Не. Предоставете реални нормализирани върхове за този източник; обикновеното възпроизвеждане работи без тях.
Как работи абонаментът?
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.
Свързани ръководства
За помощ, кажете ни кой плъгин и устройство използвате, действието, което опитахте, и какво се случи. Използвайте пример без лични данни. Никога не споделяйте вашия ключ или частни файлове.