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`; кожны каментар, які належыць дадатку, захоўвае сваю ўласную значэнне ў секундах; неабавязковы `waveform_peaks_json` змяшчае рэальныя пікі для таго ж запісу.
Націсніце каментар → Seek да яго секунд → Play. Пры змене крыніцы заменіце або ачысціце пікі і зноў прывяжыце выбраны агляд.
Пакажыце `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.
Звязаныя кіраўніцтва
Для дапамогі паведаміце, які плагін і прыладу вы выкарыстоўваеце, якую дзею спрабавалі і што адбылося. Выкарыстоўвайце прыклад без асабістых даных. Ніколі не дзяліцеся вашым ключом або прыватнымі файламі.