⚡XoderaPlugins
ממשק Offline Files.
ממשק Offline Files.
← כל מדריכי הנייטיב

Xodera Plugins · Bubble Native

Xodera Offline Files 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

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

הכין מספר קבצים מקומיים לפני שליחת הדוח

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

`accepted_mime_types_json = your allowed MIME list`; `multiple = yes`; הגדר `max_files`, `max_file_bytes` ו‑`document_context` של חשבון/דוח.

Pick files → בדוק את השמות/הגדלים שנבחרו → Save selection locally. הטופס שלך שומר את מזהי הקבצים המתקבלים עד שתהליך ההגשה הנפרד שלו מעלה קבצים מאושרים.

השתמש ב‑`selection_count`, `file_names`, `file_sizes` ו‑`saved_file_ids` כדי להציג את רשימת הקבצים לבדיקה. שמירת עותק מנוהל אינה משנה את הקובץ המקורי שסיפק הקוד הקורא.

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

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

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

קובץ מקומי שנוצר עשוי להימצא במיקום זמני; האפליקציה זקוקה לעותק מנוהל מפורש.

`source_uri = the local output of a separately accepted editor/recorder`; קשר את `display_name` ו‑`mime_type` האמיתיים שלו; השתמש ב‑`document_context` של אותו בעלים.

Load local source → בדוק מטא‑נתונים → Save selection locally. שמור את מזהה הקובץ שהוחזר רק במכשיר/הקשר המתאים, ואז השתמש ב‑Restore saved file לפי מזהה מדויק זה כאשר נדרש.

השתמש ב‑`file_id`, `local_uri`, `size_bytes` ו‑`is_saved_locally`; השתמש ב‑`file_restored` כדי להבדיל בין שחזור שהושלם לבקשה בלבד.

דחה כתובת URL מרוחקת של HTTP כמקור מקומי. אם מקור נעלם או שחזור נכשל, הצג `error_code` ושמר את רשומת האפליקציה המקורית לשחזור.

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

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

האפליקציה צריכה להעביר קובץ מקומי שנבחר לגיליון השיתוף של המכשיר במקום ליצור כתובת URL ציבורית.

`selected_file_id = the exact managed copy chosen from your app’s saved-file list`; שמו ו‑MIME מתארים את הקובץ המקומי האמיתי.

List saved files → Restore saved file → Share selected file לאחר שהמשתמש לוחץ על שיתוף. שמור את העותק השמור עד שהם בוחרים במפורש ב‑Delete saved copy.

השתמש ב‑`share_status` ו‑`share_sheet_closed` כדי לעדכן את הממשק לאחר סגירת הגיליון. שמור את מזהה הקובץ לשיתוף מודע נוסף.

סגירת תפריט השיתוף אינה הוכחה שהדוא״ל או ההודעה נמסרו. טפל בביטול וב‑`files_error` בלי לדווח שהקובץ נמסר בהצלחה לנמען.

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

מה עובד כעת

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. הגדר document_context = Current User's unique id, או ערך יציב עבור החשבון והדוח. בחר accepted_mime_types_json, max_files ו‑max_file_bytes.

  2. הפעל Pick files, או השתמש ב‑Load local source עבור קובץ קריא שנוצר על ידי עורך תמונות או מקליט. לאחר selection_changed, קרא את רשימות הקבצים המתאימות; Select picked file בוחר אינדקס.

  3. הפעל Save selection locally. לאחר files_saved, שמור saved_file_ids ברשומת הקבצים המקומית של האפליקציה שלך. List saved files מציג עותקים שמורים; Restore saved file פותח את המזהה השמור שנבחר.

  4. Share selected file פותח את תפריט השיתוף של המערכת. share_sheet_closed משמעותו רק שהתפריט נסגר. Delete saved copy דורש את המזהה שנבחר ו‑confirm=yes.

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

הגדר פעם אחת

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

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

הגדר פעם אחת
  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.

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

דוגמה LocalAttachment: בעלים, document_context, מזהה קובץ שמור, display_name, mime_type ו‑size_bytes. מזהה זה פועל רק באותו מכשיר ובאותו חשבון או דוח. עבור קובץ מצורף אונליין, העלה את הקובץ בתהליך נפרד ושמור את הפנייה המקוונת שהוחזרה.

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

בוחר שבוטל מחזיר operation_cancelled; הוא אינו מגיש את הטופס. בזמן native_pending=yes, המתן עד שבוחר הקבצים או תפריט השיתוף ייסגר לפני פתיחת חלון נוסף. Clear session מנקה את הבחירה הנוכחית אך משאיר עותקים שמורים. אם קובץ חסר, אפשר למשתמש לבחור אותו שוב.

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

