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.
تمت مراجعة الوثائق 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 - مثال Bubble تعبير
Selected Profile's image_url - عنوان ملف الصوت أو الفيديو أو الصورة المحدد. استخدم نوع ملف يدعمه هذا الملحق.
document_contexttext · الافتراضي: ""- قيمة مثال
<current-user-id> - مثال Bubble تعبير
Current User's unique id - قيمة ثابتة لهذا الحساب أو السجل. استخدم نفس القيمة عند استعادة ملفاته أو مسوداته المحفوظة.
is_activeyes_no · الافتراضي: true- قيمة مثال
yes - مثال Bubble تعبير
GuideHost's view_is_active (your yes/no custom state) - عيّن نعم بينما هذه الواجهة مفتوحة. عيّن لا عند الخروج، حتى يمكن إيقاف التشغيل أو العمل الحالي.
disabledyes_no · الافتراضي: false- قيمة مثال
no - مثال Bubble تعبير
GuideHost's is_busy (your yes/no custom state) - عطّل العنصر بينما يكون تطبيقك مشغولًا أو يكون هذا الإجراء غير متاح.
show_controlsyes_no · الافتراضي: true- قيمة مثال
yes - مثال Bubble تعبير
App Settings' show_editor_controls - إظهار أو إخفاء عناصر التحكم المدمجة.
crop_aspecttext · الافتراضي: "free"- قيمة مثال
1:1 - مثال Bubble تعبير
Avatar Settings' crop_ratio - استخدم قيمة سجل الأعمال الحالي؛ تحقق منها مقابل الحدود أدناه.
export_formattext · الافتراضي: "jpeg"- قيمة مثال
jpeg - مثال Bubble تعبير
Format Dropdown's value - استخدم قيمة سجل الأعمال الحالي؛ تحقق منها مقابل الحدود أدناه.
export_qualitynumber · الافتراضي: 0.85- قيمة مثال
0.85 - مثال Bubble تعبير
Image Settings' quality - استخدم قيمة سجل الأعمال الحالي؛ تحقق منها مقابل الحدود أدناه.
export_max_dimensionnumber · الافتراضي: 2048- قيمة مثال
2048 - مثال Bubble تعبير
Image Settings' max_side - استخدم قيمة سجل الأعمال الحالي؛ تحقق منها مقابل الحدود أدناه.
allow_upscaleyes_no · الافتراضي: false- قيمة مثال
no - مثال Bubble تعبير
Allow upscale Checkbox is checked - استخدم قيمة سجل الأعمال الحالي؛ تحقق منها مقابل الحدود أدناه.
ui_text_jsontext · الافتراضي: ""- قيمة مثال
{} - مثال Bubble تعبير
App Settings' player_labels_json (supported keys only) - JSON اختياري مع تسميات الأزرار المدعومة. اتركه فارغًا لاستخدام النص المدمج.
languagetext · الافتراضي: "auto"- قيمة مثال
uk - مثال Bubble تعبير
Current User's preferred_language - اضبط language=auto لتتبع جهاز أو لغة المتصفح المدعومة. أدخل رمز لغة مدعوم لاختيارها صراحة.
الإجراءات ومدخلاتها · 13
Load source
لا توجد معلمات إجراء
Begin crop
لا توجد معلمات إجراء
Apply crop
origin_xnumber · الافتراضي: —- قيمة مثال
0 - مثال Bubble تعبير
Crop Settings' x (or omit all rectangle inputs) - استخدم قيمة سجل الأعمال الحالي؛ تحقق منها مقابل الحدود أدناه.
origin_ynumber · الافتراضي: —- قيمة مثال
0 - مثال Bubble تعبير
Crop Settings' y (or omit all rectangle inputs) - استخدم قيمة سجل الأعمال الحالي؛ تحقق منها مقابل الحدود أدناه.
widthnumber · الافتراضي: —- قيمة مثال
512 - مثال Bubble تعبير
Resize Width Input's value:converted to number - استخدم قيمة سجل الأعمال الحالي؛ تحقق منها مقابل الحدود أدناه.
heightnumber · الافتراضي: —- قيمة مثال
512 - مثال Bubble تعبير
Resize Height Input's value:converted to number - استخدم قيمة سجل الأعمال الحالي؛ تحقق منها مقابل الحدود أدناه.
Cancel crop
لا توجد معلمات إجراء
Rotate
degreesnumber · الافتراضي: —- قيمة مثال
90 - مثال Bubble تعبير
Rotation Dropdown's value - استخدم قيمة سجل الأعمال الحالي؛ تحقق منها مقابل الحدود أدناه.
Flip
axistext · الافتراضي: —- قيمة مثال
horizontal - مثال Bubble تعبير
Flip Direction Dropdown's value - استخدم قيمة سجل الأعمال الحالي؛ تحقق منها مقابل الحدود أدناه.
Resize
widthnumber · الافتراضي: —- قيمة مثال
512 - مثال Bubble تعبير
Resize Width Input's value:converted to number - استخدم قيمة سجل الأعمال الحالي؛ تحقق منها مقابل الحدود أدناه.
heightnumber · الافتراضي: —- قيمة مثال
512 - مثال Bubble تعبير
Resize 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القيمة الحالية للعنصر المحدد. اقرأها بعد الحدث المتعلق.
has_changes · yes_noالقيمة الحالية للعنصر المحدد. اقرأها بعد الحدث المتعلق.
can_undo · yes_noالقيمة الحالية للعنصر المحدد. اقرأها بعد الحدث المتعلق.
can_redo · yes_noالقيمة الحالية للعنصر المحدد. اقرأها بعد الحدث المتعلق.
image_width · numberالقيمة الحالية للعنصر المحدد. اقرأها بعد الحدث المتعلق.
image_height · numberالقيمة الحالية للعنصر المحدد. اقرأها بعد الحدث المتعلق.
output_uri · textموقع الملف على هذا الجهاز. احفظ أو ارفع الملف بشكل منفصل إذا كان يجب الاحتفاظ به على الإنترنت.
output_width · numberالقيمة الحالية للعنصر المحدد. اقرأها بعد الحدث المتعلق.
output_height · numberالقيمة الحالية للعنصر المحدد. اقرأها بعد الحدث المتعلق.
output_bytes · numberالقيمة الحالية للعنصر المحدد. اقرأها بعد الحدث المتعلق.
output_mime · textالقيمة الحالية للعنصر المحدد. اقرأها بعد الحدث المتعلق.
error_code · textمعلومات الخطأ للإجراء الأخير. اعرض رسالة مفيدة وقدّم إعادة المحاولة ذات الصلة.
crop_active · yes_noالقيمة الحالية للعنصر المحدد. اقرأها بعد الحدث المتعلق.
crop_rect_json · textالقيمة الحالية للعنصر المحدد. اقرأها بعد الحدث المتعلق.
الأحداث
source_loadedعند حدوث هذا الحدث، اقرأ الحالات المرتبطة من نفس العنصر.
source_load_failedعند حدوث هذا الحدث، اقرأ الحالات المرتبطة من نفس العنصر.
edit_appliedعند حدوث هذا الحدث، اقرأ الحالات المرتبطة من نفس العنصر.
edit_undoneعند حدوث هذا الحدث، اقرأ الحالات المرتبطة من نفس العنصر.
edit_redoneعند حدوث هذا الحدث، اقرأ الحالات المرتبطة من نفس العنصر.
editor_resetعند حدوث هذا الحدث، اقرأ الحالات المرتبطة من نفس العنصر.
export_startedعند حدوث هذا الحدث، اقرأ الحالات المرتبطة من نفس العنصر.
export_completedعند حدوث هذا الحدث، اقرأ الحالات المرتبطة من نفس العنصر.
operation_cancelledعند حدوث هذا الحدث، اقرأ الحالات المرتبطة من نفس العنصر.
editor_errorعند حدوث هذا الحدث، اقرأ الحالات المرتبطة من نفس العنصر.
الأسئلة التي يطرحها المطورون
هل output_uri ملف Bubble؟
لا. إنه مسار ذاكرة تخزين مؤقت محلية. احفظه عبر أداة حفظ أو رفع محلية موثوقة قبل تخزين مرجع ملف سحابي.
كيف يعمل الاشتراك؟
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.
الأدلة ذات الصلة
للحصول على المساعدة، أخبرنا بأي إضافة وجهاز تستخدمهما، الإجراء الذي جربته وما حدث. استخدم مثالًا بدون بيانات شخصية. لا تشارك مفتاحك أو ملفاتك الخاصة أبدًا.