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

Xodera Plugins · Bubble Native

Xodera Photo Editor 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 profile image`; `crop_aspect = "1:1"`; `document_context = the account’s stable reference`.

המתן ל‑`source_loaded`; Begin crop → Apply crop, עם Rotate או Undo לפי הצורך. בעת שמירה מפורשת, Export image.

רק ב‑`export_completed`, השתמש ב‑`output_uri`, `output_width`, `output_height` ו‑`output_mime` כקלטים לזרימת העבודה של העלאת הקובץ שלך. שמור את ההפנייה העמידה שלו לפרופיל לאחר מכן.

אם המשתמש מבטל או ש‑`editor_error` מתרחש, שמור את תמונת הפרופיל הישנה. נקה את ההפעלה בעת שינוי חשבון כדי שמשתמש אחר לא יוכל לראות את הטיוטה.

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

הכן תמונות שוק או קטלוג עקביות

מסגור שונה ותמונות גדולות מדי גורמים לקטלוג להיות לא אחיד ומגדילים את גודל ההעלאה.

`source_url = selected item photo`; `crop_aspect = the app’s chosen ratio`; `export_max_dimension`, `export_format` ו‑`export_quality` מגיעים ממדיניות ההעלאה שלך.

חתוך את האזור הרלוונטי, באופן אופציונלי Resize, ואז Export image לאחר שהמשתמש מאשר. שמור את הקובץ/הפנייה המקוריים בנפרד.

בדוק את `output_width`, `output_height`, `output_bytes` ו‑`output_mime` לפני שזרימת העבודה של ההעלאה שלך שומרת את התוצאה. אחסן את הפנייה לתמונת התוצאה בפריט.

אם הייצוא נכשל או שהתוצאה מפרה את מדיניות ההעלאה שלך, הצג את `error_code` ותן למשתמש לתקן אותה. אל תדרוס את תמונת הפריט הקודמת לפני אישור ההעלאה.

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

צור עותק תמונה ממוקד לדוח שטח

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

`source_url = Current Report Photo’s source`; `document_context = the report/account reference`; יחס החיתוך יכול להישאר בלתי מוגבל.

Begin crop → Apply crop, ואז השתמש ב‑Undo/Redo כדי להשוות עריכות. Export image יוצר את העותק הערוך; האפליקציה שלך שואלת האם לצרף את העותק לדוח.

השתמש ב‑`has_changes`, `can_undo`, `can_redo` ו‑`output_uri`. אחסן הפניות מקוריות וערוכות בשדות אפליקציה נפרדים לאחר העלאה מוצלחת.

Cancel crop או Reset edits משחזרים את נתיב העריכה; ביטול חייב להשאיר את קובץ הדוח המקורי ללא שינוי.

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

מה עובד כעת

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 לתמונה שנבחרה. השתמש ב‑document_context כדי לזהות את החשבון והרשומה שנערכים, כך ששינוי הרשומה מוחק את התמונה הקודמת.
לאחר source_loaded, הפעל Begin crop. בחר 1:1 לתמונת פרופיל, התאם את החיתוך והשתמש ב‑Apply crop. Cancel crop משאיר את התמונה ללא שינוי.
השתמש ב‑Rotate, Flip או Resize לפי הצורך. Undo ו‑Redo עוברים בין עריכות שהושלמו; Reset edits משחזר את התמונה המקורית.
הפעל Export image. ב‑export_completed, קרא output_uri, output_width, output_height ו‑output_mime. שמור או העלה את העותק באמצעות זרימת העבודה לשמירת קבצים שבחרת, ואז אחסן את הקובץ השמור ברשומה.

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

הגדר פעם אחת

הפעלת המפתח מתוכננת לתוסף זה. צור או בחר את פרויקט האפליקציה Bubble שלך ב‑BestPlugins → Dashboard → Plugins. בחר ב‑Xodera Photo Editor Native, העתק את המפתח שלו, ואז פתח Bubble → Plugins → Xodera Photo Editor 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.

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

שמור את התמונה שהועלתה או שנשמרה לצמיתות ב‑Profile.image או בשדה הקבצים המצורפים שלך. output_uri הוא קובץ זמני במכשיר, ולכן תחילה שמור קובץ זה באמצעות תהליך העבודה שבחרת. לאחר מכן אחסן את output_width, output_height ו‑output_mime כמטא‑נתונים. שמור את התמונה המקורית אם אתה צריך את שתי הגרסאות.

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

ב‑source_load_failed או ב‑editor_error, הצג את error_code והצע את Load source. Cancel operation מפסיק לקבל את התוצאה הלא מושלמת; המתן עד is_busy=no לפני שמתחילים עריכה נוספת. Clear session מנקה את העורך, ולא תמונה שכבר נשמרה במקום אחר.

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

ייצוא ב‑JPEG ו‑PNG; איכות 0–1; אורך צלע פלט מרבי 1–4096 פיקסלים. קלט: עד 15 MiB ו‑20 מגהפיקסלים. עד 20 עריכות שהושלמו. אפשרויות חיתוך: חופשי, 1:1, 4:3, 3:4 ו‑16:9. אין מצלמה מובנית, מסננים, שכבות טקסט, תיקון פרספקטיבה, ייצוא WebP או העלאה אוטומטית.

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

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

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

הגדרות אלמנט

source_url · textdocument_context · textis_active · yes_nodisabled · yes_noshow_controls · yes_nocrop_aspect · textexport_format · textexport_quality · numberexport_max_dimension · numberallow_upscale · yes_noui_text_json · textlanguage · text

מצבים

editor_status · textis_busy · yes_nohas_image · yes_nohas_changes · yes_nocan_undo · yes_nocan_redo · yes_noimage_width · numberimage_height · numberoutput_uri · textoutput_width · numberoutput_height · numberoutput_bytes · numberoutput_mime · texterror_code · textcrop_active · yes_nocrop_rect_json · text

אירועים

source_loadedsource_load_failededit_appliededit_undoneedit_redoneeditor_resetexport_startedexport_completedoperation_cancellededitor_error

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

Load sourceBegin cropApply cropCancel cropRotateFlipResizeUndoRedoReset editsExport imageCancel operationClear session

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

source_urltext · ברירת מחדל: "": ערך לדוגמהhttps://bestplugins.online/native-samples/avatar.jpg; דוגמה לביטוי BubbleSelected Profile's image_url; כתובת של קובץ השמע, הווידאו או התמונה שנבחרו. השתמש בסוג קובץ שהפלאגין תומך בו.

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

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; הצג או הסתר את הפקדים המובנים.

crop_aspecttext · ברירת מחדל: "free": ערך לדוגמה1:1; דוגמה לביטוי BubbleAvatar Settings' crop_ratio; השתמש בערך של רשומת העסק הנוכחית; אמת אותו מול המגבלות למטה.

export_formattext · ברירת מחדל: "jpeg": ערך לדוגמהjpeg; דוגמה לביטוי BubbleFormat Dropdown's value; השתמש בערך של רשומת העסק הנוכחית; אמת אותו מול המגבלות למטה.

export_qualitynumber · ברירת מחדל: 0.85: ערך לדוגמה0.85; דוגמה לביטוי BubbleImage Settings' quality; השתמש בערך של רשומת העסק הנוכחית; אמת אותו מול המגבלות למטה.

export_max_dimensionnumber · ברירת מחדל: 2048: ערך לדוגמה2048; דוגמה לביטוי BubbleImage Settings' max_side; השתמש בערך של רשומת העסק הנוכחית; אמת אותו מול המגבלות למטה.

allow_upscaleyes_no · ברירת מחדל: false: ערך לדוגמהno; דוגמה לביטוי BubbleAllow upscale Checkbox is checked; השתמש בערך של רשומת העסק הנוכחית; אמת אותו מול המגבלות למטה.

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

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

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

Load source

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

Begin crop

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

Apply crop

origin_xnumber · ברירת מחדל: —: ערך לדוגמה0; דוגמה לביטוי BubbleCrop Settings' x (or omit all rectangle inputs); השתמש בערך של רשומת העסק הנוכחית; אמת אותו מול המגבלות למטה.

origin_ynumber · ברירת מחדל: —: ערך לדוגמה0; דוגמה לביטוי BubbleCrop Settings' y (or omit all rectangle inputs); השתמש בערך של רשומת העסק הנוכחית; אמת אותו מול המגבלות למטה.

widthnumber · ברירת מחדל: —: ערך לדוגמה512; דוגמה לביטוי BubbleResize Width Input's value:converted to number; השתמש בערך של רשומת העסק הנוכחית; אמת אותו מול המגבלות למטה.

heightnumber · ברירת מחדל: —: ערך לדוגמה512; דוגמה לביטוי BubbleResize Height Input's value:converted to number; השתמש בערך של רשומת העסק הנוכחית; אמת אותו מול המגבלות למטה.

Cancel crop

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

Rotate

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

Flip

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

Resize

widthnumber · ברירת מחדל: —: ערך לדוגמה512; דוגמה לביטוי BubbleResize Width Input's value:converted to number; השתמש בערך של רשומת העסק הנוכחית; אמת אותו מול המגבלות למטה.

heightnumber · ברירת מחדל: —: ערך לדוגמה512; דוגמה לביטוי BubbleResize Height Input's value:converted to number; השתמש בערך של רשומת העסק הנוכחית; אמת אותו מול המגבלות למטה.

Undo

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

Redo

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

Reset edits

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

Export image

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

Cancel operation

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

Clear session

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

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

מצבים

editor_status · text

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

is_busy · yes_no

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

has_image · yes_no