בחר קבצים 1–20 בבת אחת. מגבלת קובץ: 1 בתים–256 MiB, עם מגבלה נמוכה יותר אם תבחר. מסנני סוגי קבצים אינם בודקים קבצים לוירוסים. מזהי קבצים ונתיבי מכשיר אינם פועלים כקישורי הורדה מהענן. עותקים מקומיים אינם אחסון מוצפן ויכולים ללכת לאיבוד אם נתוני האפליקציה מוסרים.

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

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

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

הגדרות אלמנט

source_uri · textdisplay_name · textmime_type · textdocument_context · textselected_file_id · textaccepted_mime_types_json · textmultiple · yes_nocopy_to_cache · yes_nomax_files · numbermax_file_bytes · numberis_active · yes_nodisabled · yes_noshow_controls · yes_nolanguage · textui_text_json · texttitle · text

מצבים

status · textis_busy · yes_nonative_pending · yes_nooperation · textselection_count · numberselected_index · numberfile_id · textlocal_uri · textdisplay_name · textmime_type · textmime_source · textsize_bytes · numberis_saved_locally · yes_nofile_ids · text (רשימה)file_uris · text (רשימה)file_names · text (רשימה)file_mime_types · text (רשימה)file_sizes · number (רשימה)files_json · textsaved_count · numbersaved_file_ids · text (רשימה)saved_file_uris · text (רשימה)saved_file_names · text (רשימה)saved_file_mime_types · text (רשימה)saved_file_sizes · number (רשימה)saved_files_json · textinvalid_saved_count · numbershare_status · texterror_code · text

אירועים

selection_changedfiles_savedlist_loadedfile_restoredfile_deletedshare_sheet_closedoperation_cancelledfiles_error

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

Pick filesLoad local sourceSelect picked fileSave selection locallyList saved filesRestore saved fileDelete saved copyShare selected fileCancel operationClear session
הגדרות אלמנט · 16
source_uritext · ברירת מחדל: ""
ערך לדוגמהfile:///app-cache/report.pdf
דוגמה לביטוי BubblePhoto Editor's output_uri
מיקום קובץ קריא במכשיר זה, שמוחזר על ידי הבוחר שלך או תוסף אחר.
display_nametext · ברירת מחדל: ""
ערך לדוגמהreport-photo.jpg
דוגמה לביטוי BubbleSelected Attachment's display_name
השתמש בערך של רשומת העסק הנוכחית; אמת אותו מול המגבלות למטה.
mime_typetext · ברירת מחדל: ""
ערך לדוגמהimage/jpeg
דוגמה לביטוי BubblePhoto Editor's output_mime
השתמש בערך של רשומת העסק הנוכחית; אמת אותו מול המגבלות למטה.
document_contexttext · ברירת מחדל: "default"
ערך לדוגמה<current-user-id>
דוגמה לביטוי BubbleCurrent User's unique id
ערך יציב עבור חשבון או רשומה זו. השתמש באותו ערך בעת שחזור הקבצים או הטיוטות השמורים.
selected_file_idtext · ברירת מחדל: ""
ערך לדוגמה<returned saved file ID>
דוגמה לביטוי BubbleSelected LocalAttachment's local_file_id
השתמש בערך של רשומת העסק הנוכחית; אמת אותו מול המגבלות למטה.
accepted_mime_types_jsontext · ברירת מחדל: "[\"*/*\"]"
ערך לדוגמה["image/*","application/pdf"]
דוגמה לביטוי BubbleReport Settings' accepted_mime_types_json
השתמש בערך של רשומת העסק הנוכחית; אמת אותו מול המגבלות למטה.
multipleyes_no · ברירת מחדל: false
ערך לדוגמהyes
דוגמה לביטוי BubbleReport Settings' allow_multiple_attachments
השתמש בערך של רשומת העסק הנוכחית; אמת אותו מול המגבלות למטה.
copy_to_cacheyes_no · ברירת מחדל: true
ערך לדוגמהyes
דוגמה לביטוי BubbleReport Settings' copy_to_cache
השתמש בערך של רשומת העסק הנוכחית; אמת אותו מול המגבלות למטה.
max_filesnumber · ברירת מחדל: 20
ערך לדוגמה5
דוגמה לביטוי BubbleReport Settings' attachment_limit
השתמש בערך של רשומת העסק הנוכחית; אמת אותו מול המגבלות למטה.
max_file_bytesnumber · ברירת מחדל: 268435456
ערך לדוגמה10485760
דוגמה לביטוי BubbleReport Settings' max_attachment_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)
השבת את הרכיב כאשר האפליקציה שלך עסוקה או שהפעולה אינה זמינה.
show_controlsyes_no · ברירת מחדל: true
ערך לדוגמהyes
דוגמה לביטוי BubbleApp Settings' show_editor_controls
הצג או הסתר את הפקדים המובנים.
languagetext · ברירת מחדל: "auto"
ערך לדוגמהuk
דוגמה לביטוי BubbleCurrent User's preferred_language
הגדר language=auto כדי להשתמש בשפת המכשיר או הדפדפן, אם היא נתמכת. הזן קוד שפה נתמך כדי לבחור שפה במפורש.
ui_text_jsontext · ברירת מחדל: ""
ערך לדוגמה{}
דוגמה לביטוי BubbleApp Settings' player_labels_json (supported keys only)
JSON אופציונלי עם תוויות כפתורים נתמכות. השאר ריק כדי להשתמש בטקסט המובנה.
titletext · ברירת מחדל: ""
ערך לדוגמהLesson 4 — review
דוגמה לביטוי BubbleSelected Lesson's name
טקסט שמוצג באפליקציה; כאשר השדה ריק, נעשה שימוש בטקסט המובנה המתורגם, היכן שנתמך. אין לכלול פרטי גישה.
פעולות והקלטים שלהן · 10
Pick files

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

