Xodera Plugins · Bubble Native
Xodera Photo Editor Native
Pretvorite odabranu fotografiju u dosljedni avatar, sliku proizvoda ili privitak izvješća. Izrežite, okrenite i promijenite veličinu, zatim spremite izvezenu kopiju u aplikaciji.
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.
Dokumentacija pregledana 6 studeni 2026
Praktični primjeri
Dosljedni avatari profila prije učitavanja
Korisnici bi trebali odabrati koji dio njihove fotografije će se pojaviti u kvadratnoj slici profila umjesto prihvaćanja proizvoljnog izrezivanja.
`source_url = selected profile image`; `crop_aspect = "1:1"`; `document_context = the account’s stable reference`.
Pričekajte `source_loaded`; Begin crop → Apply crop, s Rotate ili Undo po potrebi. Pri izričitoj spremi, Export image.
Samo na `export_completed`, koristite `output_uri`, `output_width`, `output_height` i `output_mime` kao ulaze u vaš radni tijek učitavanja datoteka. Nakon toga spremite njegovu trajnu referencu u Profil.
Ako korisnik otkaže ili `editor_error` se aktivira, zadržite stari avatar. Očistite sesiju pri promjeni računa kako drugi korisnik ne bi mogao vidjeti skicu.
Uređivanje stvara lokalnu kopiju. Vaša aplikacija odlučuje kako je spremiti ili učitati.
Pripremite dosljedne fotografije za tržište ili katalog
Različito kadriranje i prevelike slike čine katalog neujednačenim i povećavaju veličinu učitavanja.
`source_url = selected item photo`; `crop_aspect = the app’s chosen ratio`; `export_max_dimension`, `export_format` i `export_quality` dolaze iz vaše politike učitavanja.
Izrežite relevantno područje, po želji Resize, zatim Export image nakon što korisnik potvrdi. Originalnu datoteku/referencu čuvajte odvojeno.
Provjerite `output_width`, `output_height`, `output_bytes` i `output_mime` prije nego vaš radni tijek učitavanja spremi rezultat. Pohranite referencu nastale slike na Stavku.
Ako izvoz ne uspije ili rezultat krši vašu politiku učitavanja, prikažite `error_code` i dopustite korisniku da ga izmijeni. Nemojte prepisati prethodnu sliku Stavke prije potvrde učitavanja.
Uređivanje stvara lokalnu kopiju. Vaša aplikacija odlučuje kako je spremiti ili učitati.
Stvorite fokusiranu kopiju slike za terenski izvještaj
Tehničar može trebati detaljan prikaz jednog oštećenog dijela uz očuvanje originalne slike izvještaja.
`source_url = Current Report Photo’s source`; `document_context = the report/account reference`; omjer izrezivanja može ostati neograničen.
Begin crop → Apply crop, zatim koristite Undo/Redo za usporedbu uređivanja. Export image stvara uređenu kopiju; vaša aplikacija pita želite li tu kopiju priložiti izvještaju.
Koristite `has_changes`, `can_undo`, `can_redo` i `output_uri`. Po uspješnom učitavanju pohranite originalne i uređene reference u odvojena polja aplikacije.
Cancel crop ili Reset edits vraća put uređivanja; otkazivanje mora ostaviti originalni prilog izvješća nepromijenjenim.
Uređivanje stvara lokalnu kopiju. Vaša aplikacija odlučuje kako je spremiti ili učitati.
Što trenutno funkcionira
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.
Izradite radni tok
Koristite dostupne beta radnje ispod i testirajte rezultat na svojim ciljanim uređajima.
Ovi primjeri koriste zapise aplikacije poput Lesson, Message i Order. Zamijenite ih vlastitim tipovima podataka i nazivima elemenata. Primjer adresa medija mora biti zamijenjen vašim vlastitim datotekama.
Postavite source_url na odabranu sliku. Upotrijebite document_context za identifikaciju računa i zapisa koji se uređuje, tako da promjena zapisa očisti prethodnu fotografiju.
Nakon source_loaded, pokrenite Begin crop. Odaberite 1:1 za avatar, prilagodite izrez i upotrijebite Apply crop. Cancel crop ostavlja sliku nepromijenjenom.
Koristite Rotate, Flip ili Resize po potrebi. Undo i Redo prolaze kroz dovršena uređivanja; Reset edits vraća originalnu sliku.
Pokrenite Export image. Na export_completed pročitajte output_uri, output_width, output_height i output_mime. Spremite ili učitajte tu kopiju koristeći odabrani radni tijek za spremanje datoteka, zatim pohranite spremljenu datoteku u zapis.
Postavite jednom
Aktivacija ključa je planirana za ovaj dodatak. Stvorite ili odaberite svoj Bubble projekt aplikacije u BestPlugins → Dashboard → Plugins. Odaberite Xodera Photo Editor Native, kopirajte njegov ključ, zatim otvorite Bubble → Plugins → Xodera Photo Editor Native i zalijepite ga u licensing_api_key. Spremite jednom; zatim koristite radnje ispod. Svaki dodatak u svakom projektu ima svoj ključ.
Prvo odaberite ili snimite sliku u aplikaciji. Dostavite uređivaču dobivenu adresu čitljive slike. Dozvole za kameru i foto‑biblioteku pripadaju odabiru koji koristite.
Postavite jednom
- Stvorite ili odaberite svoj Bubble projekt aplikacije na BestPlugins → Dashboard → Plugins.
- Odaberite ovaj dodatak i kopirajte njegov ključ projekta.
- Open Bubble → Plugins → this plugin. Paste its project key into licensing_api_key and save.
- Dodajte element, odaberite svoje podatke aplikacije i izradite radni tok ispod.
- 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.
Instalacija i pretplata
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.
Spremite rezultat u svoju aplikaciju
Spremite učitanu ili trajno spremljenu sliku u Profile.image ili svoje polje privitka. output_uri je privremena datoteka na uređaju, pa najprije spremite tu datoteku svojim odabranim radnim tokom. Zatim pohranite output_width, output_height i output_mime kao metapodatke. Zadržite originalnu sliku ako su vam potrebne obje verzije.
Neuspjeh, otkazivanje i oporavak
Na source_load_failed ili editor_error, prikažite error_code i ponudite Load source. Cancel operation prestaje prihvaćati nedovršeni rezultat; pričekajte do is_busy=no prije pokretanja novog uređivanja. Clear session briše uređivač, a ne sliku već spremljenu drugdje.
Mogućnosti i ograničenja
JPEG i PNG izvoz; kvaliteta 0–1; maksimalna izlazna strana 1–4096 piksela. Ulaz: do 15 MiB i 20 megapiksela. Do 20 dovršenih uređivanja. Opcije izrezivanja: slobodno, 1:1, 4:3, 3:4 i 16:9. Nema ugrađene kamere, filtera, tekstualnih prekrivanja, korekcije perspektive, WebP izvoz ili automatsko učitavanje.
Postavke, radnje i rezultati
Koristite ove nazive u Bubble. Planirane značajke su označene odvojeno.
Dostupna beta podešavanja
Postavke elementa
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 · textStanja
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 · textDogađaji
source_loadedsource_load_failededit_appliededit_undoneedit_redoneeditor_resetexport_startedexport_completedoperation_cancellededitor_errorRadnje i njihovi ulazi
Load sourceBegin cropApply cropCancel cropRotateFlipResizeUndoRedoReset editsExport imageCancel operationClear sessionPostavke elementa · 12
source_urltext · Zadano: ""- Primjer vrijednosti
https://bestplugins.online/native-samples/avatar.jpg - Primjer Bubble izraza
Selected Profile's image_url - Adresa odabrane audio, video ili slikovne datoteke. Koristite tip datoteke koji ovaj dodatak podržava.
document_contexttext · Zadano: ""- Primjer vrijednosti
<current-user-id> - Primjer Bubble izraza
Current User's unique id - Stabilna vrijednost za ovaj račun ili zapis. Koristite istu vrijednost pri vraćanju njegovih spremljenih datoteka ili skica.
is_activeyes_no · Zadano: true- Primjer vrijednosti
yes - Primjer Bubble izraza
GuideHost's view_is_active (your yes/no custom state) - Postavite da je da dok je ovaj prikaz otvoren. Postavite da je ne kada napuštate, kako bi se reprodukcija ili trenutni rad mogli zaustaviti.
disabledyes_no · Zadano: false- Primjer vrijednosti
no - Primjer Bubble izraza
GuideHost's is_busy (your yes/no custom state) - Onemogućite element dok je vaša aplikacija zauzeta ili je ova radnja nedostupna.
show_controlsyes_no · Zadano: true- Primjer vrijednosti
yes - Primjer Bubble izraza
App Settings' show_editor_controls - Pokažite ili sakrijte ugrađene kontrole.
crop_aspecttext · Zadano: "free"- Primjer vrijednosti
1:1 - Primjer Bubble izraza
Avatar Settings' crop_ratio - Koristite vrijednost trenutnog poslovnog zapisa; provjerite je li unutar donjih granica.
export_formattext · Zadano: "jpeg"- Primjer vrijednosti
jpeg - Primjer Bubble izraza
Format Dropdown's value - Koristite vrijednost trenutnog poslovnog zapisa; provjerite je li unutar donjih granica.
export_qualitynumber · Zadano: 0.85- Primjer vrijednosti
0.85 - Primjer Bubble izraza
Image Settings' quality - Koristite vrijednost trenutnog poslovnog zapisa; provjerite je li unutar donjih granica.
export_max_dimensionnumber · Zadano: 2048- Primjer vrijednosti
2048 - Primjer Bubble izraza
Image Settings' max_side - Koristite vrijednost trenutnog poslovnog zapisa; provjerite je li unutar donjih granica.
allow_upscaleyes_no · Zadano: false- Primjer vrijednosti
no - Primjer Bubble izraza
Allow upscale Checkbox is checked - Koristite vrijednost trenutnog poslovnog zapisa; provjerite je li unutar donjih granica.
ui_text_jsontext · Zadano: ""- Primjer vrijednosti
{} - Primjer Bubble izraza
App Settings' player_labels_json (supported keys only) - Opcionalni JSON s podržanim oznakama gumba. Ostavite prazno za korištenje ugrađenog teksta.
languagetext · Zadano: "auto"- Primjer vrijednosti
uk - Primjer Bubble izraza
Current User's preferred_language - Postavite language=auto da prati podržani uređaj ili jezik preglednika. Unesite podržani kod jezika za izričitu odabir.
Radnje i njihovi ulazi · 13
Load source
Nema parametara radnje
Begin crop
Nema parametara radnje
Apply crop
origin_xnumber · Zadano: —- Primjer vrijednosti
0 - Primjer Bubble izraza
Crop Settings' x (or omit all rectangle inputs) - Koristite vrijednost trenutnog poslovnog zapisa; provjerite je li unutar donjih granica.
origin_ynumber · Zadano: —- Primjer vrijednosti
0 - Primjer Bubble izraza
Crop Settings' y (or omit all rectangle inputs) - Koristite vrijednost trenutnog poslovnog zapisa; provjerite je li unutar donjih granica.
widthnumber · Zadano: —- Primjer vrijednosti
512 - Primjer Bubble izraza
Resize Width Input's value:converted to number - Koristite vrijednost trenutnog poslovnog zapisa; provjerite je li unutar donjih granica.
heightnumber · Zadano: —- Primjer vrijednosti
512 - Primjer Bubble izraza
Resize Height Input's value:converted to number - Koristite vrijednost trenutnog poslovnog zapisa; provjerite je li unutar donjih granica.
Cancel crop
Nema parametara radnje
Rotate
degreesnumber · Zadano: —- Primjer vrijednosti
90 - Primjer Bubble izraza
Rotation Dropdown's value - Koristite vrijednost trenutnog poslovnog zapisa; provjerite je li unutar donjih granica.
Flip
axistext · Zadano: —- Primjer vrijednosti
horizontal - Primjer Bubble izraza
Flip Direction Dropdown's value - Koristite vrijednost trenutnog poslovnog zapisa; provjerite je li unutar donjih granica.
Resize
widthnumber · Zadano: —- Primjer vrijednosti
512 - Primjer Bubble izraza
Resize Width Input's value:converted to number - Koristite vrijednost trenutnog poslovnog zapisa; provjerite je li unutar donjih granica.
heightnumber · Zadano: —- Primjer vrijednosti
512 - Primjer Bubble izraza
Resize Height Input's value:converted to number - Koristite vrijednost trenutnog poslovnog zapisa; provjerite je li unutar donjih granica.
Undo
Nema parametara radnje
Redo
Nema parametara radnje
Reset edits
Nema parametara radnje
Export image
Nema parametara radnje
Cancel operation
Nema parametara radnje
Clear session
Nema parametara radnje
Stanja i događaji
Stanja
editor_status · textTrenutni rezultat ove radnje. Upotrijebite odgovarajući događaj dovršetka prije spremanja uspjeha.
is_busy · yes_noRad je još u tijeku. Pričekajte prije pokretanja druge radnje.
has_image · yes_noTrenutna vrijednost odabranog stavka. Pročitajte je nakon povezanog događaja.
has_changes · yes_noTrenutna vrijednost odabranog stavka. Pročitajte je nakon povezanog događaja.
can_undo · yes_noTrenutna vrijednost odabranog stavka. Pročitajte je nakon povezanog događaja.
can_redo · yes_noTrenutna vrijednost odabranog stavka. Pročitajte je nakon povezanog događaja.
image_width · numberTrenutna vrijednost odabranog stavka. Pročitajte je nakon povezanog događaja.
image_height · numberTrenutna vrijednost odabranog stavka. Pročitajte je nakon povezanog događaja.
output_uri · textLokacija datoteke na ovom uređaju. Spremite ili učitajte datoteku zasebno ako mora ostati online.
output_width · numberTrenutna vrijednost odabranog stavka. Pročitajte je nakon povezanog događaja.
output_height · numberTrenutna vrijednost odabranog stavka. Pročitajte je nakon povezanog događaja.
output_bytes · numberTrenutna vrijednost odabranog stavka. Pročitajte je nakon povezanog događaja.
output_mime · textTrenutna vrijednost odabranog stavka. Pročitajte je nakon povezanog događaja.
error_code · textInformacije o pogrešci za posljednju radnju. Prikažite korisnu poruku i ponudite odgovarajući pokušaj ponovo.
crop_active · yes_noTrenutna vrijednost odabranog stavka. Pročitajte je nakon povezanog događaja.
crop_rect_json · textTrenutna vrijednost odabranog stavka. Pročitajte je nakon povezanog događaja.
Događaji
source_loadedKada se ovaj događaj dogodi, pročitajte povezane stanje iz istog elementa.
source_load_failedKada se ovaj događaj dogodi, pročitajte povezane stanje iz istog elementa.
edit_appliedKada se ovaj događaj dogodi, pročitajte povezane stanje iz istog elementa.
edit_undoneKada se ovaj događaj dogodi, pročitajte povezane stanje iz istog elementa.
edit_redoneKada se ovaj događaj dogodi, pročitajte povezane stanje iz istog elementa.
editor_resetKada se ovaj događaj dogodi, pročitajte povezane stanje iz istog elementa.
export_startedKada se ovaj događaj dogodi, pročitajte povezane stanje iz istog elementa.
export_completedKada se ovaj događaj dogodi, pročitajte povezane stanje iz istog elementa.
operation_cancelledKada se ovaj događaj dogodi, pročitajte povezane stanje iz istog elementa.
editor_errorKada se ovaj događaj dogodi, pročitajte povezane stanje iz istog elementa.
Pitanja koja programeri postavljaju
Je li output_uri Bubble datoteka?
Ne. To je lokalna putanja predmemorije. Održite je putem provjerenog lokalnog sprematelja ili učitača prije pohranjivanja reference na oblačnu datoteku.
Kako funkcionira pretplata?
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.
Povezani priručnici
Za pomoć, recite nam koji dodatak i uređaj koristite, koju radnju ste pokušali i što se dogodilo. Koristite primjer bez osobnih podataka. Nikada ne dijelite svoj ključ ili privatne datoteke.