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`; һәр кушымтага караган Комментарий үз секунд кыйммәтен саклый; өстәмә `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 кыйммәте бу күренешнең ачык булу-булмавын күрсәтсен.
Бер тапкыр көйләгез
BestPlugins → Dashboard → Plugins эчендә үз Bubble кушымта проектын булдырыгыз яки сайлагыз. Xodera Audio Player Native сайлагыз, аның ачкычын күчерегез, аннары Bubble → Plugins → Xodera Audio Player Native ачыгыз һәм licensing_api_key эченә кертегез. Бер тапкыр саклагыз; аннары түбәндәге гамәлләрне кулланыгыз. Һәр проекттагы һәр плагинның үз ачкычы бар.
Кушымта ача ала торган туры аудио файл адресын кулланыгыз. Аудио уйнату микрофон яки камерага керүне таләп итми.
Бер тапкыр көйләгез
- BestPlugins → Dashboard → Plugins эчендә үз Bubble кушымта проектын булдырыгыз яки сайлагыз.
- Бу плагинны сайлагыз һәм аның проект ачкычын күчерегез.
- 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Сайланган элементның хәзерге кыйммәте. Тиешле вакыйгадан соң укыгыз.
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.
Бәйләнешле кулланмалар
Ярдәм өчен, кулланган плагин һәм җайланмагыз, тырышкан гамәлегез һәм нәтиҗәсен безгә хәбәр итегез. Шәхси мәгълүматсыз мисал кулланыгыз. Ачкычыгызны яки шәхси файлларыгызны беркайчан да уртаклашмагыз.