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.

בנה את זרימת העבודה ↓הגדרות תוסף ↗Native Lab

תיעוד נבדק 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` מודיע לממשק המשתמש אם פסגות שסופקו בפועל זמינות.

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

השמעה בלבד. האפליקציה שלך שומרת את התקדמות ההאזנה.

מה עובד כעת

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 בהתאם אם תצוגה זו פתוחה.

תרשים זרימת עבודה — לא צילום מסך של אפליקציה

הגדר פעם אחת

צור או בחר את פרויקט האפליקציה 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; דוגמה לביטוי BubbleSelected Message's audio_url; כתובת של קובץ השמע, הווידאו או התמונה שנבחרו. השתמש בסוג קובץ שהפלאגין תומך בו.

waveform_peaks_jsontext · ברירת מחדל: "": ערך לדוגמה[0.1,0.4,0.2,0.7]; דוגמה לביטוי BubbleSelected Message's waveform_peaks_json; ערכי עוצמה מנורמלים אמיתיים עבור ההקלטה הזו; השאר ריק אם אינו זמין.

titletext · ברירת מחדל: "": ערך לדוגמהLesson 4 — review; דוגמה לביטוי BubbleSelected Lesson's name; טקסט שמוצג באפליקציה; כאשר השדה ריק, נעשה שימוש בטקסט המובנה המתורגם, היכן שנתמך. אין לכלול פרטי גישה.

subtitletext · ברירת מחדל: "": ערך לדוגמהTeacher · today; דוגמה לביטוי BubbleSelected Message's sender_label; טקסט שמוצג באפליקציה; כאשר השדה ריק, נעשה שימוש בטקסט המובנה המתורגם, היכן שנתמך. אין לכלול פרטי גישה.

playback_ratenumber · ברירת מחדל: 1: ערך לדוגמה1.5; דוגמה לביטוי BubbleCurrent User's listening_speed; השתמש בערך של רשומת העסק הנוכחית; אמת אותו מול המגבלות למטה.

volumenumber · ברירת מחדל: 1: ערך לדוגמה0.8; דוגמה לביטוי BubbleVolume Slider's value; השתמש בערך של רשומת העסק הנוכחית; אמת אותו מול המגבלות למטה.

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); השבת את הרכיב כאשר האפליקציה שלך עסוקה או שהפעולה אינה זמינה.

ui_text_jsontext · ברירת מחדל: "": ערך לדוגמה{}; דוגמה לביטוי BubbleApp Settings' player_labels_json (supported keys only); JSON אופציונלי עם תוויות כפתורים נתמכות. השאר ריק כדי להשתמש בטקסט המובנה.

languagetext · ברירת מחדל: "auto": ערך לדוגמהuk; דוגמה לביטוי BubbleCurrent User's preferred_language; הגדר language=auto כדי להשתמש בשפת המכשיר או הדפדפן, אם היא נתמכת. הזן קוד שפה נתמך כדי לבחור שפה במפורש.

פעולות והקלטים שלהן · 8

Play

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

Pause

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

Toggle

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

Stop

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

Seek

secondsnumber · ברירת מחדל: —: ערך לדוגמה12; דוגמה לביטוי BubbleSelected Comment's seconds; השתמש בערך של רשומת העסק הנוכחית; אמת אותו מול המגבלות למטה.

Set speed

ratenumber · ברירת מחדל: —: ערך לדוגמה1.5; דוגמה לביטוי BubbleSpeed Dropdown's value; השתמש בערך של רשומת העסק הנוכחית; אמת אותו מול המגבלות למטה.

Set volume

volumenumber · ברירת מחדל: —: ערך לדוגמה0.8; דוגמה לביטוי BubbleVolume Slider's value; השתמש בערך של רשומת העסק הנוכחית; אמת אותו מול המגבלות למטה.

Reload source

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

מצבים ואירועים