ממשק Video Player עם פריים לדוגמה מהטריילר של Sintel.
ממשק Video Player עם פריים לדוגמה מהטריילר של Sintel.
© 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. החליפו אותן בסוגי הנתונים ובשמות האלמנטים שלכם. כתובות מדיה לדוגמה חייבות להיות מוחלפות בקבצים שלכם.

  1. הגדר את source_url = Selected Lesson's video_url ו‑poster_url = Selected Lesson's poster_url. השתמש ב‑auto או progressive עבור MP4; השתמש ב‑hls עבור זרם HLS.

  2. לאחר playback_ready, השתמש ב‑Seek כדי להמשיך במיקום השמור position_seconds. המשתמש מתחיל Play. הגדר את is_active בהתאם אם תצוגת השיעור פתוחה.

  3. הוסף את פקדי Play, Pause, Seek, Set playback rate ו‑Enter fullscreen. הצג את position_seconds ו‑duration_seconds.

  4. לאחר 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 אינן קובץ וידאו ישיר. הנגינה אינה דורשת גישה למצלמה או למיקרופון.

הגדר פעם אחת
  1. צור או בחר את פרויקט האפליקציה Bubble שלך ב‑BestPlugins → Dashboard → Plugins.
  2. בחר בתוסף זה והעתק את מפתח הפרויקט שלו.
  3. Open Bubble → Plugins → this plugin. Paste its project key into licensing_api_key and save.
  4. הוסף את הרכיב, בחר את נתוני האפליקציה שלך ובנה את זרימת העבודה למטה.
  5. 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‑only 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
דוגמה לביטוי BubbleSelected Lesson's video_url
כתובת של קובץ השמע, הווידאו או התמונה שנבחרו. השתמש בסוג קובץ שהפלאגין תומך בו.
poster_urltext · ברירת מחדל: ""
ערך לדוגמהhttps://bestplugins.online/native-samples/poster.jpg
דוגמה לביטוי BubbleSelected Lesson's poster_url
השתמש בערך של רשומת העסק הנוכחית; אמת אותו מול המגבלות למטה.
content_typetext · ברירת מחדל: "auto"
ערך לדוגמהauto
דוגמה לביטוי BubbleSelected Lesson's video_content_type
השתמש בערך של רשומת העסק הנוכחית; אמת אותו מול המגבלות למטה.
ratenumber · ברירת מחדל: 1
ערך לדוגמה1.5
דוגמה לביטוי BubbleSpeed Dropdown's value
השתמש בערך של רשומת העסק הנוכחית; אמת אותו מול המגבלות למטה.
volumenumber · ברירת מחדל: 1
ערך לדוגמה0.8
דוגמה לביטוי BubbleVolume Slider's value
השתמש בערך של רשומת העסק הנוכחית; אמת אותו מול המגבלות למטה.
mutedyes/no · ברירת מחדל: false
ערך לדוגמהno
דוגמה לביטוי BubbleMute Checkbox is checked
השתמש בערך של רשומת העסק הנוכחית; אמת אותו מול המגבלות למטה.
loopyes/no · ברירת מחדל: false
ערך לדוגמהno
דוגמה לביטוי BubbleSelected Lesson's repeat_enabled
השתמש בערך של רשומת העסק הנוכחית; אמת אותו מול המגבלות למטה.
is_activeyes/no · ברירת מחדל: true
ערך לדוגמהyes
דוגמה לביטוי BubbleGuideHost's view_is_active (your yes/no custom state)
הגדר yes כל עוד התצוגה פתוחה. בעת היציאה הגדר no, כדי לאפשר את עצירת ההשמעה או העבודה הנוכחית.
disabledyes/no · ברירת מחדל: false
ערך לדוגמהno
דוגמה לביטוי BubbleGuideHost's is_busy (your yes/no custom state)
השבת את הרכיב כאשר האפליקציה שלך עסוקה או שהפעולה אינה זמינה.
native_controlsyes/no · ברירת מחדל: false
ערך לדוגמהno
דוגמה לביטוי BubbleApp Settings' use_native_video_controls
הצג או הסתר את בקרות הווידאו הסטנדרטיות של המכשיר.
ui_text_jsontext · ברירת מחדל: "{}"
ערך לדוגמה{}
דוגמה לביטוי BubbleApp Settings' player_labels_json (supported keys only)
JSON אופציונלי עם תוויות כפתורים נתמכות. השאר ריק כדי להשתמש בטקסט המובנה.
languagetext · ברירת מחדל: "auto"
ערך לדוגמהuk
דוגמה לביטוי BubbleCurrent User's preferred_language
הגדר language=auto כדי להשתמש בשפת המכשיר או הדפדפן, אם היא נתמכת. הזן קוד שפה נתמך כדי לבחור שפה במפורש.
פעולות והקלטים שלהן · 11
Play

אין פרמטרי פעולה

Pause

אין פרמטרי פעולה

Stop and rewind

אין פרמטרי פעולה

Reload video

אין פרמטרי פעולה

Seek
position_secondsnumber · ברירת מחדל: —
ערך לדוגמה45
דוגמה לביטוי BubbleSelected Chapter's start_seconds
השתמש בערך של רשומת העסק הנוכחית; אמת אותו מול המגבלות למטה.
Set volume
volumenumber · ברירת מחדל: —
ערך לדוגמה0.8
דוגמה לביטוי BubbleVolume Slider's value
השתמש בערך של רשומת העסק הנוכחית; אמת אותו מול המגבלות למטה.
Set muted
mutedyes/no · ברירת מחדל: —
ערך לדוגמהno
דוגמה לביטוי BubbleMute Checkbox is checked
השתמש בערך של רשומת העסק הנוכחית; אמת אותו מול המגבלות למטה.
Set playback rate
ratenumber · ברירת מחדל: —
ערך לדוגמה1.5
דוגמה לביטוי BubbleSpeed Dropdown's value
השתמש בערך של רשומת העסק הנוכחית; אמת אותו מול המגבלות למטה.
Enter fullscreen

אין פרמטרי פעולה

Select audio track
indexnumber · ברירת מחדל: —
ערך לדוגמה0
דוגמה לביטוי BubbleSelected row's current_source_index
השתמש בערך של רשומת העסק הנוכחית; אמת אותו מול המגבלות למטה.
Select subtitle track
indexnumber · ברירת מחדל: —
ערך לדוגמה0
דוגמה לביטוי BubbleSelected 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.

מדריכים קשורים

לעזרה, ספר לנו איזה תוסף והתקן אתה משתמש, את הפעולה שניסית ומה קרה. השתמש בדוגמה ללא נתונים אישיים. לעולם אל תשתף את המפתח או קבצים פרטיים שלך.