Xodera Plugins · Bubble Native
Xodera Photo Editor Native
Paverkite pasirinktą nuotrauką nuosekliu avataru, produkto nuotrauka arba ataskaitos priedu. Apkirpkite, pasukite ir pakeiskite jos dydį, tada išsaugokite eksportuotą kopiją programoje.
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 peržiūrėta 6 lapkričio 2026
Praktiniai pavyzdžiai
Nuoseklūs profilio avatarai prieš įkėlimą
Vartotojai turėtų pasirinkti, kuri nuotraukos dalis bus rodomi kvadratinėje profilio nuotraukoje, o ne priimti atsitiktinį apkarpymą.
`source_url = selected profile image`; `crop_aspect = "1:1"`; `document_context = the account’s stable reference`.
Palaukite `source_loaded`; Begin crop → Apply crop, kai reikia, naudokite Rotate arba Undo. Pasirinkus Išsaugoti, Export image.
Tik `export_completed` metu naudokite `output_uri`, `output_width`, `output_height` ir `output_mime` kaip įvestis į failų įkėlimo procesą. Vėliau išsaugokite jo patikimą nuorodą profilyje.
Jei vartotojas atšaukia arba `editor_error` įvyksta, išlaikykite seną avatarą. Išvalykite sesiją keičiant paskyrą, kad kitas vartotojas nematytų juodraščio.
Redagavimas sukuria vietinę kopiją. Jūsų programa pasirenka, kaip ją išsaugoti arba įkelti.
Paruoškite nuoseklias rinkos ar katalogo nuotraukas
Skirtingas rėminimas ir per didelės nuotraukos sukelia nelygų katalogą ir padidina įkėlimo dydį.
`source_url = selected item photo`; `crop_aspect = the app’s chosen ratio`; `export_max_dimension`, `export_format` ir `export_quality` kyla iš jūsų įkėlimo politikos.
Apkirpkite atitinkamą sritį, pasirinktinai Resize, tada Export image po vartotojo patvirtinimo. Laikykite originalų failą/nuorodą atskirai.
Patikrinkite `output_width`, `output_height`, `output_bytes` ir `output_mime` prieš įkėlimo procesą išsaugant rezultatą. Išsaugokite gautos nuotraukos nuorodą elemente.
Jei eksportas nepavyksta arba rezultatas pažeidžia jūsų įkėlimo politiką, parodykite `error_code` ir leiskite vartotojui jį pataisyti. Neperrašykite ankstesnio elemento vaizdo prieš įkėlimo patvirtinimą.
Redagavimas sukuria vietinę kopiją. Jūsų programa pasirenka, kaip ją išsaugoti arba įkelti.
Sukurkite fokusuotą vaizdo kopiją lauko ataskaitai
Technikas gali reikėti artimo nuotraukos vienos pažeistos dalies, išlaikant originalų ataskaitos vaizdą.
`source_url = Current Report Photo’s source`; `document_context = the report/account reference`; apkirpimo santykis gali likti neribotas.
Begin crop → Apply crop, tada naudokite Undo/Redo redagavimų palyginimui. Export image sukuria redaguotą kopiją; jūsų programa klausia, ar prijungti tą kopiją prie ataskaitos.
Naudokite `has_changes`, `can_undo`, `can_redo` ir `output_uri`. Išsaugokite originalias ir redaguotas nuorodas atskiruose programos laukuose po sėkmingo įkėlimo.
Cancel crop arba Reset edits atkuria redagavimo kelią; atšaukimas turi palikti originalų Report priedą nepakeistą.
Redagavimas sukuria vietinę kopiją. Jūsų programa pasirenka, kaip ją išsaugoti arba įkelti.
Kas veikia dabar
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.
Sukurkite darbo srautą
Naudokite žemiau pateiktas prieinamas beta veiksmus ir išbandykite rezultatą savo tiksliniuose įrenginiuose.
Šie pavyzdžiai naudoja programos įrašus, tokius kaip Lesson, Message ir Order. Pakeiskite juos savo duomenų tipais ir elementų pavadinimais. Pavyzdiniai medijos adresai turi būti pakeisti jūsų failais.
Nustatykite source_url į pasirinktą vaizdą. Naudokite document_context, kad identifikuotumėte redaguojamą paskyrą ir įrašą, todėl įrašo keitimas išvalo ankstesnę nuotrauką.
Po source_loaded vykdykite Begin crop. Pasirinkite 1:1 avatarui, pakoreguokite apkirpimą ir naudokite Apply crop. Cancel crop palieka vaizdą nepakeistą.
Naudokite Rotate, Flip arba Resize, jei reikia. Undo ir Redo perkelia per baigtus redagavimus; Reset edits atkuria originalų vaizdą.
Vykdykite Export image. export_completed atveju perskaitykite output_uri, output_width, output_height ir output_mime. Išsaugokite arba įkelkite šią kopiją naudodami pasirinktą failų saugojimo procesą, tada įrašykite išsaugotą failą į įrašą.
Konfigūruokite vieną kartą
Raktų aktyvavimas šiam papildiniui planuojamas. Sukurkite arba pasirinkite savo Bubble programos projektą BestPlugins → Dashboard → Plugins. Pasirinkite Xodera Photo Editor Native, nukopijuokite jo raktą, tada atidarykite Bubble → Plugins → Xodera Photo Editor Native ir įklijuokite jį į licensing_api_key. Išsaugokite vieną kartą; tada naudokite žemiau esančius veiksmus. Kiekvienas papildinys kiekviename projekte turi savo raktą.
Pirma pasirinkite arba nufotografuokite vaizdą savo programoje. Pateikite redaktoriui gautą skaitomą vaizdo adresą. Kameros ir nuotraukų bibliotekos leidimai priklauso naudojamam pasirinkikliui.
Konfigūruokite vieną kartą
- Sukurkite arba pasirinkite savo Bubble programos projektą BestPlugins → Dashboard → Plugins.
- Pasirinkite šį įskiepį ir nukopijuokite jo projekto raktą.
- Open Bubble → Plugins → this plugin. Paste its project key into licensing_api_key and save.
- Pridėkite elementą, pasirinkite savo programos duomenis ir sukurkite žemiau esantį darbo srautą.
- 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.
Įdiegimas ir prenumerata
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.
Išsaugokite rezultatą savo programoje
Išsaugokite įkeltą arba nuolatinį vaizdą Profile.image arba savo priedo lauke. output_uri yra laikinas failas įrenginyje, todėl pirmiausia išsaugokite tą failą pasirinktu būdu. Tada saugokite output_width, output_height ir output_mime kaip metaduomenis. Laikykite originalų vaizdą, jei reikia abiejų versijų.
Gedimas, atšaukimas ir atkūrimas
source_load_failed arba editor_error atveju rodykite error_code ir siūlykite Load source. Cancel operation nepriima nebaigto rezultato; lauktite iki is_busy=no prieš pradėdami kitą redagavimą. Clear session išvalo redaktorių, ne jau kitur išsaugotą vaizdą.
Galimybės ir apribojimai
JPEG ir PNG eksportuoja; kokybė 0–1; maksimalus išvesties kraštas 1–4096 pikseliai. Įvestis: iki 15 MiB ir 20 megapikseliai. Iki 20 baigtų redagavimų. Apkirpimo pasirinkimai: laisvas, 1:1, 4:3, 3:4 ir 16:9. Nėra integruotos kameros, filtrų, teksto perdangų, perspektyvos korekcijos, WebP eksporto ar automatinio įkėlimo.
Nustatymai, veiksmai ir rezultatai
Naudokite šiuos pavadinimus Bubble. Planuojamos funkcijos pažymėtos atskirai.
Prieinami beta nustatymai
Elemento nustatymai
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 · textBūsenos
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 · textĮvykiai
source_loadedsource_load_failededit_appliededit_undoneedit_redoneeditor_resetexport_startedexport_completedoperation_cancellededitor_errorVeiksmai ir jų įvestys
Load sourceBegin cropApply cropCancel cropRotateFlipResizeUndoRedoReset editsExport imageCancel operationClear sessionElemento nustatymai · 12
source_urltext · Numatytasis: ""- Pavyzdinė reikšmė
https://bestplugins.online/native-samples/avatar.jpg - Pavyzdinis Bubble išraiška
Selected Profile's image_url - Pasirinkto garso, vaizdo arba paveikslėlio failo adresas. Naudokite šio įskiepio palaikomą failo tipą.
document_contexttext · Numatytasis: ""- Pavyzdinė reikšmė
<current-user-id> - Pavyzdinis Bubble išraiška
Current User's unique id - Stabili vertė šiai paskyrai arba įrašui. Naudokite tą pačią vertę atkurdami išsaugotus failus arba juodraščius.
is_activeyes_no · Numatytasis: true- Pavyzdinė reikšmė
yes - Pavyzdinis Bubble išraiška
GuideHost's view_is_active (your yes/no custom state) - Nustatykite taip, kai šis vaizdas atvertas. Nustatykite ne, kai išeinate, kad atkūrimas arba dabartinis darbas galėtų sustoti.
disabledyes_no · Numatytasis: false- Pavyzdinė reikšmė
no - Pavyzdinis Bubble išraiška
GuideHost's is_busy (your yes/no custom state) - Išjunkite elementą, kai programa užimta arba šis veiksmas neprieinamas.
show_controlsyes_no · Numatytasis: true- Pavyzdinė reikšmė
yes - Pavyzdinis Bubble išraiška
App Settings' show_editor_controls - Rodyti arba slėpti įmontuotas valdikles.
crop_aspecttext · Numatytasis: "free"- Pavyzdinė reikšmė
1:1 - Pavyzdinis Bubble išraiška
Avatar Settings' crop_ratio - Naudokite dabartinio verslo įrašo reikšmę; patikrinkite ją pagal žemiau pateiktas ribas.
export_formattext · Numatytasis: "jpeg"- Pavyzdinė reikšmė
jpeg - Pavyzdinis Bubble išraiška
Format Dropdown's value - Naudokite dabartinio verslo įrašo reikšmę; patikrinkite ją pagal žemiau pateiktas ribas.
export_qualitynumber · Numatytasis: 0.85- Pavyzdinė reikšmė
0.85 - Pavyzdinis Bubble išraiška
Image Settings' quality - Naudokite dabartinio verslo įrašo reikšmę; patikrinkite ją pagal žemiau pateiktas ribas.
export_max_dimensionnumber · Numatytasis: 2048- Pavyzdinė reikšmė
2048 - Pavyzdinis Bubble išraiška
Image Settings' max_side - Naudokite dabartinio verslo įrašo reikšmę; patikrinkite ją pagal žemiau pateiktas ribas.
allow_upscaleyes_no · Numatytasis: false- Pavyzdinė reikšmė
no - Pavyzdinis Bubble išraiška
Allow upscale Checkbox is checked - Naudokite dabartinio verslo įrašo reikšmę; patikrinkite ją pagal žemiau pateiktas ribas.
ui_text_jsontext · Numatytasis: ""- Pavyzdinė reikšmė
{} - Pavyzdinis Bubble išraiška
App Settings' player_labels_json (supported keys only) - Pasirenkamas JSON su palaikomais mygtukų etiketėmis. Palikite tuščią, kad naudotumėte įdiegtą tekstą.
languagetext · Numatytasis: "auto"- Pavyzdinė reikšmė
uk - Pavyzdinis Bubble išraiška
Current User's preferred_language - Nustatykite language=auto sekti palaikomą įrenginį arba naršyklės kalbą. Įveskite palaikomą kalbos kodą, kad pasirinktumėte ją tiesiogiai.
Veiksmai ir jų įvestys · 13
Load source
Nėra veiksmų parametrų
Begin crop
Nėra veiksmų parametrų
Apply crop
origin_xnumber · Numatytasis: —- Pavyzdinė reikšmė
0 - Pavyzdinis Bubble išraiška
Crop Settings' x (or omit all rectangle inputs) - Naudokite dabartinio verslo įrašo reikšmę; patikrinkite ją pagal žemiau pateiktas ribas.
origin_ynumber · Numatytasis: —- Pavyzdinė reikšmė
0 - Pavyzdinis Bubble išraiška
Crop Settings' y (or omit all rectangle inputs) - Naudokite dabartinio verslo įrašo reikšmę; patikrinkite ją pagal žemiau pateiktas ribas.
widthnumber · Numatytasis: —- Pavyzdinė reikšmė
512 - Pavyzdinis Bubble išraiška
Resize Width Input's value:converted to number - Naudokite dabartinio verslo įrašo reikšmę; patikrinkite ją pagal žemiau pateiktas ribas.
heightnumber · Numatytasis: —- Pavyzdinė reikšmė
512 - Pavyzdinis Bubble išraiška
Resize Height Input's value:converted to number - Naudokite dabartinio verslo įrašo reikšmę; patikrinkite ją pagal žemiau pateiktas ribas.
Cancel crop
Nėra veiksmų parametrų
Rotate
degreesnumber · Numatytasis: —- Pavyzdinė reikšmė
90 - Pavyzdinis Bubble išraiška
Rotation Dropdown's value - Naudokite dabartinio verslo įrašo reikšmę; patikrinkite ją pagal žemiau pateiktas ribas.
Flip
axistext · Numatytasis: —- Pavyzdinė reikšmė
horizontal - Pavyzdinis Bubble išraiška
Flip Direction Dropdown's value - Naudokite dabartinio verslo įrašo reikšmę; patikrinkite ją pagal žemiau pateiktas ribas.
Resize
widthnumber · Numatytasis: —- Pavyzdinė reikšmė
512 - Pavyzdinis Bubble išraiška
Resize Width Input's value:converted to number - Naudokite dabartinio verslo įrašo reikšmę; patikrinkite ją pagal žemiau pateiktas ribas.
heightnumber · Numatytasis: —- Pavyzdinė reikšmė
512 - Pavyzdinis Bubble išraiška
Resize Height Input's value:converted to number - Naudokite dabartinio verslo įrašo reikšmę; patikrinkite ją pagal žemiau pateiktas ribas.
Undo
Nėra veiksmų parametrų
Redo
Nėra veiksmų parametrų
Reset edits
Nėra veiksmų parametrų
Export image
Nėra veiksmų parametrų
Cancel operation
Nėra veiksmų parametrų
Clear session
Nėra veiksmų parametrų
Būsenos ir įvykiai
Būsenos
editor_status · textDabartinis šio veiksmo rezultatas. Naudokite atitinkamą užbaigimo įvykį prieš išsaugant sėkmę.
is_busy · yes_noDarbas vis dar vykdomas. Palaukite prieš pradėdami kitą veiksmą.
has_image · yes_noDabartinė pasirinkto elemento reikšmė. Perskaitykite ją po susijusio įvykio.
has_changes · yes_noDabartinė pasirinkto elemento reikšmė. Perskaitykite ją po susijusio įvykio.
can_undo · yes_noDabartinė pasirinkto elemento reikšmė. Perskaitykite ją po susijusio įvykio.
can_redo · yes_noDabartinė pasirinkto elemento reikšmė. Perskaitykite ją po susijusio įvykio.
image_width · numberDabartinė pasirinkto elemento reikšmė. Perskaitykite ją po susijusio įvykio.
image_height · numberDabartinė pasirinkto elemento reikšmė. Perskaitykite ją po susijusio įvykio.
output_uri · textFailo vieta šiame įrenginyje. Išsaugokite arba įkelkite failą atskirai, jei jis turi būti laikomas internete.
output_width · numberDabartinė pasirinkto elemento reikšmė. Perskaitykite ją po susijusio įvykio.
output_height · numberDabartinė pasirinkto elemento reikšmė. Perskaitykite ją po susijusio įvykio.
output_bytes · numberDabartinė pasirinkto elemento reikšmė. Perskaitykite ją po susijusio įvykio.
output_mime · textDabartinė pasirinkto elemento reikšmė. Perskaitykite ją po susijusio įvykio.
error_code · textPaskutinio veiksmo klaidos informacija. Rodykite naudingą pranešimą ir pasiūlykite atitinkamą pakartojimą.
crop_active · yes_noDabartinė pasirinkto elemento reikšmė. Perskaitykite ją po susijusio įvykio.
crop_rect_json · textDabartinė pasirinkto elemento reikšmė. Perskaitykite ją po susijusio įvykio.
Įvykiai
source_loadedKai įvyksta šis įvykis, perskaitykite susijusias būsenas iš to paties elemento.
source_load_failedKai įvyksta šis įvykis, perskaitykite susijusias būsenas iš to paties elemento.
edit_appliedKai įvyksta šis įvykis, perskaitykite susijusias būsenas iš to paties elemento.
edit_undoneKai įvyksta šis įvykis, perskaitykite susijusias būsenas iš to paties elemento.
edit_redoneKai įvyksta šis įvykis, perskaitykite susijusias būsenas iš to paties elemento.
editor_resetKai įvyksta šis įvykis, perskaitykite susijusias būsenas iš to paties elemento.
export_startedKai įvyksta šis įvykis, perskaitykite susijusias būsenas iš to paties elemento.
export_completedKai įvyksta šis įvykis, perskaitykite susijusias būsenas iš to paties elemento.
operation_cancelledKai įvyksta šis įvykis, perskaitykite susijusias būsenas iš to paties elemento.
editor_errorKai įvyksta šis įvykis, perskaitykite susijusias būsenas iš to paties elemento.
Klausimai, kuriuos užduoda kūrėjai
Ar output_uri yra Bubble failas?
Ne. Tai yra vietinis talpyklos kelias. Išsaugokite jį naudodami patikimą vietinį įrašymo arba įkėlimo įrankį prieš saugant debesies failo nuorodą.
Kaip veikia prenumerata?
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.
Susijusios gairės
Pagalbos prašym, nurodykite, kurį papildinį ir įrenginį naudojate, kokį veiksmą bandėte ir kas įvyko. Naudokite pavyzdį be asmeninių duomenų. Niekada nesidalinkite savo raktu ar privačiais failais.