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 арқылы беріңіз. Болмаса, бос қалдырыңыз.
Дайын болғанда, қажет болса, сақталған секунд санымен Seek пайдаланыңыз. Пайдаланушыға Play басуға мүмкіндік беріңіз. Ойнатқыш батырмалары үшін Pause, Seek және Set speed пайдаланыңыз.
current_time және ұзақтығын көрсетіңіз. 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Таңдалған элементтің ағымдағы мәні. Оны қатысты оқиғадан кейін оқыңыз.
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.
Қатысты нұсқаулықтар
Көмек алу үшін, қандай плагин мен құрылғыны пайдаланатыныңызды, қандай әрекетті орындағаныңызды және не болғанын айтыңыз. Жеке деректерсіз мысал қолданыңыз. Кілтіңізді немесе жеке файлдарыңызды ешқашан бөліспеңіз.