Xodera Plugins · Bubble Native
Xodera Photo Editor Native
Verander ’n gekose foto in ’n konsekwente avatar, produkbeeld of verslagaanhangsel. Sny, roteer en skaal dit, en stoor dan die uitgevoerde kopie in jou app.
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.
Dokumentasie hersien 6 November 2026
Praktiese voorbeelde
Konsekvente profiel-avatars voor oplaai
Gebruikers moet kies watter deel van hul foto in 'n vierkante profielbeeld verskyn in plaas van om 'n willekeurige sny te aanvaar.
`source_url = selected profile image`; `crop_aspect = "1:1"`; `document_context = the account’s stable reference`.
Wag vir `source_loaded`; Begin crop → Apply crop, met Rotate of Undo soos nodig. By eksplisiete Stoor, Export image.
Slegs op `export_completed`, gebruik `output_uri`, `output_width`, `output_height` en `output_mime` as insette vir jou lêeroplaai-werkstroom. Stoor daarna die blywende verwysing daarvan in die Profiel.
As die gebruiker kanselleer of `editor_error` afskiet, behou die ou avatar. Maak die sessie skoon by rekeningverandering sodat 'n ander gebruiker die konsep nie kan sien nie.
Redigering skep 'n plaaslike kopie. Jou app kies hoe om dit te stoor of op te laai.
Berei konsekwente markplein- of katalogusfoto's voor
Verskeie raamwerk en oormaatbeelde maak 'n katalogus ongelyk en verhoog die oplaai-grootte.
`source_url = selected item photo`; `crop_aspect = the app’s chosen ratio`; `export_max_dimension`, `export_format` en `export_quality` kom uit jou oplaai-beleid.
Sny die relevante area, opsioneel Resize, en dan Export image nadat die gebruiker bevestig. Hou die oorspronklike lêer/verwysing apart.
Kontroleer `output_width`, `output_height`, `output_bytes` en `output_mime` voordat jou oplaai-werkstroom die resultaat stoor. Stoor die resulterende beeldverwysing op die Item.
As uitvoer misluk of die resultaat jou oplaai-beleid skend, wys `error_code` en laat die gebruiker dit regstel. Moenie die vorige Item-beeld oorskryf voordat die oplaai bevestig is nie.
Redigering skep 'n plaaslike kopie. Jou app kies hoe om dit te stoor of op te laai.
Skep 'n gefokusde beeldkopie vir 'n veldverslag
'n Tegniker mag 'n nabyfoto van een beskadigde deel benodig terwyl die oorspronklike verslagbeeld bewaar word.
`source_url = Current Report Photo’s source`; `document_context = the report/account reference`; snyverhouding kan onbeperk bly.
Begin crop → Apply crop, gebruik dan Undo/Redo om wysigings te vergelyk. Export image skep die gewysigde kopie; jou app vra of daardie kopie aan die Verslag geheg moet word.
Gebruik `has_changes`, `can_undo`, `can_redo` en `output_uri`. Stoor oorspronklike en gewysigde verwysings in aparte app-velde na 'n suksesvolle oplaai.
Cancel crop of Reset edits herstel die redigeringspad; kansellasie moet die oorspronklike Verslag-aanhegsel onveranderd laat.
Redigering skep 'n plaaslike kopie. Jou app kies hoe om dit te stoor of op te laai.
Wat nou werk
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.
Bou die werkvloei
Gebruik die beskikbare beta-aksies hieronder en toets die resultaat op jou teiken-toestelle.
Hierdie voorbeelde gebruik app-rekords soos Lesson, Message en Order. Vervang dit met jou eie datatipes en elementname. Voorbeeldmedia-adresse moet met jou eie lêers vervang word.
Stel source_url op die gekose beeld. Gebruik document_context om die rekening en rekord wat geredigeer word te identifiseer, sodat die verandering van die rekord die vorige foto skoonmaak.
Na source_loaded, voer Begin crop uit. Kies 1:1 vir ’n avatar, pas die sny aan en gebruik Apply crop. Cancel crop laat die beeld onveranderd.
Gebruik Rotate, Flip of Resize indien nodig. Undo en Redo beweeg deur voltooiëde wysigings; Reset edits herstel die oorspronklike beeld.
Voer Export image uit. Op export_completed, lees output_uri, output_width, output_height en output_mime. Stoor of laai daardie kopie op met jou gekose lêerbewaarwerkstroom, en stoor dan die gestoorde lêer in die rekord.
Stel een keer op
Sleutelaktivering is beplan vir hierdie inprop. Skep of kies jou Bubble‑appprojek in BestPlugins → Dashboard → Plugins. Kies Xodera Photo Editor Native, kopieer die sleutel, open dan Bubble → Plugins → Xodera Photo Editor Native en plak dit in licensing_api_key. Stoor een keer; gebruik dan die aksies hieronder. Elke inprop in elke projek het sy eie sleutel.
Kies of neem die beeld eers met jou app. Gee die redakteur die resulterende leesbare beeldadres. Kamera‑ en foto‑biblioteek‑toestemmings behoort aan die kiezer wat jy gebruik.
Stel een keer op
- Skep of kies jou Bubble-appprojek by BestPlugins → Dashboard → Plugins.
- Kies hierdie inprop en kopieer die projek-sleutel.
- Open Bubble → Plugins → this plugin. Paste its project key into licensing_api_key and save.
- Voeg die element by, kies jou app-data en bou die werkstroom hieronder.
- 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.
Installasie en intekening
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.
Stoor die resultaat in jou app
Stoor die opgelaaide of permanent gestoor beeld in Profile.image of jou aanhegingsveld. output_uri is 'n tydelike lêer op die toestel, so stoor eers daardie lêer met jou gekose werkstroom. Stoor dan output_width, output_height en output_mime as metadata. Hou die oorspronklike beeld behou as jy albei weergawes nodig het.
Mislukking, kanselleer en herstel
Op source_load_failed of editor_error, wys error_code en bied Load source aan. Cancel operation hou op om die onafgewerkte resultaat te aanvaar; wag tot is_busy=no voordat jy nog 'n redigering begin. Clear session maak die redakteur skoon, nie 'n beeld wat elders reeds gestoor is nie.
Vermoeëns en beperkings
JPEG en PNG uitvoer; kwaliteit 0–1; maksimum uitvoerkant 1–4096 pixels. Invoer: tot 15 MiB en 20 megapixels. Tot 20 voltooide redigeringe. Knipkeuses: vry, 1:1, 4:3, 3:4 en 16:9. Geen ingeboude kamera, filters, teksoorleg, perspektiefkorreksie, WebP uitvoer of outomatiese oplaai nie.
Instellings, aksies en resultate
Gebruik hierdie name in Bubble. Beplande funksies word afsonderlik gemerk.
Beskikbare beta-instellings
Elementinstellings
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 · textToestande
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 · textGebeurtenisse
source_loadedsource_load_failededit_appliededit_undoneedit_redoneeditor_resetexport_startedexport_completedoperation_cancellededitor_errorAksies en hul insette
Load sourceBegin cropApply cropCancel cropRotateFlipResizeUndoRedoReset editsExport imageCancel operationClear sessionElementinstellings · 12
source_urltext · Verstek: ""- Voorbeeldwaarde
https://bestplugins.online/native-samples/avatar.jpg - Voorbeeld Bubble-uitdrukking
Selected Profile's image_url - Adres van die gekose audio-, video- of beeldlêer. Gebruik ’n lêertipe wat hierdie inprop ondersteun.
document_contexttext · Verstek: ""- Voorbeeldwaarde
<current-user-id> - Voorbeeld Bubble-uitdrukking
Current User's unique id - Stabiele waarde vir hierdie rekening of rekord. Gebruik dieselfde waarde wanneer u die gestoorde lêers of konsepte herstel.
is_activeyes_no · Verstek: true- Voorbeeldwaarde
yes - Voorbeeld Bubble-uitdrukking
GuideHost's view_is_active (your yes/no custom state) - Stel ja wanneer hierdie aansig oop is. Stel nee wanneer dit verlaat word, sodat terugspeel of huidige werk kan stop.
disabledyes_no · Verstek: false- Voorbeeldwaarde
no - Voorbeeld Bubble-uitdrukking
GuideHost's is_busy (your yes/no custom state) - Deaktiveer die element terwyl jou app besig is of hierdie aksie nie beskikbaar is nie.
show_controlsyes_no · Verstek: true- Voorbeeldwaarde
yes - Voorbeeld Bubble-uitdrukking
App Settings' show_editor_controls - Wys of verberg die ingeboude kontroles.
crop_aspecttext · Verstek: "free"- Voorbeeldwaarde
1:1 - Voorbeeld Bubble-uitdrukking
Avatar Settings' crop_ratio - Gebruik die huidige besigheidsrekord se waarde; valideer dit teen die onderstaande limiete.
export_formattext · Verstek: "jpeg"- Voorbeeldwaarde
jpeg - Voorbeeld Bubble-uitdrukking
Format Dropdown's value - Gebruik die huidige besigheidsrekord se waarde; valideer dit teen die onderstaande limiete.
export_qualitynumber · Verstek: 0.85- Voorbeeldwaarde
0.85 - Voorbeeld Bubble-uitdrukking
Image Settings' quality - Gebruik die huidige besigheidsrekord se waarde; valideer dit teen die onderstaande limiete.
export_max_dimensionnumber · Verstek: 2048- Voorbeeldwaarde
2048 - Voorbeeld Bubble-uitdrukking
Image Settings' max_side - Gebruik die huidige besigheidsrekord se waarde; valideer dit teen die onderstaande limiete.
allow_upscaleyes_no · Verstek: false- Voorbeeldwaarde
no - Voorbeeld Bubble-uitdrukking
Allow upscale Checkbox is checked - Gebruik die huidige besigheidsrekord se waarde; valideer dit teen die onderstaande limiete.
ui_text_jsontext · Verstek: ""- Voorbeeldwaarde
{} - Voorbeeld Bubble-uitdrukking
App Settings' player_labels_json (supported keys only) - Opsioneel JSON met ondersteunde knoppie-etikette. Laat leeg om die ingeboude teks te gebruik.
languagetext · Verstek: "auto"- Voorbeeldwaarde
uk - Voorbeeld Bubble-uitdrukking
Current User's preferred_language - Stel language=auto in om ’n ondersteunde toestel of blaaier se taal te volg. Voer ’n ondersteunde taalkode in om dit eksplisiet te kies.
Aksies en hul insette · 13
Load source
Geen aksie‑parameters nie
Begin crop
Geen aksie‑parameters nie
Apply crop
origin_xnumber · Verstek: —- Voorbeeldwaarde
0 - Voorbeeld Bubble-uitdrukking
Crop Settings' x (or omit all rectangle inputs) - Gebruik die huidige besigheidsrekord se waarde; valideer dit teen die onderstaande limiete.
origin_ynumber · Verstek: —- Voorbeeldwaarde
0 - Voorbeeld Bubble-uitdrukking
Crop Settings' y (or omit all rectangle inputs) - Gebruik die huidige besigheidsrekord se waarde; valideer dit teen die onderstaande limiete.
widthnumber · Verstek: —- Voorbeeldwaarde
512 - Voorbeeld Bubble-uitdrukking
Resize Width Input's value:converted to number - Gebruik die huidige besigheidsrekord se waarde; valideer dit teen die onderstaande limiete.
heightnumber · Verstek: —- Voorbeeldwaarde
512 - Voorbeeld Bubble-uitdrukking
Resize Height Input's value:converted to number - Gebruik die huidige besigheidsrekord se waarde; valideer dit teen die onderstaande limiete.
Cancel crop
Geen aksie‑parameters nie
Rotate
degreesnumber · Verstek: —- Voorbeeldwaarde
90 - Voorbeeld Bubble-uitdrukking
Rotation Dropdown's value - Gebruik die huidige besigheidsrekord se waarde; valideer dit teen die onderstaande limiete.
Flip
axistext · Verstek: —- Voorbeeldwaarde
horizontal - Voorbeeld Bubble-uitdrukking
Flip Direction Dropdown's value - Gebruik die huidige besigheidsrekord se waarde; valideer dit teen die onderstaande limiete.
Resize
widthnumber · Verstek: —- Voorbeeldwaarde
512 - Voorbeeld Bubble-uitdrukking
Resize Width Input's value:converted to number - Gebruik die huidige besigheidsrekord se waarde; valideer dit teen die onderstaande limiete.
heightnumber · Verstek: —- Voorbeeldwaarde
512 - Voorbeeld Bubble-uitdrukking
Resize Height Input's value:converted to number - Gebruik die huidige besigheidsrekord se waarde; valideer dit teen die onderstaande limiete.
Undo
Geen aksie‑parameters nie
Redo
Geen aksie‑parameters nie
Reset edits
Geen aksie‑parameters nie
Export image
Geen aksie‑parameters nie
Cancel operation
Geen aksie‑parameters nie
Clear session
Geen aksie‑parameters nie
Toestande en gebeurtenisse
Toestande
editor_status · textHuidige resultaat van hierdie aksie. Gebruik die ooreenstemmende voltooiingsgebeurtenis voordat sukses gestoor word.
is_busy · yes_noWerk is nog in gang. Wag voordat u 'n ander aksie begin.
has_image · yes_noHuidige waarde vir die gekose item. Lees dit na die verwante gebeurtenis.
has_changes · yes_noHuidige waarde vir die gekose item. Lees dit na die verwante gebeurtenis.
can_undo · yes_noHuidige waarde vir die gekose item. Lees dit na die verwante gebeurtenis.
can_redo · yes_noHuidige waarde vir die gekose item. Lees dit na die verwante gebeurtenis.
image_width · numberHuidige waarde vir die gekose item. Lees dit na die verwante gebeurtenis.
image_height · numberHuidige waarde vir die gekose item. Lees dit na die verwante gebeurtenis.
output_uri · textLêerligging op hierdie toestel. Stoor of laai die lêer afsonderlik op as dit aanlyn gehou moet word.
output_width · numberHuidige waarde vir die gekose item. Lees dit na die verwante gebeurtenis.
output_height · numberHuidige waarde vir die gekose item. Lees dit na die verwante gebeurtenis.
output_bytes · numberHuidige waarde vir die gekose item. Lees dit na die verwante gebeurtenis.
output_mime · textHuidige waarde vir die gekose item. Lees dit na die verwante gebeurtenis.
error_code · textFoutinligting vir die laaste aksie. Wys 'n nuttige boodskap en bied die toepaslike herprobe aan.
crop_active · yes_noHuidige waarde vir die gekose item. Lees dit na die verwante gebeurtenis.
crop_rect_json · textHuidige waarde vir die gekose item. Lees dit na die verwante gebeurtenis.
Gebeurtenisse
source_loadedWanneer hierdie gebeurtenis plaasvind, lees die verwante toestande vanaf dieselfde element.
source_load_failedWanneer hierdie gebeurtenis plaasvind, lees die verwante toestande vanaf dieselfde element.
edit_appliedWanneer hierdie gebeurtenis plaasvind, lees die verwante toestande vanaf dieselfde element.
edit_undoneWanneer hierdie gebeurtenis plaasvind, lees die verwante toestande vanaf dieselfde element.
edit_redoneWanneer hierdie gebeurtenis plaasvind, lees die verwante toestande vanaf dieselfde element.
editor_resetWanneer hierdie gebeurtenis plaasvind, lees die verwante toestande vanaf dieselfde element.
export_startedWanneer hierdie gebeurtenis plaasvind, lees die verwante toestande vanaf dieselfde element.
export_completedWanneer hierdie gebeurtenis plaasvind, lees die verwante toestande vanaf dieselfde element.
operation_cancelledWanneer hierdie gebeurtenis plaasvind, lees die verwante toestande vanaf dieselfde element.
editor_errorWanneer hierdie gebeurtenis plaasvind, lees die verwante toestande vanaf dieselfde element.
Vrae wat ontwikkelaars vra
Is output_uri 'n Bubble-lêer?
Nee. Dit is 'n plaaslike kaspad. Volhard dit deur 'n beproefde plaaslike stoor- of oplaai-funksie voordat jy 'n wolk-lêerverwysing stoor.
Hoe werk die intekening?
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.
Verwante gidse
Vir hulp, vertel ons watter plugin en toestel jy gebruik, die aksie wat jy probeer het en wat gebeur het. Gebruik ’n voorbeeld sonder persoonlike data. Deel nooit jou sleutel of private lêers nie.