Xodera Plugins · Bubble Native

Xodera Audio Recorder 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

דוגמאות מעשיות

האזן לפני שליחת הודעת קול שאינה סודית

המשתמשים צריכים הזדמנות לשמוע ולהחליף הקלטה לפני שהיא הופכת לקובץ מצורף.

`title = the app’s conversation label`; הגדר את `max_duration_seconds` ו‑`max_upload_bytes` למדיניות ההודעות שלך.

Start recording → Stop recording → המתן ל‑`recording_ready` → Play preview. הצע את Seek preview ו‑Set preview speed. רק שליחה מפורשת מפעילה את Upload to Bubble בנקודת הקצה המאושרת להעלאה של האפליקציה שלך.

רק ב‑`upload_succeeded`, צור את Message והגדר את שדה האודיו שלו ל‑`uploaded_file`. ההודעה אינה נוצרת על ידי המקליט עצמו.

במקרה של דחיית מיקרופון הצג את `permission_status`; במקרה של כשל העלאה שמור את ההקלטה המקומית. בדוק את תוצאת ההעלאה הלא ידועה לפני ניסיון חוזר כדי שהשליחה לא תיצור קבצים מצורפים/הודעות כפולות.

העלאה של Bubble יוצרת קובץ אודיו ציבורי. אל תשתמש בהעלאה זו עבור הקלטות סודיות.

תרגול הגייה ללא העלאה מיידית

הלומדים רוצים להשוות את תגובתם המדוברת עם השיעור לפני שהם מחליטים לשלוח אותה.

`title = Current Exercise’s prompt`; `max_duration_seconds = the exercise limit`; תשובת תרגיל נשארת רשומה שבבעלות האפליקציה.

הקלט → עצור → Play preview. אפשר ללומד לשנות את מיקום ההשמעה, להאט את התצוגה המקדימה או לבטל ולהקליט ניסיון נוסף. Save locally רק כאשר הם בוחרים לשמור את הטיוטה.

`duration`, `local_uri`, `mime_type` ו‑`draft_id` מתארים את הניסיון. האפליקציה שלך מחליטה האם הוא נשאר מקומי או יוגש מאוחר יותר דרך זרימת העבודה של ההעלאה שבחרת.

ב‑`preview_error`, שמור את הטיוטה והצג את `error_code`. אל תהפוך תצוגה מקדימה או טיוטה שמורה לתשובה מוגשת עד שזרימת העבודה של ההגשה באפליקציה תצליח.

העלאה של Bubble יוצרת קובץ אודיו ציבורי. אל תשתמש בהעלאה זו עבור הקלטות סודיות.

שמור טיוטת קול מקומית והפוך את שליחה למפורשת

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

`saved_draft_id = the draft ID stored by your app for this device and account`; `title = the selected non-sensitive task label`.

Start recording → Stop recording → Save locally. שמור את `draft_id` שהוחזר במצב של האפליקציה המוגבל למכשיר ולחשבון המתאימים. השתמש ב‑Restore local draft עבור אותו מזהה, ואז ב‑Play preview לפני החלטה על העלאה.

ב‑`local_saved` או `local_restored`, בדוק את `is_saved_locally`, `local_uri` ו‑`duration`. מחק את הטיוטה השמורה רק לאחר בחירת משתמש מפורשת או לאחר מדיניות שמירה מאושרת בנפרד.

אם השחזור נכשל, הצג את `error_code` ושמור את המזהה לאבחון; אל תדווח על הקלטה ריקה או שונה כשוחזרה. לעולם אל תבצע העלאת auto בעת חיבור מחדש.

העלאה של Bubble יוצרת קובץ אודיו ציבורי. אל תשתמש בהעלאה זו עבור הקלטות סודיות.

מה עובד כעת

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

הוסף את המקליט. הגדר document_context = Current User's unique id, ואת is_active הגדר לפי השאלה אם תצוגת ההקלטה פתוחה.
Start recording מבקש הרשאת מיקרופון. Pause ו‑Resume משמרים את אותה הקלטה. Stop recording מסיים אותה; המתן ל‑recording_ready לפני הצעת סקירה או העלאה.
השתמש בבקרי התצוגה המקדימה כדי להאזין. Save locally שומר טיוטה במכשיר זה; לאחר local_saved, שמור את draft_id עבור Restore local draft.
הסבר שהשליחה יוצרת קובץ ציבורי. הגדר את bubble_upload_url לכתובת העלאת הקבצים הנכונה של האפליקציה שלך Bubble – Development או Live. הפעל את Upload to Bubble רק כאשר המשתמש בוחר לשלוח; ב‑upload_succeeded, שמור את uploaded_file ברשומה שלך.

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