Load local source
source_uritext · ברירת מחדל: —
ערך לדוגמהfile:///app-cache/report.pdf
דוגמה לביטוי BubblePhoto Editor's output_uri
מיקום קובץ קריא במכשיר זה, שמוחזר על ידי הבוחר שלך או תוסף אחר.
display_nametext · ברירת מחדל: —
ערך לדוגמהreport-photo.jpg
דוגמה לביטוי BubbleSelected Attachment's display_name
השתמש בערך של רשומת העסק הנוכחית; אמת אותו מול המגבלות למטה.
mime_typetext · ברירת מחדל: —
ערך לדוגמהimage/jpeg
דוגמה לביטוי BubblePhoto Editor's output_mime
השתמש בערך של רשומת העסק הנוכחית; אמת אותו מול המגבלות למטה.
Select picked file
indexnumber · ברירת מחדל: —
ערך לדוגמה0
דוגמה לביטוי BubbleSelected row's current_source_index
השתמש בערך של רשומת העסק הנוכחית; אמת אותו מול המגבלות למטה.
Save selection locally

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

List saved files

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

Restore saved file
file_idtext · ברירת מחדל: —
ערך לדוגמה<returned saved file ID>
דוגמה לביטוי BubbleSelected LocalAttachment's local_file_id
השתמש בערך של רשומת העסק הנוכחית; אמת אותו מול המגבלות למטה.
Delete saved copy
file_idtext · ברירת מחדל: —
ערך לדוגמה<returned saved file ID>
דוגמה לביטוי BubbleSelected LocalAttachment's local_file_id
השתמש בערך של רשומת העסק הנוכחית; אמת אותו מול המגבלות למטה.
confirmyes_no · ברירת מחדל: —
ערך לדוגמהyes — explicit confirmation only
דוגמה לביטוי BubbleConfirm Checkbox is checked
השתמש בערך של רשומת העסק הנוכחית; אמת אותו מול המגבלות למטה.
Share selected file
dialog_titletext · ברירת מחדל: —
ערך לדוגמהShare attachment
דוגמה לביטוי BubbleSelected Report's share_title
השתמש בערך של רשומת העסק הנוכחית; אמת אותו מול המגבלות למטה.
utitext · ברירת מחדל: —
ערך לדוגמה""
דוגמה לביטוי BubbleEmpty unless your iOS integration supplies a proven UTI
השתמש בערך של רשומת העסק הנוכחית; אמת אותו מול המגבלות למטה.
Cancel operation

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

Clear session

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

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

מצבים

status · text

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

is_busy · yes_no

העבודה עדיין בתהליך. המתן לפני תחילת פעולה נוספת.

native_pending · yes_no

העבודה עדיין בתהליך. המתן לפני תחילת פעולה נוספת.

operation · text

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

selection_count · number

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

selected_index · number

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

file_id · text

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

local_uri · text

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

display_name · text

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

mime_type · text

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

mime_source · text

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

size_bytes · number

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

is_saved_locally · yes_no

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

file_ids · text (רשימה)

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

file_uris · text (רשימה)

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

file_names · text (רשימה)

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

file_mime_types · text (רשימה)

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

file_sizes · number (רשימה)

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

files_json · text

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

saved_count · number

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

saved_file_ids · text (רשימה)

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

saved_file_uris · text (רשימה)

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

saved_file_names · text (רשימה)

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

saved_file_mime_types · text (רשימה)

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

saved_file_sizes · number (רשימה)

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

saved_files_json · text

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

invalid_saved_count · number

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

share_status · text

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

error_code · text

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

אירועים

selection_changed

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

files_saved

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

list_loaded

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

file_restored

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

file_deleted

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

share_sheet_closed

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

operation_cancelled

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

files_error

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

שאלות שמפתחים שואלים

האם שיתוף משמעותו “נשלח”?

לא. מערכת ההפעלה אינה מספקת קבלה אמינה של הצלחת הקבלה כאן. הצג “תפריט השיתוף נסגר”.

איך המנוי פועל?

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.

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

audio-playervideo-playerphoto-editoraudio-recorderqr-passesdocuments-aib2-files
רשימת Bubble Marketplace מאומתתנושא פורום מאומת

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