Xodera Plugins · Bubble Native
Xodera Photo Editor Native
Seçilen fotoğrafı tutarlı bir avatar, ürün görseli veya rapor eki haline getirin. Kırpın, döndürün ve yeniden boyutlandırın, ardından dışa aktarılan kopyayı uygulamanızda kaydedin.
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 belgeleri November 2026 incelendi.
Pratik örnekler
Yüklemeden önce tutarlı profil avatarları
Kullanıcılar, rastgele bir kırpma kabul etmek yerine fotoğraflarının hangi kısmının kare profil görüntüsünde görüneceğini seçmelidir.
`source_url = selected profile image`; `crop_aspect = "1:1"`; `document_context = the account’s stable reference`.
`source_loaded` bekleyin; Begin crop → Apply crop, gerektiğinde Rotate veya Undo ile. Açıkça Kaydet üzerine Export image.
Yalnızca `export_completed` sırasında, `output_uri`, `output_width`, `output_height` ve `output_mime`'yi dosya yükleme iş akışınızın girdileri olarak kullanın. Ardından kalıcı referansını Profile kaydedin.
Kullanıcı iptal ederse veya `editor_error` tetiklenirse, eski avatarı koruyun. Hesap değiştiğinde oturumu temizleyin, böylece başka bir kullanıcı taslağı göremez.
Düzenleme yerel bir kopya oluşturur. Uygulamanız, nasıl kaydedileceğini veya yükleneceğini seçer.
Tutarlı pazar yeri veya katalog fotoğrafları hazırlayın
Farklı çerçeveler ve aşırı büyük görseller katalogu dengesiz hâle getirir ve yükleme boyutunu artırır.
`source_url = selected item photo`; `crop_aspect = the app’s chosen ratio`; `export_max_dimension`, `export_format` ve `export_quality` yükleme politikanızdan gelir.
İlgili alanı kırpın, isteğe bağlı olarak Resize, ardından kullanıcı onayladıktan sonra Export image. Orijinal dosyayı/referansı ayrı tutun.
Yükleme iş akışınız sonucu kaydetmeden önce `output_width`, `output_height`, `output_bytes` ve `output_mime` kontrol edin. Oluşan görüntü referansını Öğeye kaydedin.
Dışa aktarma başarısız olursa veya sonuç yükleme politikanızı ihlal ederse, `error_code` gösterin ve kullanıcının revize etmesine izin verin. Yükleme onayı alınmadan önce önceki Öğe görüntüsünün üzerine yazmayın.
Düzenleme yerel bir kopya oluşturur. Uygulamanız, nasıl kaydedileceğini veya yükleneceğini seçer.
Bir saha raporu için odaklanmış görüntü kopyası oluşturun
Teknisyen, orijinal rapor görüntüsünü korurken hasarlı bir parçanın yakın çekimine ihtiyaç duyabilir.
`source_url = Current Report Photo’s source`; `document_context = the report/account reference`; kırpma oranı sınırlı olmadan kalabilir.
Begin crop → Apply crop, ardından düzenlemeleri karşılaştırmak için Undo/Redo kullanın. Export image düzenlenmiş kopyayı oluşturur; uygulamanız bu kopyayı Rapor'a ekleyip eklemeyeceğinizi sorar.
`has_changes`, `can_undo`, `can_redo` ve `output_uri` kullanın. Başarılı bir yüklemeden sonra orijinal ve düzenlenmiş referansları ayrı uygulama alanlarında saklayın.
Cancel crop veya Reset edits düzenleme yolunu geri yükler; iptal, orijinal Rapor ekini değiştirmeden bırakmalıdır.
Düzenleme yerel bir kopya oluşturur. Uygulamanız, nasıl kaydedileceğini veya yükleneceğini seçer.
Şu anda çalışanlar
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.
İş akışını oluşturun
Aşağıdaki mevcut beta eylemlerini kullanın ve sonucu hedef cihazlarınızda test edin.
Bu örnekler Lesson, Message ve Order gibi uygulama kayıtlarını kullanır. Bunları kendi veri tipleriniz ve öğe adlarınızla değiştirin. Örnek medya adresleri kendi dosyalarınızla değiştirilmelidir.
source_url'yi seçilen görüntüye ayarlayın. document_context'yi düzenlenen hesap ve kaydı tanımlamak için kullanın, böylece kaydı değiştirmek önceki fotoğrafı temizler.
source_loaded'den sonra Begin crop'yi çalıştırın. Avatar için 1:1'yi seçin, kırpmayı ayarlayın ve Apply crop'yi kullanın. Cancel crop görüntüyü değiştirmez.
Gerekirse Rotate, Flip veya Resize'yi kullanın. Undo ve Redo tamamlanmış düzenlemeler arasında ilerler; Reset edits orijinal görüntüyü geri yükler.
Export image çalıştırın. export_completed üzerinde output_uri, output_width ve output_height ile output_mime okuyun. Seçtiğiniz dosya kaydetme iş akışını kullanarak bu kopyayı kaydedin veya yükleyin, ardından kaydedilen dosyayı kayıtta saklayın.
Bir kez yapılandırın
Bu eklenti için anahtar etkinleştirme planlanmıştır. Bubble uygulama projenizi BestPlugins → Dashboard → Plugins içinde oluşturun veya seçin. Xodera Photo Editor Native'yi seçin, anahtarını kopyalayın, ardından Bubble → Plugins → Xodera Photo Editor Native'yi açın ve licensing_api_key'ye yapıştırın. Bir kez kaydedin; ardından aşağıdaki eylemleri kullanın. Her proje içindeki her eklentinin kendi anahtarı vardır.
Önce uygulamanızla görüntüyü seçin veya yakalayın. Düzenleyiciye elde edilen okunabilir görüntü adresini verin. Kamera ve fotoğraf kitaplığı izinleri kullandığınız seçiciye aittir.
Bir kez yapılandırın
- Bubble uygulama projenizi BestPlugins → Dashboard → Plugins içinde oluşturun veya seçin.
- Bu eklentiyi seçin ve proje anahtarını kopyalayın.
- Open Bubble → Plugins → this plugin. Paste its project key into licensing_api_key and save.
- Öğeyi ekleyin, uygulama verilerinizi seçin ve aşağıdaki iş akışını oluşturun.
- 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.
Kurulum ve abonelik
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.
Sonucu uygulamanıza kaydedin
Yüklenen veya kalıcı olarak kaydedilen görüntüyü Profile.image'ye veya ek alanınıza kaydedin. output_uri cihazdaki geçici bir dosyadır, bu yüzden önce seçtiğiniz iş akışıyla bu dosyayı kaydedin. Ardından output_width, output_height ve output_mime'yi meta veri olarak saklayın. Her iki sürüme de ihtiyacınız varsa orijinal görüntüyü koruyun.
Başarısızlık, iptal ve kurtarma
source_load_failed veya editor_error üzerinde error_code'yi gösterin ve Load source'yi sunun. Cancel operation, tamamlanmamış sonucu kabul etmeyi durdurur; başka bir düzenlemeye başlamadan önce is_busy=no'ye kadar bekleyin. Clear session, editörü temizler, başka bir yerde zaten kaydedilmiş bir görüntüyü etkilemez.
Yetenekler ve sınırlamalar
JPEG ve PNG dışa aktarımı; kalite 0–1; maksimum çıktı kenarı 1–4096 piksel. Giriş: en fazla 15 MiB ve 20 megapiksel. En fazla 20 tamamlanmış düzenleme. Kırpma seçenekleri: serbest, 1:1, 4:3, 3:4 ve 16:9. Yerleşik kamera, filtreler, metin bindirmeleri, perspektif düzeltme, WebP dışa aktarımı veya otomatik yükleme yok.
Ayarlar, eylemler ve sonuçlar
Bu adları Bubble içinde kullanın. Planlanan özellikler ayrı olarak işaretlenmiştir.
Kullanılabilir beta ayarları
Öğe ayarları
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 · textDurumlar
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 · textOlaylar
source_loadedsource_load_failededit_appliededit_undoneedit_redoneeditor_resetexport_startedexport_completedoperation_cancellededitor_errorEylemler ve girdileri
Load sourceBegin cropApply cropCancel cropRotateFlipResizeUndoRedoReset editsExport imageCancel operationClear sessionÖğe ayarları · 12
source_urltext · Varsayılan: ""- Örnek değer
https://bestplugins.online/native-samples/avatar.jpg - Örnek Bubble ifadesi
Selected Profile's image_url - Seçilen ses, video veya görüntü dosyasının adresi. Bu eklentinin desteklediği bir dosya türü kullanın.
document_contexttext · Varsayılan: ""- Örnek değer
<current-user-id> - Örnek Bubble ifadesi
Current User's unique id - Bu hesap veya kayıt için sabit değer. Kaydedilmiş dosyalarını veya taslaklarını geri yüklerken aynı değeri kullanın.
is_activeyes_no · Varsayılan: true- Örnek değer
yes - Örnek Bubble ifadesi
GuideHost's view_is_active (your yes/no custom state) - Bu görünüm açıkken evet ayarlayın. Ayrılırken hayır ayarlayın, böylece oynatma veya mevcut çalışma durabilir.
disabledyes_no · Varsayılan: false- Örnek değer
no - Örnek Bubble ifadesi
GuideHost's is_busy (your yes/no custom state) - Uygulamanız meşgulken veya bu eylem kullanılamazken öğeyi devre dışı bırakın.
show_controlsyes_no · Varsayılan: true- Örnek değer
yes - Örnek Bubble ifadesi
App Settings' show_editor_controls - Yerleşik denetimleri göster veya gizle.
crop_aspecttext · Varsayılan: "free"- Örnek değer
1:1 - Örnek Bubble ifadesi
Avatar Settings' crop_ratio - Mevcut iş kaydının değerini kullanın; aşağıdaki sınırlara karşı doğrulayın.
export_formattext · Varsayılan: "jpeg"- Örnek değer
jpeg - Örnek Bubble ifadesi
Format Dropdown's value - Mevcut iş kaydının değerini kullanın; aşağıdaki sınırlara karşı doğrulayın.
export_qualitynumber · Varsayılan: 0.85- Örnek değer
0.85 - Örnek Bubble ifadesi
Image Settings' quality - Mevcut iş kaydının değerini kullanın; aşağıdaki sınırlara karşı doğrulayın.
export_max_dimensionnumber · Varsayılan: 2048- Örnek değer
2048 - Örnek Bubble ifadesi
Image Settings' max_side - Mevcut iş kaydının değerini kullanın; aşağıdaki sınırlara karşı doğrulayın.
allow_upscaleyes_no · Varsayılan: false- Örnek değer
no - Örnek Bubble ifadesi
Allow upscale Checkbox is checked - Mevcut iş kaydının değerini kullanın; aşağıdaki sınırlara karşı doğrulayın.
ui_text_jsontext · Varsayılan: ""- Örnek değer
{} - Örnek Bubble ifadesi
App Settings' player_labels_json (supported keys only) - Desteklenen düğme etiketleriyle isteğe bağlı JSON. Yerleşik metni kullanmak için boş bırakın.
languagetext · Varsayılan: "auto"- Örnek değer
uk - Örnek Bubble ifadesi
Current User's preferred_language - language=auto'yi desteklenen bir cihazı veya tarayıcı dilini izlemek için ayarlayın. Açıkça seçmek için desteklenen bir dil kodu girin.
Eylemler ve girdileri · 13
Load source
Eylem parametresi yok
Begin crop
Eylem parametresi yok
Apply crop
origin_xnumber · Varsayılan: —- Örnek değer
0 - Örnek Bubble ifadesi
Crop Settings' x (or omit all rectangle inputs) - Mevcut iş kaydının değerini kullanın; aşağıdaki sınırlara karşı doğrulayın.
origin_ynumber · Varsayılan: —- Örnek değer
0 - Örnek Bubble ifadesi
Crop Settings' y (or omit all rectangle inputs) - Mevcut iş kaydının değerini kullanın; aşağıdaki sınırlara karşı doğrulayın.
widthnumber · Varsayılan: —- Örnek değer
512 - Örnek Bubble ifadesi
Resize Width Input's value:converted to number - Mevcut iş kaydının değerini kullanın; aşağıdaki sınırlara karşı doğrulayın.
heightnumber · Varsayılan: —- Örnek değer
512 - Örnek Bubble ifadesi
Resize Height Input's value:converted to number - Mevcut iş kaydının değerini kullanın; aşağıdaki sınırlara karşı doğrulayın.
Cancel crop
Eylem parametresi yok
Rotate
degreesnumber · Varsayılan: —- Örnek değer
90 - Örnek Bubble ifadesi
Rotation Dropdown's value - Mevcut iş kaydının değerini kullanın; aşağıdaki sınırlara karşı doğrulayın.
Flip
axistext · Varsayılan: —- Örnek değer
horizontal - Örnek Bubble ifadesi
Flip Direction Dropdown's value - Mevcut iş kaydının değerini kullanın; aşağıdaki sınırlara karşı doğrulayın.
Resize
widthnumber · Varsayılan: —- Örnek değer
512 - Örnek Bubble ifadesi
Resize Width Input's value:converted to number - Mevcut iş kaydının değerini kullanın; aşağıdaki sınırlara karşı doğrulayın.
heightnumber · Varsayılan: —- Örnek değer
512 - Örnek Bubble ifadesi
Resize Height Input's value:converted to number - Mevcut iş kaydının değerini kullanın; aşağıdaki sınırlara karşı doğrulayın.
Undo
Eylem parametresi yok
Redo
Eylem parametresi yok
Reset edits
Eylem parametresi yok
Export image
Eylem parametresi yok
Cancel operation
Eylem parametresi yok
Clear session
Eylem parametresi yok
Durumlar ve olaylar
Durumlar
editor_status · textBu eylemin mevcut sonucu. Başarıyı kaydetmeden önce eşleşen tamamlama olayını kullanın.
is_busy · yes_noİş hâlâ devam ediyor. Başka bir eyleme başlamadan önce bekleyin.
has_image · yes_noSeçilen öğenin mevcut değeri. İlgili olaydan sonra okuyun.
has_changes · yes_noSeçilen öğenin mevcut değeri. İlgili olaydan sonra okuyun.
can_undo · yes_noSeçilen öğenin mevcut değeri. İlgili olaydan sonra okuyun.
can_redo · yes_noSeçilen öğenin mevcut değeri. İlgili olaydan sonra okuyun.
image_width · numberSeçilen öğenin mevcut değeri. İlgili olaydan sonra okuyun.
image_height · numberSeçilen öğenin mevcut değeri. İlgili olaydan sonra okuyun.
output_uri · textCihazdaki dosya konumu. Dosya çevrimiçi tutulması gerekiyorsa ayrı olarak kaydedin veya yükleyin.
output_width · numberSeçilen öğenin mevcut değeri. İlgili olaydan sonra okuyun.
output_height · numberSeçilen öğenin mevcut değeri. İlgili olaydan sonra okuyun.
output_bytes · numberSeçilen öğenin mevcut değeri. İlgili olaydan sonra okuyun.
output_mime · textSeçilen öğenin mevcut değeri. İlgili olaydan sonra okuyun.
error_code · textSon eylem için hata bilgisi. Yardımcı bir mesaj gösterin ve ilgili yeniden denemeyi sunun.
crop_active · yes_noSeçilen öğenin mevcut değeri. İlgili olaydan sonra okuyun.
crop_rect_json · textSeçilen öğenin mevcut değeri. İlgili olaydan sonra okuyun.
Olaylar
source_loadedBu olay gerçekleştiğinde, aynı öğeden ilgili durumları okuyun.
source_load_failedBu olay gerçekleştiğinde, aynı öğeden ilgili durumları okuyun.
edit_appliedBu olay gerçekleştiğinde, aynı öğeden ilgili durumları okuyun.
edit_undoneBu olay gerçekleştiğinde, aynı öğeden ilgili durumları okuyun.
edit_redoneBu olay gerçekleştiğinde, aynı öğeden ilgili durumları okuyun.
editor_resetBu olay gerçekleştiğinde, aynı öğeden ilgili durumları okuyun.
export_startedBu olay gerçekleştiğinde, aynı öğeden ilgili durumları okuyun.
export_completedBu olay gerçekleştiğinde, aynı öğeden ilgili durumları okuyun.
operation_cancelledBu olay gerçekleştiğinde, aynı öğeden ilgili durumları okuyun.
editor_errorBu olay gerçekleştiğinde, aynı öğeden ilgili durumları okuyun.
Geliştiricilerin sorduğu sorular
output_uri, Bubble dosyası mı?
Hayır. Bu yerel önbellek yolu. Bulut dosya referansını saklamadan önce kanıtlanmış bir yerel kaydedici veya yükleyiciyle kalıcı hale getirin.
Abonelik nasıl çalışıyor?
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.
İlgili kılavuzlar
Yardım için, hangi eklentiyi ve cihazı kullandığınızı, denediğiniz eylemi ve ne olduğunu bize bildirin. Kişisel veri içermeyen bir örnek kullanın. Anahtarınızı veya özel dosyalarınızı asla paylaşmayın.