הגדר פעם אחת

צור או בחר את פרויקט האפליקציה Bubble שלך ב‑BestPlugins → Dashboard → Plugins. בחר ב‑Xodera Audio Recorder Native, העתק את המפתח שלו, ואז פתח את Bubble → Plugins → Xodera Audio Recorder Native והדבק אותו ב‑licensing_api_key. שמור פעם אחת; לאחר מכן השתמש בפעולות למטה. לכל תוסף בכל פרויקט יש מפתח משלו.

בקש הרשאת מיקרופון כאשר המשתמש מתחיל להקליט. בחר כיצד האפליקציה תשמור טיוטות. העלאת Bubble מאחסנת קובץ ציבורי, ולכן השתמש בה רק עבור אודיו המתאים לאחסון ציבורי.

הגדר פעם אחת

צור או בחר את פרויקט האפליקציה 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.

שמור את התוצאה באפליקציה שלך

לאחר upload_succeeded, הגדר את VoiceMessage.audio = Recorder's uploaded_file, owner = Current User, duration = Recorder's duration ו‑mime_type = Recorder's mime_type. draft_id משחזר טיוטה במכשיר זה; היא אינה קובץ אודיו מקוון.

כשל, ביטול ושחזור

אם הגישה למיקרופון נדחית, הסבר כיצד להפעילה בהגדרות המכשיר. Cancel recording מוחק את ההקלטה הלא שמורה; טיוטות שמורות נשארות. אם העלאה מופרעת, שמור את ההקלטה המקומית ובדוק האם הקובץ הגיע לפני שליחה חוזרת. Delete saved draft מסיר רק את הטיוטה השמורה שנבחרה.

יכולות ומגבלות

הקלטה מרבית ברירת מחדל: 300 שניות; ניתן להגדיר 1–3600. מגבלת העלאה ברירת מחדל: 10 MiB; מרבית 30 MiB. זמן קצוב להעלאה: 60 שניות, ללא ניסיון חוזר אוטומטי. העלאות Bubble הן ציבוריות. נתמכות רק כתובות העלאת קבצים *.bubbleapps.io שלך; תחומים מותאמים אינם נתמכים. טיוטות מקומיות אינן אחסון מוצפן.

הגדרות, פעולות ותוצאות

השתמשו בשמות אלה ב‑Bubble. תכונות מתוכננות מסומנות בנפרד.

הגדרות בטא זמינות

הגדרות אלמנט

title · textmax_duration_seconds · numbermax_upload_bytes · numberis_active · yes_nodisabled · yes_noui_text_json · textsaved_draft_id · textbubble_upload_url · textlanguage · textdocument_context · text

מצבים

recorder_status · textpermission_status · textis_recording · yes_nois_paused · yes_noduration · numberlocal_uri · textdraft_id · textis_saved_locally · yes_nomime_type · textfile_size · numberwaveform_peaks_json · textpreview_status · textpreview_is_playing · yes_nopreview_current_time · numberupload_status · textupload_progress · numberuploaded_url · textuploaded_file · fileerror_code · text

אירועים

recording_startedrecording_pausedrecording_resumedrecording_stoppedrecording_readyrecording_cancelledrecorder_errorlocal_savedlocal_restoredlocal_deletedupload_succeededupload_failedupload_cancelledpreview_readypreview_error

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

Start recordingPause recordingResume recordingStop recordingCancel recordingSave locallyRestore local draftDelete saved draftUpload to BubbleCancel uploadPlay previewPause previewStop previewSeek previewSet preview speed

הגדרות אלמנט · 10

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

max_duration_secondsnumber · ברירת מחדל: 300: ערך לדוגמה300; דוגמה לביטוי BubbleVoice Settings' max_seconds; השתמש בערך של רשומת העסק הנוכחית; אמת אותו מול המגבלות למטה.

