© copyright Blender Foundation | durian.blender.org · CC BY 3.0
Xodera Plugins · Bubble Native
Xodera Video 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 = Current Lesson’s video URL`; `poster_url = Current Lesson’s cover`; әр бөлім қолданбаға тиесілі басталу уақытын сақтайды.
Бөлімді басыңыз → дереккөз өзгерсе, `source_loaded` оқиғасын күтіңіз → Seek арқылы `position_seconds` орнына өтіңіз → Play. Егжей-тегжейлі демонстрация үшін Set playback rate, ал сұралғанда Enter fullscreen пайдаланыңыз.
`position_seconds`, `duration_seconds` және `is_fullscreen` оқыңыз; жұмыс ағыныңыз сабақ прогресін тек ағымдағы дереккөз үшін сақтайды.
`player_error` кезінде `error_code` көрсетіңіз, прогресті сақтап, Reload video ұсыныңыз. Аяқталу оқиғасы сабақ немесе қауіпсіздік бағалауы өткенін дәлелдемейді.
Тікелей видео файлдарын немесе қолдау көрсетілген ағындарды пайдаланыңыз. Бұл ойнатқыш видеоларды экспорттамайды.
Маркетплейс тізімдеріндегі видео демонстрациялар
Өнімнің суреті ғана оның қалай жұмыс істейтінін түсіндіре алмайды, бірақ сыртқы видео сатып алу процесін бұзады.
`source_url = Selected Listing’s demonstration URL`; `poster_url = its thumbnail`; `muted = yes` бірінші алдын ала қарауды саналы түрде үнсіз ету үшін.
Таңдалған листингті ашыңыз → оның видеосын байланыстырыңыз → пайдаланушы әрекеттен кейін Play. Дыбыс үшін Set muted, жақын қарау үшін Enter fullscreen ұсыныңыз. Көрінетін мәліметке `is_active` байланыстырыңыз.
Видео жоқ, жүктелуде және дайын медиа арасын ажырату үшін `has_source`, `is_buffering` және `status` пайдаланыңыз.
Дереккөзді ауыстырғанда, ескі прогресті және трек таңдауын қолдануды тоқтатыңыз. Таңдалған файл қолдау көрсетілмеген кезде шағын сурет нұсқасын көрсетіңіз.
Тікелей видео файлдарын немесе қолдау көрсетілген ағындарды пайдаланыңыз. Бұл ойнатқыш видеоларды экспорттамайды.
Қолдау көрсетілетін ағындағы қолжетімді тіл тректерін таңдаңыз.
Көптілді қолданба нақты дереккөзде бар тректерді ұсынуы керек.
`source_url = Selected Programme’s accepted stream URL`; дереккөз өзі үйлесімді аудио/субтитр тректерін қамтамасыз етуі керек.
`tracks_changed` кезінде ағымдағы `audio_tracks_json` және `subtitle_tracks_json` оқыңыз; қолданбада таңдауларды құрып, ағымдағы индексімен Select audio track немесе Select subtitle track шақырыңыз.
Таңдауды осы дереккөзбен байланыстыру үшін `selected_audio_index`, `selected_subtitle_index` және `source_generation` пайдаланыңыз.
Әрбір дереккөз өзгерісінен кейін таңдауларды қайта құрыңыз. Егер трек жоқ немесе қолдау көрсетілмесе, әдепкі тректі сақтап, оның қолжетімділігін адал түрде көрсетіңіз.
Тікелей видео файлдарын немесе қолдау көрсетілген ағындарды пайдаланыңыз. Бұл ойнатқыш видеоларды экспорттамайды.
Қазір жұмыс істейтіндер
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 Lesson's video_url және poster_url = Selected Lesson's poster_url орнатыңыз. MP4 үшін auto немесе progressive пайдаланыңыз; HLS ағыны үшін hls пайдаланыңыз.
playback_ready кейін, сақталған position_seconds-те жалғастыру үшін Seek пайдаланыңыз. Пайдаланушы Play бастайды. Сабақ көрінісі ашық па, жоқ па екенін анықтау үшін is_active орнатыңыз.
Play, Pause, Seek, Set playback rate және Enter fullscreen басқару элементтерін қосыңыз. position_seconds және duration_seconds көрсетіңіз.
tracks_changed кейін, бұл видео үшін қолжетімді audio_tracks_json және subtitle_tracks_json таңдауларын көрсетіңіз. Таңдалған индексті Select audio track немесе Select subtitle track-ке жіберіңіз. Аяқталған кезде прогресті сақтаңыз.
Бір рет баптаңыз
Bubble қолданба жобасын BestPlugins → Dashboard → Plugins ішінде жасаңыз немесе таңдаңыз. Xodera Video Player Native таңдаңыз, оның кілтін көшіріңіз, содан кейін Bubble → Plugins → Xodera Video Player Native ашып, оны licensing_api_key ішіне қойыңыз. Бір рет сақтаңыз; содан кейін төмендегі әрекеттерді пайдаланыңыз. Әр жобадағы әр плагиннің өз кілті бар.
Тікелей видео немесе ағын мекенжайын пайдаланыңыз. YouTube немесе Vimeo веб-бетінің мекенжайы тікелей видео файлы емес. Ойнату камера немесе микрофон рұқсатын талап етпейді.
Бір рет баптаңыз
- 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.
Нәтижені қолданбаңызда сақтаңыз
Мысал WatchProgress: owner = Current User, lesson = Selected Lesson, seconds = Video Player's position_seconds, duration = Video Player's duration_seconds. Тек ағымдағы таңдалған видео үшін сақтаңыз. Трек индекстері сол видеоға тиесілі және тұрақты тіл таңдаулары ретінде сақталмауы керек.
Қателік, болдырмау және қалпына келтіру
player_error кезінде error_code көрсетіліп, Reload video ұсынылады. Ойнауды бастамай-ақ қайта жүктеледі. Басқа дереккөзді таңдау ескі трек таңдауларын тазалайды. Көріністен шығу видеоны үзіліс қояды; пайдаланушы жалғастыру үшін Play басады.
Мүмкіндіктер және шектеулер
Жылдамдықтар: 0.5, 1, 1.5 және 2. Дыбыс деңгейі: 0–1. Пішімдер: auto, progressive, HLS және тек Android жүйесіндегі DASH. Қолжетімді тректер файлға байланысты. -1 тректі өшіру үшін қолданыңыз; -2 белгісіз және таңдалмайды. Түзету, бейне экспорт, DRM, суретте-сурет немесе тұрақты офлайн кэш жоқ.
Параметрлер, әрекеттер және нәтижелер
Бұл атауларды Bubble ішінде пайдаланыңыз. Жоспарланған мүмкіндіктер бөлек белгіленген.
Қолжетімді бета параметрлері
Элемент параметрлері
source_url · textposter_url · textcontent_type · textrate · numbervolume · numbermuted · yes/noloop · yes/nois_active · yes/nodisabled · yes/nonative_controls · yes/noui_text_json · textlanguage · textКүйлер
is_playing · yes/nois_buffering · yes/nopending_play · yes/nois_live · yes/nomuted · yes/noloop · yes/nohas_source · yes/nois_fullscreen · yes/noposition_seconds · numberduration_seconds · numbervolume · numberrate · numbersource_generation · numberselected_audio_index · numberselected_subtitle_index · numberstatus · textaudio_tracks_json · textsubtitle_tracks_json · texterror_code · texterror_message · textОқиғалар
source_changedsource_loadedplayback_readyplaying_changedtime_changedendedtracks_changedfullscreen_changedplayer_errorӘрекеттер және олардың енгізулері
PlayPauseStop and rewindReload videoSeekSet volumeSet mutedSet playback rateEnter fullscreenSelect audio trackSelect subtitle trackЭлемент параметрлері · 12
source_urltext · Әдепкі: ""- Мысал мәні
https://bestplugins.online/native-samples/lesson.mp4 - Мысал Bubble өрнегі
Selected Lesson's video_url - Таңдалған аудио, видео немесе сурет файлының мекенжайы. Бұл плагин қолдайтын файл түрін пайдаланыңыз.
poster_urltext · Әдепкі: ""- Мысал мәні
https://bestplugins.online/native-samples/poster.jpg - Мысал Bubble өрнегі
Selected Lesson's poster_url - Ағымдағы бизнес жазбасының мәнін пайдаланыңыз; оны төмендегі шектеулерге тексеріңіз.
content_typetext · Әдепкі: "auto"- Мысал мәні
auto - Мысал Bubble өрнегі
Selected Lesson's video_content_type - Ағымдағы бизнес жазбасының мәнін пайдаланыңыз; оны төмендегі шектеулерге тексеріңіз.
ratenumber · Әдепкі: 1- Мысал мәні
1.5 - Мысал Bubble өрнегі
Speed Dropdown's value - Ағымдағы бизнес жазбасының мәнін пайдаланыңыз; оны төмендегі шектеулерге тексеріңіз.
volumenumber · Әдепкі: 1- Мысал мәні
0.8 - Мысал Bubble өрнегі
Volume Slider's value - Ағымдағы бизнес жазбасының мәнін пайдаланыңыз; оны төмендегі шектеулерге тексеріңіз.
mutedyes/no · Әдепкі: false- Мысал мәні
no - Мысал Bubble өрнегі
Mute Checkbox is checked - Ағымдағы бизнес жазбасының мәнін пайдаланыңыз; оны төмендегі шектеулерге тексеріңіз.
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) - Қолданбаңыз бос емес немесе бұл әрекет қолжетімсіз болғанда элементті сөндіріңіз.
native_controlsyes/no · Әдепкі: false- Мысал мәні
no - Мысал Bubble өрнегі
App Settings' use_native_video_controls - Құрылғының стандартты видео басқару элементтерін көрсету немесе жасыру.
ui_text_jsontext · Әдепкі: "{}"- Мысал мәні
{} - Мысал Bubble өрнегі
App Settings' player_labels_json (supported keys only) - Қолдау көрсетілген батырма белгілері бар қосымша JSON. Кіріктірілген мәтінді пайдалану үшін бос қалдырыңыз.
languagetext · Әдепкі: "auto"- Мысал мәні
uk - Мысал Bubble өрнегі
Current User's preferred_language - language=auto-ны қолдау көрсетілген құрылғы немесе шолғыш тілін қадағалау үшін орнатыңыз. Нақты таңдау үшін қолдау көрсетілген тіл кодын енгізіңіз.
Әрекеттер және олардың енгізулері · 11
Play
Әрекет параметрлері жоқ
Pause
Әрекет параметрлері жоқ
Stop and rewind
Әрекет параметрлері жоқ
Reload video
Әрекет параметрлері жоқ
Seek
position_secondsnumber · Әдепкі: —- Мысал мәні
45 - Мысал Bubble өрнегі
Selected Chapter's start_seconds - Ағымдағы бизнес жазбасының мәнін пайдаланыңыз; оны төмендегі шектеулерге тексеріңіз.
Set volume
volumenumber · Әдепкі: —- Мысал мәні
0.8 - Мысал Bubble өрнегі
Volume Slider's value - Ағымдағы бизнес жазбасының мәнін пайдаланыңыз; оны төмендегі шектеулерге тексеріңіз.
Set muted
mutedyes/no · Әдепкі: —- Мысал мәні
no - Мысал Bubble өрнегі
Mute Checkbox is checked - Ағымдағы бизнес жазбасының мәнін пайдаланыңыз; оны төмендегі шектеулерге тексеріңіз.
Set playback rate
ratenumber · Әдепкі: —- Мысал мәні
1.5 - Мысал Bubble өрнегі
Speed Dropdown's value - Ағымдағы бизнес жазбасының мәнін пайдаланыңыз; оны төмендегі шектеулерге тексеріңіз.
Enter fullscreen
Әрекет параметрлері жоқ
Select audio track
indexnumber · Әдепкі: —- Мысал мәні
0 - Мысал Bubble өрнегі
Selected row's current_source_index - Ағымдағы бизнес жазбасының мәнін пайдаланыңыз; оны төмендегі шектеулерге тексеріңіз.
Select subtitle track
indexnumber · Әдепкі: —- Мысал мәні
0 - Мысал Bubble өрнегі
Selected row's current_source_index - Ағымдағы бизнес жазбасының мәнін пайдаланыңыз; оны төмендегі шектеулерге тексеріңіз.
Күйлер және оқиғалар
Күйлер
is_playing · yes/noТаңдалған элементтің ағымдағы мәні. Оны қатысты оқиғадан кейін оқыңыз.
is_buffering · yes/noТаңдалған элементтің ағымдағы мәні. Оны қатысты оқиғадан кейін оқыңыз.
pending_play · yes/noТаңдалған элементтің ағымдағы мәні. Оны қатысты оқиғадан кейін оқыңыз.
is_live · yes/noТаңдалған элементтің ағымдағы мәні. Оны қатысты оқиғадан кейін оқыңыз.
muted · yes/noТаңдалған элементтің ағымдағы мәні. Оны қатысты оқиғадан кейін оқыңыз.
loop · yes/noТаңдалған элементтің ағымдағы мәні. Оны қатысты оқиғадан кейін оқыңыз.
has_source · yes/noТаңдалған элементтің ағымдағы мәні. Оны қатысты оқиғадан кейін оқыңыз.
is_fullscreen · yes/noТаңдалған элементтің ағымдағы мәні. Оны қатысты оқиғадан кейін оқыңыз.
position_seconds · numberТаңдалған элементтің ағымдағы мәні. Оны қатысты оқиғадан кейін оқыңыз.
duration_seconds · numberТаңдалған элементтің ағымдағы мәні. Оны қатысты оқиғадан кейін оқыңыз.
volume · numberТаңдалған элементтің ағымдағы мәні. Оны қатысты оқиғадан кейін оқыңыз.
rate · numberТаңдалған элементтің ағымдағы мәні. Оны қатысты оқиғадан кейін оқыңыз.
source_generation · numberТаңдалған элементтің ағымдағы мәні. Оны қатысты оқиғадан кейін оқыңыз.
selected_audio_index · numberТаңдалған элементтің ағымдағы мәні. Оны қатысты оқиғадан кейін оқыңыз.
selected_subtitle_index · numberТаңдалған элементтің ағымдағы мәні. Оны қатысты оқиғадан кейін оқыңыз.
status · textОсы әрекеттің ағымдағы нәтижесі. Сақтау сәттілігіне дейін сәйкес аяқталу оқиғасын пайдаланыңыз. idle,loading,readyToPlay,error
audio_tracks_json · textТаңдалған элементтің ағымдағы мәні. Оны қатысты оқиғадан кейін оқыңыз.
subtitle_tracks_json · textТаңдалған элементтің ағымдағы мәні. Оны қатысты оқиғадан кейін оқыңыз.
error_code · textСоңғы әрекет үшін қате ақпараты. Көмекші хабарды көрсетіп, тиісті қайталау нұсқасын ұсыныңыз.
error_message · textСоңғы әрекет үшін қате ақпараты. Көмекші хабарды көрсетіп, тиісті қайталау нұсқасын ұсыныңыз.
Оқиғалар
source_changedБұл оқиға болғанда, сол элементтен қатысты күйдерді оқыңыз.
source_loadedБұл оқиға болғанда, сол элементтен қатысты күйдерді оқыңыз.
playback_readyБұл оқиға болғанда, сол элементтен қатысты күйдерді оқыңыз.
playing_changedБұл оқиға болғанда, сол элементтен қатысты күйдерді оқыңыз.
time_changedБұл оқиға болғанда, сол элементтен қатысты күйдерді оқыңыз.
endedБұл оқиға болғанда, сол элементтен қатысты күйдерді оқыңыз.
tracks_changedБұл оқиға болғанда, сол элементтен қатысты күйдерді оқыңыз.
fullscreen_changedБұл оқиға болғанда, сол элементтен қатысты күйдерді оқыңыз.
player_errorБұл оқиға болғанда, сол элементтен қатысты күйдерді оқыңыз.
Әзірлеушілердің сұрақтары
Таңдалған сегментті экспорттай аламын ба?
Жоқ. Seek және толық экран ойнатуды өзгертеді, бейне байттарын емес.
Жазылу қалай жұмыс істейді?
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.
Қатысты нұсқаулықтар
Көмек алу үшін, қандай плагин мен құрылғыны пайдаланатыныңызды, қандай әрекетті орындағаныңызды және не болғанын айтыңыз. Жеке деректерсіз мысал қолданыңыз. Кілтіңізді немесе жеке файлдарыңызды ешқашан бөліспеңіз.