Xodera Plugins · Bubble Native
Xodera Photo Editor Native
Muunna valittu valokuva yhtenäiseksi avatariksi, tuotekuvaksi tai raportin liitteeksi. Rajaa, kierrä ja muuta sen kokoa, ja tallenna sitten viety kopio sovellukseesi.
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.
Dokumentaatio tarkistettu 6 marraskuussa 2026
Käytännön esimerkit
Yhtenäiset profiilikuvat ennen latausta
Käyttäjien tulisi valita, mikä osa heidän valokuvastaan näkyy neliön muotoisessa profiilikuvassa, sen sijaan että hyväksyttäisiin satunnainen rajaus.
`source_url = selected profile image`; `crop_aspect = "1:1"`; `document_context = the account’s stable reference`.
Odota `source_loaded`; Begin crop → Apply crop, tarvittaessa Rotate tai Undo. Kun tallennetaan eksplisiittisesti, Export image.
Vain `export_completed`:n yhteydessä käytä `output_uri`, `output_width`, `output_height` ja `output_mime` syötteinä tiedostonlähetystyönkulussasi. Tallenna sen kestävä viite profiiliin sen jälkeen.
Jos käyttäjä peruuttaa tai `editor_error` käynnistyy, pidä vanha avatar. Tyhjennä istunto tilin vaihdon yhteydessä, jotta toinen käyttäjä ei näe luonnosta.
Muokkaus luo paikallisen kopion. Sovelluksesi valitsee, miten se tallennetaan tai lähetetään.
Valmistele yhtenäiset markkinapaikka- tai luettelokuvia
Eri sommittelu ja liian suuret kuvat tekevät luettelosta epätasaisen ja lisäävät latauskokoa.
`source_url = selected item photo`; `crop_aspect = the app’s chosen ratio`; `export_max_dimension`, `export_format` ja `export_quality` tulevat latauskäytännöstäsi.
Rajaa relevantti alue, valinnaisesti Resize, ja sitten Export image käyttäjän vahvistettuaan. Säilytä alkuperäinen tiedosto/viite erikseen.
Tarkista `output_width`, `output_height`, `output_bytes` ja `output_mime` ennen kuin lataustyönkulku tallentaa tuloksen. Tallenna syntynyt kuvan viite kohteeseen.
Jos vienti epäonnistuu tai tulos rikkoo latauskäytäntöäsi, näytä `error_code` ja anna käyttäjän muokata sitä. Älä korvaa edellistä kohteen kuvaa ennen latausvahvistusta.
Muokkaus luo paikallisen kopion. Sovelluksesi valitsee, miten se tallennetaan tai lähetetään.
Luo tarkennettu kuvakopio kenttäraporttia varten
Teknikko saattaa tarvita lähikuvan yhdestä vaurioituneesta osasta säilyttäen alkuperäisen raporttikuvan.
`source_url = Current Report Photo’s source`; `document_context = the report/account reference`; rajauskuvasuhde voi olla rajoittamaton.
Begin crop → Apply crop, sitten käytä Undo/Redo vertailuun. Export image luo muokatun kopion; sovelluksesi kysyy, liitetäänkö kopio raporttiin.
Käytä `has_changes`, `can_undo`, `can_redo` ja `output_uri`. Tallenna alkuperäinen ja muokattu viite erillisiin sovelluskenttiin onnistuneen latauksen jälkeen.
Cancel crop tai Reset edits palauttaa muokkauspolun; peruutuksen on jätettävä alkuperäinen Raportin liite muuttumattomaksi.
Muokkaus luo paikallisen kopion. Sovelluksesi valitsee, miten se tallennetaan tai lähetetään.
Mikä toimii nyt
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.
Rakenna työnkulku
Käytä alla olevia saatavilla olevia beta‑toimintoja ja testaa tulosta kohdelaitteillasi.
Nämä esimerkit käyttävät sovellustietueita, kuten Lesson, Message ja Order. Korvaa ne omilla tietotyypeilläsi ja elementtien nimillä. Esimerkkimediaosoitteet on korvattava omilla tiedostoillasi.
Aseta source_url valittuun kuvaan. Käytä document_context tunnistamaan muokattava tili ja tietue, jolloin tietueen vaihtaminen tyhjentää edellisen valokuvan.
source_loaded:n jälkeen suorita Begin crop. Valitse 1:1 avatariksi, säädä rajaus ja käytä Apply crop. Cancel crop jättää kuvan muuttumattomaksi.
Käytä Rotate:ää, Flip:ää tai Resize:ää tarvittaessa. Undo ja Redo siirtyvät valmistuneiden muokkausten läpi; Reset edits palauttaa alkuperäisen kuvan.
Suorita Export image. export_completed:n yhteydessä lue output_uri, output_width, output_height ja output_mime. Tallenna tai lähetä kopio käyttämällä valitsemaasi tiedostotallennustyönkulkua, ja tallenna sitten tallennettu tiedosto tietueeseen.
Määritä kerran
Avaimen aktivointi on suunniteltu tälle liitännäiselle. Luo tai valitse Bubble-sovellusprojektisi BestPlugins → Dashboard → Plugins. Valitse Xodera Photo Editor Native, kopioi sen avain, avaa sitten Bubble → Plugins → Xodera Photo Editor Native ja liitä se licensing_api_key:een. Tallenna kerran; sen jälkeen käytä alla olevia toimintoja. Jokaisella liitännäisellä jokaisessa projektissa on oma avain.
Valitse tai tallenna kuva ensin sovelluksellasi. Anna editorille syntynyt luettavissa oleva kuvan osoite. Kameran ja valokuvakirjaston käyttöoikeudet kuuluvat käyttämällesi valitsijalle.
Määritä kerran
- Luo tai valitse Bubble‑sovellusprojekti BestPlugins → Dashboard → Plugins.
- Valitse tämä liitännäinen ja kopioi sen projektin avain.
- Open Bubble → Plugins → this plugin. Paste its project key into licensing_api_key and save.
- Lisää elementti, valitse sovellustietosi ja rakenna alla oleva työnkulku.
- 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.
Asennus ja tilaus
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.
Tallenna tulos sovellukseesi
Tallenna ladattu tai pysyvästi tallennettu kuva Profile.image:iin tai liitekenttääsi. output_uri on laitteella väliaikainen tiedosto, joten tallenna se ensin valitsemallasi työnkululla. Tallenna sen jälkeen output_width, output_height ja output_mime metatietoina. Säilytä alkuperäinen kuva, jos tarvitset molemmat versiot.
Epäonnistuminen, peruutus ja palautus
source_load_failed:ssä tai editor_error:ssä näytä error_code ja tarjoa Load source. Cancel operation lopettaa keskeneräisen tuloksen vastaanottamisen; odota is_busy=no:een ennen kuin aloitat toisen muokkauksen. Clear session tyhjentää editorin, ei jo muualla tallennettua kuvaa.
Ominaisuudet ja rajoitukset
JPEG ja PNG vienti; laatu 0–1; suurin ulostulopuoli 1–4096 pikseliä. Syöte: enintään 15 MiB ja 20 megapikseliä. Enintään 20 valmistunutta muokkausta. Rajausvaihtoehdot: vapaa, 1:1, 4:3, 3:4 ja 16:9. Ei sisäänrakennettua kameraa, suodattimia, tekstikerroksia, perspektiivikorjausta, WebP-vientiä tai automaattista latausta.
Asetukset, toiminnot ja tulokset
Käytä näitä nimiä Bubble:ssa. Suunnitellut ominaisuudet on merkitty erikseen.
Käytettävissä olevat beta-asetukset
Elementin asetukset
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 · textTilat
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 · textTapahtumat
source_loadedsource_load_failededit_appliededit_undoneedit_redoneeditor_resetexport_startedexport_completedoperation_cancellededitor_errorToiminnot ja niiden syötteet
Load sourceBegin cropApply cropCancel cropRotateFlipResizeUndoRedoReset editsExport imageCancel operationClear sessionElementin asetukset · 12
source_urltext · Oletus: ""- Esimerkkisarvo
https://bestplugins.online/native-samples/avatar.jpg - Esimerkki Bubble -lauseke
Selected Profile's image_url - Valitun ääni-, video- tai kuvatiedoston osoite. Käytä tiedostotyyppiä, jota tämä liitännäinen tukee.
document_contexttext · Oletus: ""- Esimerkkisarvo
<current-user-id> - Esimerkki Bubble -lauseke
Current User's unique id - Vakaa arvo tälle tilille tai tietueelle. Käytä samaa arvoa sen tallennettujen tiedostojen tai luonnosten palauttamisessa.
is_activeyes_no · Oletus: true- Esimerkkisarvo
yes - Esimerkki Bubble -lauseke
GuideHost's view_is_active (your yes/no custom state) - Aseta kyllä, kun tämä näkymä on auki. Aseta ei, kun poistutaan, jotta toisto tai nykyinen työ voi pysähtyä.
disabledyes_no · Oletus: false- Esimerkkisarvo
no - Esimerkki Bubble -lauseke
GuideHost's is_busy (your yes/no custom state) - Poista elementti käytöstä, kun sovelluksesi on kiireinen tai tämä toiminto ei ole saatavilla.
show_controlsyes_no · Oletus: true- Esimerkkisarvo
yes - Esimerkki Bubble -lauseke
App Settings' show_editor_controls - Näytä tai piilota sisäänrakennetut ohjaimet.
crop_aspecttext · Oletus: "free"- Esimerkkisarvo
1:1 - Esimerkki Bubble -lauseke
Avatar Settings' crop_ratio - Käytä nykyisen liiketoimintatietueen arvoa; tarkista se alla olevia rajoja vastaan.
export_formattext · Oletus: "jpeg"- Esimerkkisarvo
jpeg - Esimerkki Bubble -lauseke
Format Dropdown's value - Käytä nykyisen liiketoimintatietueen arvoa; tarkista se alla olevia rajoja vastaan.
export_qualitynumber · Oletus: 0.85- Esimerkkisarvo
0.85 - Esimerkki Bubble -lauseke
Image Settings' quality - Käytä nykyisen liiketoimintatietueen arvoa; tarkista se alla olevia rajoja vastaan.
export_max_dimensionnumber · Oletus: 2048- Esimerkkisarvo
2048 - Esimerkki Bubble -lauseke
Image Settings' max_side - Käytä nykyisen liiketoimintatietueen arvoa; tarkista se alla olevia rajoja vastaan.
allow_upscaleyes_no · Oletus: false- Esimerkkisarvo
no - Esimerkki Bubble -lauseke
Allow upscale Checkbox is checked - Käytä nykyisen liiketoimintatietueen arvoa; tarkista se alla olevia rajoja vastaan.
ui_text_jsontext · Oletus: ""- Esimerkkisarvo
{} - Esimerkki Bubble -lauseke
App Settings' player_labels_json (supported keys only) - Valinnainen JSON tuetuilla painikkeen teksteillä. Jätä tyhjäksi käyttääksesi sisäänrakennettua tekstiä.
languagetext · Oletus: "auto"- Esimerkkisarvo
uk - Esimerkki Bubble -lauseke
Current User's preferred_language - Aseta language=auto seuraamaan tuettua laitetta tai selaimen kieltä. Syötä tuettu kielikoodi valitaksesi sen eksplisiittisesti.
Toiminnot ja niiden syötteet · 13
Load source
Ei toiminto‑parametreja
Begin crop
Ei toiminto‑parametreja
Apply crop
origin_xnumber · Oletus: —- Esimerkkisarvo
0 - Esimerkki Bubble -lauseke
Crop Settings' x (or omit all rectangle inputs) - Käytä nykyisen liiketoimintatietueen arvoa; tarkista se alla olevia rajoja vastaan.
origin_ynumber · Oletus: —- Esimerkkisarvo
0 - Esimerkki Bubble -lauseke
Crop Settings' y (or omit all rectangle inputs) - Käytä nykyisen liiketoimintatietueen arvoa; tarkista se alla olevia rajoja vastaan.
widthnumber · Oletus: —- Esimerkkisarvo
512 - Esimerkki Bubble -lauseke
Resize Width Input's value:converted to number - Käytä nykyisen liiketoimintatietueen arvoa; tarkista se alla olevia rajoja vastaan.
heightnumber · Oletus: —- Esimerkkisarvo
512 - Esimerkki Bubble -lauseke
Resize Height Input's value:converted to number - Käytä nykyisen liiketoimintatietueen arvoa; tarkista se alla olevia rajoja vastaan.
Cancel crop
Ei toiminto‑parametreja
Rotate
degreesnumber · Oletus: —- Esimerkkisarvo
90 - Esimerkki Bubble -lauseke
Rotation Dropdown's value - Käytä nykyisen liiketoimintatietueen arvoa; tarkista se alla olevia rajoja vastaan.
Flip
axistext · Oletus: —- Esimerkkisarvo
horizontal - Esimerkki Bubble -lauseke
Flip Direction Dropdown's value - Käytä nykyisen liiketoimintatietueen arvoa; tarkista se alla olevia rajoja vastaan.
Resize
widthnumber · Oletus: —- Esimerkkisarvo
512 - Esimerkki Bubble -lauseke
Resize Width Input's value:converted to number - Käytä nykyisen liiketoimintatietueen arvoa; tarkista se alla olevia rajoja vastaan.
heightnumber · Oletus: —- Esimerkkisarvo
512 - Esimerkki Bubble -lauseke
Resize Height Input's value:converted to number - Käytä nykyisen liiketoimintatietueen arvoa; tarkista se alla olevia rajoja vastaan.
Undo
Ei toiminto‑parametreja
Redo
Ei toiminto‑parametreja
Reset edits
Ei toiminto‑parametreja
Export image
Ei toiminto‑parametreja
Cancel operation
Ei toiminto‑parametreja
Clear session
Ei toiminto‑parametreja
Tilat ja tapahtumat
Tilat
editor_status · textTämän toiminnon nykyinen tulos. Käytä vastaavaa valmistumistapahtumaa ennen onnistuneen tallennuksen tekemistä.
is_busy · yes_noTyö on vielä kesken. Odota ennen kuin aloitat toisen toiminnon.
has_image · yes_noValitun kohteen nykyinen arvo. Lue se liittyvän tapahtuman jälkeen.
has_changes · yes_noValitun kohteen nykyinen arvo. Lue se liittyvän tapahtuman jälkeen.
can_undo · yes_noValitun kohteen nykyinen arvo. Lue se liittyvän tapahtuman jälkeen.
can_redo · yes_noValitun kohteen nykyinen arvo. Lue se liittyvän tapahtuman jälkeen.
image_width · numberValitun kohteen nykyinen arvo. Lue se liittyvän tapahtuman jälkeen.
image_height · numberValitun kohteen nykyinen arvo. Lue se liittyvän tapahtuman jälkeen.
output_uri · textTiedoston sijainti tällä laitteella. Tallenna tai lataa tiedosto erikseen, jos se on pidettävä verkossa.
output_width · numberValitun kohteen nykyinen arvo. Lue se liittyvän tapahtuman jälkeen.
output_height · numberValitun kohteen nykyinen arvo. Lue se liittyvän tapahtuman jälkeen.
output_bytes · numberValitun kohteen nykyinen arvo. Lue se liittyvän tapahtuman jälkeen.
output_mime · textValitun kohteen nykyinen arvo. Lue se liittyvän tapahtuman jälkeen.
error_code · textViimeisen toiminnon virhetiedot. Näytä hyödyllinen viesti ja tarjoa asiaankuuluva uudelleenyritys.
crop_active · yes_noValitun kohteen nykyinen arvo. Lue se liittyvän tapahtuman jälkeen.
crop_rect_json · textValitun kohteen nykyinen arvo. Lue se liittyvän tapahtuman jälkeen.
Tapahtumat
source_loadedKun tämä tapahtuma tapahtuu, lue siihen liittyvät tilat samasta elementistä.
source_load_failedKun tämä tapahtuma tapahtuu, lue siihen liittyvät tilat samasta elementistä.
edit_appliedKun tämä tapahtuma tapahtuu, lue siihen liittyvät tilat samasta elementistä.
edit_undoneKun tämä tapahtuma tapahtuu, lue siihen liittyvät tilat samasta elementistä.
edit_redoneKun tämä tapahtuma tapahtuu, lue siihen liittyvät tilat samasta elementistä.
editor_resetKun tämä tapahtuma tapahtuu, lue siihen liittyvät tilat samasta elementistä.
export_startedKun tämä tapahtuma tapahtuu, lue siihen liittyvät tilat samasta elementistä.
export_completedKun tämä tapahtuma tapahtuu, lue siihen liittyvät tilat samasta elementistä.
operation_cancelledKun tämä tapahtuma tapahtuu, lue siihen liittyvät tilat samasta elementistä.
editor_errorKun tämä tapahtuma tapahtuu, lue siihen liittyvät tilat samasta elementistä.
Kysymykset, joita kehittäjät esittävät
Onko output_uri Bubble‑tiedosto?
Ei. Se on paikallinen välimuistipolku. Säilytä se luotettavan paikallisen tallentajan tai lähettäjän kautta ennen pilvitiedostoviitteen tallentamista.
Miten tilaus toimii?
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.
Aiheeseen liittyvät oppaat
Avun saamiseksi kerro, mitä lisäosaa ja laitetta käytät, mitä toimintoa yritit ja mitä tapahtui. Käytä esimerkkiä ilman henkilötietoja. Älä koskaan jaa avaintasi tai yksityisiä tiedostoja.