max_upload_bytesnumber · ברירת מחדל: 10485760: ערך לדוגמה10485760; דוגמה לביטוי BubbleVoice Settings' max_upload_bytes; השתמש בערך של רשומת העסק הנוכחית; אמת אותו מול המגבלות למטה.

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

saved_draft_idtext · ברירת מחדל: "": ערך לדוגמה<returned draft_id>; דוגמה לביטוי BubbleSelected VoiceDraft's draft_id; השתמש בערך של רשומת העסק הנוכחית; אמת אותו מול המגבלות למטה.

bubble_upload_urltext · ברירת מחדל: "": ערך לדוגמהhttps://your-app.bubbleapps.io/version-test/fileupload; דוגמה לביטוי BubbleApp Settings' selected_bubble_upload_url; כתובת העלאת הקבצים של האפליקציה שלך Bubble: /version-test/fileupload עבור Development, /fileupload עבור Live. העלאה זו יוצרת קבצים ציבוריים.

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

document_contexttext · ברירת מחדל: "": ערך לדוגמה<current-user-id>; דוגמה לביטוי BubbleCurrent User's unique id; ערך יציב עבור חשבון או רשומה זו. השתמש באותו ערך בעת שחזור הקבצים או הטיוטות השמורים.

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

Start recording

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

Pause recording

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

Resume recording

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

Stop recording

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

Cancel recording

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

Save locally

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

Restore local draft

draft_idtext · ברירת מחדל: —: ערך לדוגמה<returned draft_id>; דוגמה לביטוי BubbleSelected VoiceDraft's draft_id; השתמש בערך של רשומת העסק הנוכחית; אמת אותו מול המגבלות למטה.

Delete saved draft

draft_idtext · ברירת מחדל: —: ערך לדוגמה<returned draft_id>; דוגמה לביטוי BubbleSelected VoiceDraft's draft_id; השתמש בערך של רשומת העסק הנוכחית; אמת אותו מול המגבלות למטה.

Upload to Bubble

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

Cancel upload

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

Play preview

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

Pause preview

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

Stop preview

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

Seek preview

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

Set preview speed

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

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

מצבים

recorder_status · text

התוצאה הנוכחית של פעולה זו. השתמש באירוע השלמה המתאים לפני שמירת ההצלחה.

permission_status · text

התוצאה הנוכחית של פעולה זו. השתמש באירוע השלמה המתאים לפני שמירת ההצלחה.

is_recording · yes_no

הערך הנוכחי של הפריט שנבחר. קרא אותו לאחר האירוע הקשור.

is_paused · yes_no

הערך הנוכחי של הפריט שנבחר. קרא אותו לאחר האירוע הקשור.

duration · number

הערך הנוכחי של הפריט שנבחר. קרא אותו לאחר האירוע הקשור.

local_uri · text

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

draft_id · text

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

is_saved_locally · yes_no

הערך הנוכחי של הפריט שנבחר. קרא אותו לאחר האירוע הקשור.

mime_type · text

הערך הנוכחי של הפריט שנבחר. קרא אותו לאחר האירוע הקשור.

file_size · number

הערך הנוכחי של הפריט שנבחר. קרא אותו לאחר האירוע הקשור.

waveform_peaks_json · text

הערך הנוכחי של הפריט שנבחר. קרא אותו לאחר האירוע הקשור.

preview_status · text

התוצאה הנוכחית של פעולה זו. השתמש באירוע השלמה המתאים לפני שמירת ההצלחה.

preview_is_playing · yes_no

הערך הנוכחי של הפריט שנבחר. קרא אותו לאחר האירוע הקשור.

preview_current_time · number

הערך הנוכחי של הפריט שנבחר. קרא אותו לאחר האירוע הקשור.

upload_status · text

התוצאה הנוכחית של פעולה זו. השתמש באירוע השלמה המתאים לפני שמירת ההצלחה.

upload_progress · number

הערך הנוכחי של הפריט שנבחר. קרא אותו לאחר האירוע הקשור.

uploaded_url · text

הערך הנוכחי של הפריט שנבחר. קרא אותו לאחר האירוע הקשור.

uploaded_file · file

הקובץ הוחזר לאחר upload_succeeded. שמור אותו בשדה הקובץ Bubble שלך.

error_code · text

מידע שגיאה עבור הפעולה האחרונה. הצג הודעה מועילה והצע ניסיון חוזר רלוונטי.