© 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`; თითოეული Chapter ჩანაწერი ინახავს აპის მიერ მართულ დაწყების დროს.
Chapter-ზე დაწკაპება → თუ წყარო იცვლება, დაელოდეთ `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` პირველ წინასწარი ნახვისთვის, რომელიც მიზანით სიჩუმეა.
გახსენით არჩეული Listing → დაუკავშირეთ მისი ვიდეო → მომხმარებლის მოქმედების შემდეგ გაუშვით 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. გამოიყენეთ auto ან progressive MP4-სთვის; გამოიყენეთ hls HLS ნაკადისთვის.
playback_ready-ის შემდეგ, გამოიყენეთ Seek, რათა გაგრძელოთ შენახული position_seconds-ზე. მომხმარებელი იწყებს 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-ს. ended მოვლენისას შეინახეთ პროგრესი.
კონფიგურაცია ერთხელ
შექმენით ან აირჩიეთ თქვენი 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, picture-in-picture ან მუდმივი ოფლაინ ქეში არ არის.
პარამეტრები, მოქმედებები და შედეგები
გამოიყენეთ ეს სახელები 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.
დაკავშირებული გზამკვლევები
დახმარებისთვის, გვაცნობეთ, რომელი პლაგინი და მოწყობილობა იყენებთ, რა მოქმედება სცადეთ და რა მოხდა. გამოიყენეთ მაგალითი პირად მონაცემებს გარეშე. არასოდეს გაუზიაროთ თქვენი გასაღები ან კერძო ფაილები.