Xodera Plugins · Bubble Native
Xodera Photo Editor Native
Pretvorite izbrano fotografijo v dosleden avatar, sliko izdelka ali priponko poročila. Obrežite, zavrtite in spremenite velikost, nato shranite izvozno kopijo v 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 november 2026
Praktični primeri
Dosledni avatarji profila pred nalaganjem
Uporabniki naj izberejo, kateri del njihove fotografije se prikaže v kvadratni sliki profila, namesto da sprejmejo naključni izrez.
`source_url = selected profile image`; `crop_aspect = "1:1"`; `document_context = the account’s stable reference`.
Počakajte na `source_loaded`; Begin crop → Apply crop, po potrebi z Rotate ali Undo. Ob izrecnem shranjevanju, Export image.
Le na `export_completed` uporabite `output_uri`, `output_width`, `output_height` in `output_mime` kot vhod v vaš postopek nalaganja datotek. Nato shranite trajno referenco v Profil.
Če uporabnik prekliče ali se `editor_error` sproži, obdržite star avatar. Po spremembi računa počistite sejo, da drugi uporabnik ne vidi osnutka.
Urejanje ustvari lokalno kopijo. Vaša aplikacija izbere, kako jo shraniti ali naložiti.
Pripravite dosledne fotografije za tržnico ali katalog
Različni okvirji in prevelike slike povzročajo neenakomeren katalog ter povečajo velikost nalaganja.
`source_url = selected item photo`; `crop_aspect = the app’s chosen ratio`; `export_max_dimension`, `export_format` in `export_quality` izvirajo iz vaše politike nalaganja.
Obrežite ustrezno območje, po želji Resize, nato Export image po potrditvi uporabnika. Izvirno datoteko/referenco shranite ločeno.
Preverite `output_width`, `output_height`, `output_bytes` in `output_mime`, preden vaš postopek nalaganja shrani rezultat. Shranite referenco nastale slike na element.
Če izvoz ne uspe ali rezultat krši vašo politiko nalaganja, prikažite `error_code` in dovolite uporabniku, da ga popravi. Pred potrditvijo nalaganja ne prepišite prejšnje slike elementa.
Urejanje ustvari lokalno kopijo. Vaša aplikacija izbere, kako jo shraniti ali naložiti.
Ustvarite osredotočeno kopijo slike za terensko poročilo
Tehnik morda potrebuje podrobno sliko enega poškodovanega dela, pri čemer ohrani izvirno sliko poročila.
`source_url = Current Report Photo’s source`; `document_context = the report/account reference`; razmerje obreza lahko ostane neomejeno.
Begin crop → Apply crop, nato uporabite Undo/Redo za primerjavo urejanj. Export image ustvari urejeno kopijo; vaša aplikacija vpraša, ali naj se ta kopija pripne k poročilu.
Uporabite `has_changes`, `can_undo`, `can_redo` in `output_uri`. Po uspešnem nalaganju shranite izvirne in urejene reference v ločena polja aplikacije.
Cancel crop ali Reset edits obnovi pot urejanja; preklic mora pustiti izvirno priponko poročila nespremenjeno.
Urejanje ustvari lokalno kopijo. Vaša aplikacija izbere, kako jo shraniti ali naložiti.
Kaj deluje zdaj
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.
Ustvarite delovni tok
Uporabite spodnje razpoložljive beta akcije in preizkusite rezultat na svojih ciljnih napravah.
Ti primeri uporabljajo zapise aplikacije, kot so Lesson, Message in Order. Zamenjajte jih s svojimi vrstami podatkov in imeni elementov. Primeri naslovov medijev je treba zamenjati s svojimi datotekami.
Nastavite source_url na izbrano sliko. Uporabite document_context za identifikacijo računa in zapisa, ki se ureja, tako da sprememba zapisa počisti prejšnjo fotografijo.
Po source_loaded zaženite Begin crop. Izberite 1:1 za avatar, prilagodite obrezovanje in uporabite Apply crop. Cancel crop pusti sliko nespremenjeno.
Po potrebi uporabite Rotate, Flip ali Resize. Undo in Redo premikata skozi dokončana urejanja; Reset edits obnovi izvirno sliko.
Zaženite Export image. Na export_completed preberite output_uri, output_width in output_height ter output_mime. Shranite ali naložite to kopijo z izbranim postopkom shranjevanja datotek, nato shranjeno datoteko shranite v zapis.
Nastavite enkrat
Aktivacija ključa je načrtovana za ta vtičnik. Ustvarite ali izberite svoj projekt aplikacije Bubble v BestPlugins → Dashboard → Plugins. Izberite Xodera Photo Editor Native, kopirajte njegov ključ, nato odprite Bubble → Plugins → Xodera Photo Editor Native in ga prilepite v licensing_api_key. Shranite enkrat; nato uporabite spodnja dejanja. Vsak vtičnik v vsakem projektu ima svoj ključ.
Najprej izberite ali zajemite sliko v aplikaciji. Uredniku posredujte nastali berljivi naslov slike. Dovoljenja za kamero in foto-knjižnico pripadajo izbirniku, ki ga uporabljate.
Nastavite enkrat
- Ustvarite ali izberite svoj projekt aplikacije Bubble pri BestPlugins → Dashboard → Plugins.
- Izberite ta vtičnik in kopirajte njegov ključ projekta.
- Open Bubble → Plugins → this plugin. Paste its project key into licensing_api_key and save.
- Dodajte element, izberite svoje podatke aplikacije in sestavite spodnji potek dela.
- 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.
Namestitev in naročnina
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.
Shrani rezultat v vašo aplikacijo
Shrani naloženo ali trajno shranjeno sliko v Profile.image ali v svoje polje priponke. output_uri je začasna datoteka na napravi, zato najprej shranite to datoteko s svojim izbranim delovnim tokom. Nato shranite output_width, output_height in output_mime kot metapodatke. Obdržite izvirno sliko, če potrebujete obe različici.
Napaka, preklic in obnovitev
Na source_load_failed ali editor_error prikažite error_code in ponudite Load source. Cancel operation preneha sprejemati nedokončan rezultat; počakajte do is_busy=no, preden začnete novo urejanje. Clear session počisti urejevalnik, ne pa slike, ki je že shranjena drugje.
Zmožnosti in omejitve
JPEG in PNG izvoz; kakovost 0–1; največja izhodna stran 1–4096 slikovnih pik. Vnos: do 15 MiB in 20 megapiks. Do 20 dokončanih urejanj. Možnosti obreza: prosto, 1:1, 4:3, 3:4 in 16:9. Brez vgrajene kamere, filtrov, besedilnih prekrivanj, korekcije perspektive, WebP izvoz ali samodejnega nalaganja.
Nastavitve, dejanja in rezultati
Uporabite ta imena v Bubble. Načrtovane funkcije so označene ločeno.
Razpoložljive beta nastavitve
Nastavitve 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 · textDogodki
source_loadedsource_load_failededit_appliededit_undoneedit_redoneeditor_resetexport_startedexport_completedoperation_cancellededitor_errorDejanja in njihovi vnosi
Load sourceBegin cropApply cropCancel cropRotateFlipResizeUndoRedoReset editsExport imageCancel operationClear sessionNastavitve elementa · 12
source_urltext · Privzeto: ""- Primer vrednosti
https://bestplugins.online/native-samples/avatar.jpg - Primer Bubble izraza
Selected Profile's image_url - Naslov izbrane zvočne, video ali slikovne datoteke. Uporabite vrsto datoteke, ki jo ta vtičnik podpira.
document_contexttext · Privzeto: ""- Primer vrednosti
<current-user-id> - Primer Bubble izraza
Current User's unique id - Stabilna vrednost za ta račun ali zapis. Uporabite isto vrednost pri obnovi njegovih shranjenih datotek ali osnutkov.
is_activeyes_no · Privzeto: true- Primer vrednosti
yes - Primer Bubble izraza
GuideHost's view_is_active (your yes/no custom state) - Nastavi da, ko je ta pogled odprt. Nastavi ne, ko zapuščate, da se predvajanje ali trenutno delo lahko ustavi.
disabledyes_no · Privzeto: false- Primer vrednosti
no - Primer Bubble izraza
GuideHost's is_busy (your yes/no custom state) - Onemogoči element, ko je vaša aplikacija zasedena ali ko je to dejanje nedostopno.
show_controlsyes_no · Privzeto: true- Primer vrednosti
yes - Primer Bubble izraza
App Settings' show_editor_controls - Prikaži ali skrij vgrajene kontrole.
crop_aspecttext · Privzeto: "free"- Primer vrednosti
1:1 - Primer Bubble izraza
Avatar Settings' crop_ratio - Uporabi vrednost trenutnega poslovnega zapisa; preveri jo glede na spodnje omejitve.
export_formattext · Privzeto: "jpeg"- Primer vrednosti
jpeg - Primer Bubble izraza
Format Dropdown's value - Uporabi vrednost trenutnega poslovnega zapisa; preveri jo glede na spodnje omejitve.
export_qualitynumber · Privzeto: 0.85- Primer vrednosti
0.85 - Primer Bubble izraza
Image Settings' quality - Uporabi vrednost trenutnega poslovnega zapisa; preveri jo glede na spodnje omejitve.
export_max_dimensionnumber · Privzeto: 2048- Primer vrednosti
2048 - Primer Bubble izraza
Image Settings' max_side - Uporabi vrednost trenutnega poslovnega zapisa; preveri jo glede na spodnje omejitve.
allow_upscaleyes_no · Privzeto: false- Primer vrednosti
no - Primer Bubble izraza
Allow upscale Checkbox is checked - Uporabi vrednost trenutnega poslovnega zapisa; preveri jo glede na spodnje omejitve.
ui_text_jsontext · Privzeto: ""- Primer vrednosti
{} - Primer Bubble izraza
App Settings' player_labels_json (supported keys only) - Izbirni JSON s podprtimi oznakami gumbov. Pustite prazno za uporabo vgrajenega besedila.
languagetext · Privzeto: "auto"- Primer vrednosti
uk - Primer Bubble izraza
Current User's preferred_language - Nastavite language=auto, da sledi podprti napravi ali jeziku brskalnika. Vnesite podprto kodo jezika, da ga izberete izrecno.
Dejanja in njihovi vnosi · 13
Load source
Ni parametrov dejanja
Begin crop
Ni parametrov dejanja
Apply crop
origin_xnumber · Privzeto: —- Primer vrednosti
0 - Primer Bubble izraza
Crop Settings' x (or omit all rectangle inputs) - Uporabi vrednost trenutnega poslovnega zapisa; preveri jo glede na spodnje omejitve.
origin_ynumber · Privzeto: —- Primer vrednosti
0 - Primer Bubble izraza
Crop Settings' y (or omit all rectangle inputs) - Uporabi vrednost trenutnega poslovnega zapisa; preveri jo glede na spodnje omejitve.
widthnumber · Privzeto: —- Primer vrednosti
512 - Primer Bubble izraza
Resize Width Input's value:converted to number - Uporabi vrednost trenutnega poslovnega zapisa; preveri jo glede na spodnje omejitve.
heightnumber · Privzeto: —- Primer vrednosti
512 - Primer Bubble izraza
Resize Height Input's value:converted to number - Uporabi vrednost trenutnega poslovnega zapisa; preveri jo glede na spodnje omejitve.
Cancel crop
Ni parametrov dejanja
Rotate
degreesnumber · Privzeto: —- Primer vrednosti
90 - Primer Bubble izraza
Rotation Dropdown's value - Uporabi vrednost trenutnega poslovnega zapisa; preveri jo glede na spodnje omejitve.
Flip
axistext · Privzeto: —- Primer vrednosti
horizontal - Primer Bubble izraza
Flip Direction Dropdown's value - Uporabi vrednost trenutnega poslovnega zapisa; preveri jo glede na spodnje omejitve.
Resize
widthnumber · Privzeto: —- Primer vrednosti
512 - Primer Bubble izraza
Resize Width Input's value:converted to number - Uporabi vrednost trenutnega poslovnega zapisa; preveri jo glede na spodnje omejitve.
heightnumber · Privzeto: —- Primer vrednosti
512 - Primer Bubble izraza
Resize Height Input's value:converted to number - Uporabi vrednost trenutnega poslovnega zapisa; preveri jo glede na spodnje omejitve.
Undo
Ni parametrov dejanja
Redo
Ni parametrov dejanja
Reset edits
Ni parametrov dejanja
Export image
Ni parametrov dejanja
Cancel operation
Ni parametrov dejanja
Clear session
Ni parametrov dejanja
Stanja in dogodki
Stanja
editor_status · textTrenutni rezultat tega dejanja. Uporabite ustrezen dogodek dokončanja pred shranjevanjem uspeha.
is_busy · yes_noDelo je še v teku. Počakajte, preden začnete drugo dejanje.
has_image · yes_noTrenutna vrednost za izbrani element. Preberite jo po povezanem dogodku.
has_changes · yes_noTrenutna vrednost za izbrani element. Preberite jo po povezanem dogodku.
can_undo · yes_noTrenutna vrednost za izbrani element. Preberite jo po povezanem dogodku.
can_redo · yes_noTrenutna vrednost za izbrani element. Preberite jo po povezanem dogodku.
image_width · numberTrenutna vrednost za izbrani element. Preberite jo po povezanem dogodku.
image_height · numberTrenutna vrednost za izbrani element. Preberite jo po povezanem dogodku.
output_uri · textLokacija datoteke na tej napravi. Shranite ali naložite datoteko ločeno, če jo je treba obdržati na spletu.
output_width · numberTrenutna vrednost za izbrani element. Preberite jo po povezanem dogodku.
output_height · numberTrenutna vrednost za izbrani element. Preberite jo po povezanem dogodku.
output_bytes · numberTrenutna vrednost za izbrani element. Preberite jo po povezanem dogodku.
output_mime · textTrenutna vrednost za izbrani element. Preberite jo po povezanem dogodku.
error_code · textPodatki o napaki za zadnje dejanje. Prikažite koristno sporočilo in ponudite ustrezen ponovni poskus.
crop_active · yes_noTrenutna vrednost za izbrani element. Preberite jo po povezanem dogodku.
crop_rect_json · textTrenutna vrednost za izbrani element. Preberite jo po povezanem dogodku.
Dogodki
source_loadedKo se ta dogodek zgodi, preberite povezane stanje iz istega elementa.
source_load_failedKo se ta dogodek zgodi, preberite povezane stanje iz istega elementa.
edit_appliedKo se ta dogodek zgodi, preberite povezane stanje iz istega elementa.
edit_undoneKo se ta dogodek zgodi, preberite povezane stanje iz istega elementa.
edit_redoneKo se ta dogodek zgodi, preberite povezane stanje iz istega elementa.
editor_resetKo se ta dogodek zgodi, preberite povezane stanje iz istega elementa.
export_startedKo se ta dogodek zgodi, preberite povezane stanje iz istega elementa.
export_completedKo se ta dogodek zgodi, preberite povezane stanje iz istega elementa.
operation_cancelledKo se ta dogodek zgodi, preberite povezane stanje iz istega elementa.
editor_errorKo se ta dogodek zgodi, preberite povezane stanje iz istega elementa.
Vprašanja, ki jih postavljajo razvijalci
Ali je output_uri datoteka Bubble?
Ne. Gre za lokalno predpomnilniško pot. Ohranite jo prek preverjenega lokalnega shranjevalnika ali nalagalnika, preden shranite referenco na oblačno datoteko.
Kako deluje naročnina?
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 vodniki
Za pomoč nam povejte, kateri vtičnik in napravo uporabljate, kakšno dejanje ste poskusili in kaj se je zgodilo. Uporabite primer brez osebnih podatkov. Nikoli ne delite svojega ključa ali zasebnih datotek.