Xodera Plugins · Bubble Native
Xodera Photo Editor Native
Gjør et valgt foto til en konsistent avatar, produktbilde eller rapportvedlegg. Beskjær, roter og endre størrelse, og lagre deretter den eksporterte kopien i appen din.
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.
Dokumentasjon gjennomgått 6 november 2026
Praktiske eksempler
Konsistente profil‑avatarer før opplasting
Brukere bør velge hvilken del av fotoet deres vises i et kvadratisk profilbilde i stedet for å godta en vilkårlig beskjæring.
`source_url = selected profile image`; `crop_aspect = "1:1"`; `document_context = the account’s stable reference`.
Vent på `source_loaded`; Begin crop → Apply crop, med Rotate eller Undo etter behov. Ved eksplisitt lagring, Export image.
Kun på `export_completed`, bruk `output_uri`, `output_width`, `output_height` og `output_mime` som innganger i din filopplastings‑arbeidsflyt. Lagre dens varige referanse til profilen etterpå.
Hvis brukeren avbryter eller `editor_error` utløses, behold den gamle avataren. Tøm økten ved kontobytte slik at en annen bruker ikke kan se utkastet.
Redigering lager en lokal kopi. Appen din bestemmer hvordan den skal lagres eller lastes opp.
Forbered konsistente markeds‑ eller katalogbilder
Ulike innramminger og overdimensjonerte bilder gjør en katalog ujevn og øker opplastingsstørrelsen.
`source_url = selected item photo`; `crop_aspect = the app’s chosen ratio`; `export_max_dimension`, `export_format` og `export_quality` kommer fra din opplastingspolicy.
Beskjær det relevante området, eventuelt Resize, og deretter Export image etter at brukeren bekrefter. Behold den originale filen/referansen separat.
Sjekk `output_width`, `output_height`, `output_bytes` og `output_mime` før opplastings‑arbeidsflyten lagrer resultatet. Lagre den resulterende bildereferansen på elementet.
Hvis eksporten mislykkes eller resultatet bryter din opplastingspolicy, vis `error_code` og la brukeren revidere det. Ikke overskriv det forrige element‑bildet før opplastingsbekreftelse.
Redigering lager en lokal kopi. Appen din bestemmer hvordan den skal lagres eller lastes opp.
Lag en fokusert bildkopi for en feltrapport
En tekniker kan trenge et nærbilde av en skadet del samtidig som den originale rapportbildet bevares.
`source_url = Current Report Photo’s source`; `document_context = the report/account reference`; beskjæringsforholdet kan forbli ubegrenset.
Begin crop → Apply crop, bruk deretter Undo/Redo for å sammenligne redigeringer. Export image lager den redigerte kopien; appen din spør om den skal festes til rapporten.
Bruk `has_changes`, `can_undo`, `can_redo` og `output_uri`. Lagre originale og redigerte referanser i separate app‑felt etter en vellykket opplasting.
Cancel crop eller Reset edits gjenoppretter redigeringsstien; avbrytelse må la den opprinnelige Rapport‑vedlegget uendret.
Redigering lager en lokal kopi. Appen din bestemmer hvordan den skal lagres eller lastes opp.
Hva fungerer nå
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.
Bygg arbeidsflyten
Bruk de tilgjengelige beta‑handlingene nedenfor og test resultatet på dine mål‑enheter.
Disse eksemplene bruker app‑poster som Lesson, Message og Order. Erstatt dem med dine egne datatyper og elementnavn. Eksempel‑medieadresser må erstattes med dine egne filer.
Sett source_url til det valgte bildet. Bruk document_context for å identifisere kontoen og posten som redigeres, slik at endring av posten fjerner det forrige bildet.
Etter source_loaded, kjør Begin crop. Velg 1:1 for en avatar, juster beskjæringen og bruk Apply crop. Cancel crop lar bildet forbli uendret.
Bruk Rotate, Flip eller Resize om nødvendig. Undo og Redo navigerer gjennom fullførte redigeringer; Reset edits gjenoppretter originalbildet.
Kjør Export image. På export_completed, les output_uri, output_width, output_height og output_mime. Lagre eller last opp den kopien ved hjelp av ditt valgte fil‑lagringsarbeidsflyt, og deretter lagre den lagrede filen i posten.
Konfigurer én gang
Nøkkelaktivering er planlagt for dette pluginet. Opprett eller velg ditt Bubble app-prosjekt i BestPlugins → Dashboard → Plugins. Velg Xodera Photo Editor Native, kopier nøkkelen, åpne deretter Bubble → Plugins → Xodera Photo Editor Native og lim den inn i licensing_api_key. Lagre én gang; bruk deretter handlingene nedenfor. Hvert plugin i hvert prosjekt har sin egen nøkkel.
Velg eller ta bildet med appen din først. Gi redigereren den resulterende lesbare bildeadressen. Kamera- og fotobibliotekstillatelser tilhører den velgeren du bruker.
Konfigurer én gang
- Opprett eller velg ditt Bubble‑app‑prosjekt på BestPlugins → Dashboard → Plugins.
- Velg denne plugin‑en og kopier prosjekt‑nøkkelen.
- Open Bubble → Plugins → this plugin. Paste its project key into licensing_api_key and save.
- Legg til elementet, velg app‑dataene dine og bygg arbeidsflyten nedenfor.
- 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.
Installasjon og abonnement
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.
Lagre resultatet i appen din
Lagre det opplastede eller permanent lagrede bildet i Profile.image eller ditt vedleggsfelt. output_uri er en midlertidig fil på enheten, så lagre først den filen med din valgte arbeidsflyt. Deretter lagrer du output_width, output_height og output_mime som metadata. Behold originalbildet hvis du trenger begge versjoner.
Feil, avbryt og gjenoppretting
På source_load_failed eller editor_error, vis error_code og tilby Load source. Cancel operation stopper å godta det ufullstendige resultatet; vent til is_busy=no før du starter en ny redigering. Clear session tømmer redigereren, ikke et bilde som allerede er lagret andre steder.
Funksjoner og begrensninger
JPEG og PNG eksport; kvalitet 0–1; maksimal utgangsside 1–4096 piksler. Inndata: opptil 15 MiB og 20 megapiksler. Opptil 20 fullførte redigeringer. Beskjæringsvalg: fri, 1:1, 4:3, 3:4 og 16:9. Ingen innebygd kamera, filtre, tekstoverlegg, perspektivkorreksjon, WebP-eksport eller automatisk opplasting.
Innstillinger, handlinger og resultater
Bruk disse navnene i Bubble. Planlagte funksjoner er merket separat.
Tilgjengelige beta‑innstillinger
Elementinnstillinger
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 · textTilstander
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 · textHendelser
source_loadedsource_load_failededit_appliededit_undoneedit_redoneeditor_resetexport_startedexport_completedoperation_cancellededitor_errorHandlinger og deres innganger
Load sourceBegin cropApply cropCancel cropRotateFlipResizeUndoRedoReset editsExport imageCancel operationClear sessionElementinnstillinger · 12
source_urltext · Standard: ""- Eksempelverdi
https://bestplugins.online/native-samples/avatar.jpg - Eksempel Bubble uttrykk
Selected Profile's image_url - Adresse til den valgte lyd-, video- eller bildefilen. Bruk en filtype som dette plugin‑programmet støtter.
document_contexttext · Standard: ""- Eksempelverdi
<current-user-id> - Eksempel Bubble uttrykk
Current User's unique id - Stabil verdi for denne kontoen eller posten. Bruk samme verdi når du gjenoppretter lagrede filer eller utkast.
is_activeyes_no · Standard: true- Eksempelverdi
yes - Eksempel Bubble uttrykk
GuideHost's view_is_active (your yes/no custom state) - Sett ja mens denne visningen er åpen. Sett nei ved avslutning, slik at avspilling eller pågående arbeid kan stoppes.
disabledyes_no · Standard: false- Eksempelverdi
no - Eksempel Bubble uttrykk
GuideHost's is_busy (your yes/no custom state) - Deaktiver elementet mens appen din er opptatt eller handlingen er utilgjengelig.
show_controlsyes_no · Standard: true- Eksempelverdi
yes - Eksempel Bubble uttrykk
App Settings' show_editor_controls - Vis eller skjul de innebygde kontrollene.
crop_aspecttext · Standard: "free"- Eksempelverdi
1:1 - Eksempel Bubble uttrykk
Avatar Settings' crop_ratio - Bruk den nåværende forretningspostens verdi; valider den mot grensene nedenfor.
export_formattext · Standard: "jpeg"- Eksempelverdi
jpeg - Eksempel Bubble uttrykk
Format Dropdown's value - Bruk den nåværende forretningspostens verdi; valider den mot grensene nedenfor.
export_qualitynumber · Standard: 0.85- Eksempelverdi
0.85 - Eksempel Bubble uttrykk
Image Settings' quality - Bruk den nåværende forretningspostens verdi; valider den mot grensene nedenfor.
export_max_dimensionnumber · Standard: 2048- Eksempelverdi
2048 - Eksempel Bubble uttrykk
Image Settings' max_side - Bruk den nåværende forretningspostens verdi; valider den mot grensene nedenfor.
allow_upscaleyes_no · Standard: false- Eksempelverdi
no - Eksempel Bubble uttrykk
Allow upscale Checkbox is checked - Bruk den nåværende forretningspostens verdi; valider den mot grensene nedenfor.
ui_text_jsontext · Standard: ""- Eksempelverdi
{} - Eksempel Bubble uttrykk
App Settings' player_labels_json (supported keys only) - Valgfri JSON med støttede knappetiketter. La stå tomt for å bruke den innebygde teksten.
languagetext · Standard: "auto"- Eksempelverdi
uk - Eksempel Bubble uttrykk
Current User's preferred_language - Sett language=auto til å følge en støttet enhet eller nettleserspråk. Skriv inn en støttet språkkode for å velge den eksplisitt.
Handlinger og deres innganger · 13
Load source
Ingen handlingsparametere
Begin crop
Ingen handlingsparametere
Apply crop
origin_xnumber · Standard: —- Eksempelverdi
0 - Eksempel Bubble uttrykk
Crop Settings' x (or omit all rectangle inputs) - Bruk den nåværende forretningspostens verdi; valider den mot grensene nedenfor.
origin_ynumber · Standard: —- Eksempelverdi
0 - Eksempel Bubble uttrykk
Crop Settings' y (or omit all rectangle inputs) - Bruk den nåværende forretningspostens verdi; valider den mot grensene nedenfor.
widthnumber · Standard: —- Eksempelverdi
512 - Eksempel Bubble uttrykk
Resize Width Input's value:converted to number - Bruk den nåværende forretningspostens verdi; valider den mot grensene nedenfor.
heightnumber · Standard: —- Eksempelverdi
512 - Eksempel Bubble uttrykk
Resize Height Input's value:converted to number - Bruk den nåværende forretningspostens verdi; valider den mot grensene nedenfor.
Cancel crop
Ingen handlingsparametere
Rotate
degreesnumber · Standard: —- Eksempelverdi
90 - Eksempel Bubble uttrykk
Rotation Dropdown's value - Bruk den nåværende forretningspostens verdi; valider den mot grensene nedenfor.
Flip
axistext · Standard: —- Eksempelverdi
horizontal - Eksempel Bubble uttrykk
Flip Direction Dropdown's value - Bruk den nåværende forretningspostens verdi; valider den mot grensene nedenfor.
Resize
widthnumber · Standard: —- Eksempelverdi
512 - Eksempel Bubble uttrykk
Resize Width Input's value:converted to number - Bruk den nåværende forretningspostens verdi; valider den mot grensene nedenfor.
heightnumber · Standard: —- Eksempelverdi
512 - Eksempel Bubble uttrykk
Resize Height Input's value:converted to number - Bruk den nåværende forretningspostens verdi; valider den mot grensene nedenfor.
Undo
Ingen handlingsparametere
Redo
Ingen handlingsparametere
Reset edits
Ingen handlingsparametere
Export image
Ingen handlingsparametere
Cancel operation
Ingen handlingsparametere
Clear session
Ingen handlingsparametere
Tilstander og hendelser
Tilstander
editor_status · textNåværende resultat av denne handlingen. Bruk den tilsvarende fullførings‑hendelsen før du lagrer suksess.
is_busy · yes_noArbeidet pågår fortsatt. Vent før du starter en ny handling.
has_image · yes_noNåværende verdi for det valgte elementet. Les den etter den relaterte hendelsen.
has_changes · yes_noNåværende verdi for det valgte elementet. Les den etter den relaterte hendelsen.
can_undo · yes_noNåværende verdi for det valgte elementet. Les den etter den relaterte hendelsen.
can_redo · yes_noNåværende verdi for det valgte elementet. Les den etter den relaterte hendelsen.
image_width · numberNåværende verdi for det valgte elementet. Les den etter den relaterte hendelsen.
image_height · numberNåværende verdi for det valgte elementet. Les den etter den relaterte hendelsen.
output_uri · textFilplassering på denne enheten. Lagre eller last opp filen separat hvis den må holdes på nettet.
output_width · numberNåværende verdi for det valgte elementet. Les den etter den relaterte hendelsen.
output_height · numberNåværende verdi for det valgte elementet. Les den etter den relaterte hendelsen.
output_bytes · numberNåværende verdi for det valgte elementet. Les den etter den relaterte hendelsen.
output_mime · textNåværende verdi for det valgte elementet. Les den etter den relaterte hendelsen.
error_code · textFeilinformasjon for den siste handlingen. Vis en hjelpsom melding og tilby relevant gjenforsøk.
crop_active · yes_noNåværende verdi for det valgte elementet. Les den etter den relaterte hendelsen.
crop_rect_json · textNåværende verdi for det valgte elementet. Les den etter den relaterte hendelsen.
Hendelser
source_loadedNår denne hendelsen oppstår, les de relaterte tilstandene fra samme element.
source_load_failedNår denne hendelsen oppstår, les de relaterte tilstandene fra samme element.
edit_appliedNår denne hendelsen oppstår, les de relaterte tilstandene fra samme element.
edit_undoneNår denne hendelsen oppstår, les de relaterte tilstandene fra samme element.
edit_redoneNår denne hendelsen oppstår, les de relaterte tilstandene fra samme element.
editor_resetNår denne hendelsen oppstår, les de relaterte tilstandene fra samme element.
export_startedNår denne hendelsen oppstår, les de relaterte tilstandene fra samme element.
export_completedNår denne hendelsen oppstår, les de relaterte tilstandene fra samme element.
operation_cancelledNår denne hendelsen oppstår, les de relaterte tilstandene fra samme element.
editor_errorNår denne hendelsen oppstår, les de relaterte tilstandene fra samme element.
Spørsmål utviklere stiller
Er output_uri en Bubble‑fil?
Nei. Det er en lokal hurtiglagringssti. Oppretthold den via en pålitelig lokal lagrer eller opplaster før du lagrer en sky‑filreferanse.
Hvordan fungerer abonnementet?
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.
Relaterte veiledninger
For hjelp, fortell oss hvilken plugin og enhet du bruker, handlingen du prøvde og hva som skjedde. Bruk et eksempel uten personlige data. Del aldri nøkkelen din eller private filer.