Xodera Plugins · Bubble Native
Xodera Photo Editor Native
Transformu elektitan foton en konsekvan avataron, produkta bildo aŭ raporta aldonaĵo. Stuci, rotaciu kaj aligrandigu ĝin, poste konservu la eksportitan kopion en via aplikaĵo.
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.
Dokumentado reviziita 6 novembro 2026
Praktikaj ekzemploj
Konsistaj profilaj avataroj antaŭ alŝuto
Uzantoj devus elekti kiun parton de sia foto montri en kvadrata profilbildo anstataŭ akcepti hazardan tranĉon.
`source_url = selected profile image`; `crop_aspect = "1:1"`; `document_context = the account’s stable reference`.
Atendu `source_loaded`; Begin crop → Apply crop, kun Rotate aŭ Undo laŭbezone. Ĉe eksplicita Konservado, Export image.
Nur ĉe `export_completed`, uzu `output_uri`, `output_width`, `output_height` kaj `output_mime` kiel enigojn por via dosieralŝuta laborfluo. Poste konservu la daŭran referencon en Profile.
Se la uzanto nuligas aŭ `editor_error` okazas, retenu la malnovan avataron. Viŝu la seancon ĉe kontŝanĝo por ke alia uzanto ne povu vidi la skizon.
Redaktado kreas lokan kopion. Via aplikaĵo elektas kiel konservi aŭ alŝuti ĝin.
Preparu konsistajn merkatajn aŭ katalogajn fotojn
Diversaj kadroj kaj trograndaj bildoj igas katalogon neregula kaj pliigas alŝutan grandecon.
`source_url = selected item photo`; `crop_aspect = the app’s chosen ratio`; `export_max_dimension`, `export_format` kaj `export_quality` venas de via alŝuta politiko.
Tranĉu la koncernan areon, laŭvole Resize, poste Export image post kiam la uzanto konfirmas. Tenadu la originan dosieron/referencon aparte.
Kontrolu `output_width`, `output_height`, `output_bytes` kaj `output_mime` antaŭ ol via alŝuta laborfluo konservas la rezulton. Konservu la rezultantan bildreferencon en Item.
Se eksporto malsukcesas aŭ la rezulto malobservas vian alŝutan politikon, montru `error_code` kaj lasu la uzanton korekti ĝin. Ne anstataŭigu la antaŭan bildon de Item antaŭ konfirmo de la alŝuto.
Redaktado kreas lokan kopion. Via aplikaĵo elektas kiel konservi aŭ alŝuti ĝin.
Kreu fokusitan bildkopion por kampraporto
Teknikisto eble bezonos proksimumon de unu difektita parto dum konservante la originan raporta bildon.
`source_url = Current Report Photo’s source`; `document_context = the report/account reference`; tranĉa proporcio povas resti nespezita.
Begin crop → Apply crop, poste uzu Undo/Redo por kompari redaktojn. Export image kreas la redaktitan kopion; via aplikaĵo demandas, ĉu aldoni tiun kopion al Report.
Uzu `has_changes`, `can_undo`, `can_redo` kaj `output_uri`. Konservu originalajn kaj redaktitajn referencojn en apartaj kampoj de la aplikaĵo post sukcesa alŝuto.
Cancel crop aŭ Reset edits restarigas la redaktan vojon; nuligo devas lasi la originan aldonaĵon de Report neŝanĝita.
Redaktado kreas lokan kopion. Via aplikaĵo elektas kiel konservi aŭ alŝuti ĝin.
Kio funkcias nun
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.
Kreu la laborfluon
Uzu la disponeblajn beta-agojn sube kaj testu la rezulton sur viaj cela aparatoj.
Ĉi tiuj ekzemploj uzas aplikaĵajn rekordojn kiel Lesson, Message kaj Order. Anstataŭigu ilin per viaj propraj datumtipoj kaj elementnomoj. Ekzemplaj aŭdvida adresoj devas esti anstataŭigitaj per viaj propraj dosieroj.
Agordu source_url al la elektita bildo. Uzu document_context por identigi la konton kaj registron kiu estas redaktata, tiel ŝanĝo de la registro forigas la antaŭan foton.
Post source_loaded, ruligu Begin crop. Elektu 1:1 por avataro, alĝustigu la stucadon kaj uzu Apply crop. Cancel crop lasas la bildon neŝanĝita.
Uzu Rotate, Flip aŭ Resize se necese. Undo kaj Redo movas tra finitaj redaktoj; Reset edits restarigas la originan bildon.
Ekigu Export image. Ĉe export_completed, legu output_uri, output_width, output_height kaj output_mime. Konservu aŭ alŝutu tiun kopion per via elektita dosierkonserva laborfluo, poste enmetu la konservitan dosieron en la registro.
Agordu unufoje
Ŝlosila aktivigo estas planita por ĉi tiu kromaĵo. Kreu aŭ elektu vian Bubble-aplikaĵan projekton en BestPlugins → Dashboard → Plugins. Elektu Xodera Photo Editor Native, kopiu ĝian ŝlosilon, tiam malfermu Bubble → Plugins → Xodera Photo Editor Native kaj algluu ĝin en licensing_api_key. Konservu unufoje; poste uzu la subajn agojn. Ĉiu kromaĵo en ĉiu projekto havas sian propran ŝlosilon.
Unue elektu aŭ kapti la bildon per via aplikaĵo. Donu al la redaktilo la rezultantan legebla bildadreso. Kamera- kaj foto-bibliotekaj permesoj apartenas al la elektilo kiun vi uzas.
Agordu unufoje
- Kreu aŭ elektu vian Bubble-aplikaĵan projekton ĉe BestPlugins → Dashboard → Plugins.
- Elektu ĉi tiun kromaĵon kaj kopiu ĝian projektan ŝlosilon.
- Open Bubble → Plugins → this plugin. Paste its project key into licensing_api_key and save.
- Aldonu la elementon, elektu viajn aplikaĵajn datumojn kaj konstruu la suban laborfluon.
- 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.
Instalado kaj abono
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.
Konservu la rezulton en via aplikaĵo
Konservu la alŝutitan aŭ permanente konservitan bildon en Profile.image aŭ via aldonaĵa kampo. output_uri estas provizora dosiero sur la aparato, do unue konservu tiun dosieron per via elektita laborfluo. Poste stoku output_width, output_height kaj output_mime kiel metadatenoj. Tenadu la originalan bildon se vi bezonas ambaŭ versiojn.
Malsukceso, nuligo kaj restaŭro
Sur source_load_failed aŭ editor_error, montru error_code kaj proponu Load source. Cancel operation ĉesas akcepti la nefinitan rezulton; atendu ĝis is_busy=no antaŭ ol komenci alian redakton. Clear session vakigas la redaktilon, ne bildon jam konservitan aliloke.
Kapabloj kaj limoj
JPEG kaj PNG eksporto; kvalito 0–1; maksimuma eliga flanko 1–4096 pikseloj. Enigo: ĝis 15 MiB kaj 20 megapikseloj. Ĝis 20 kompletaj redaktoj. Stucaj elektoj: libera, 1:1, 4:3, 3:4 kaj 16:9. Neniu enkonstruita kamerao, filtriloj, tekstaj supermetoj, perspektiva korekto, WebP-eksporto aŭ aŭtomata alŝuto.
Agordoj, agoj kaj rezultoj
Uzu ĉi tiujn nomojn en Bubble. Planitaj funkcioj estas markitaj aparte.
Disponeblaj beta-agordoj
Elementaj agordoj
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 · textStatoj
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 · textEventoj
source_loadedsource_load_failededit_appliededit_undoneedit_redoneeditor_resetexport_startedexport_completedoperation_cancellededitor_errorAgoj kaj iliaj enigoj
Load sourceBegin cropApply cropCancel cropRotateFlipResizeUndoRedoReset editsExport imageCancel operationClear sessionElementaj agordoj · 12
source_urltext · Defaŭlto: ""- Ekzempla valoro
https://bestplugins.online/native-samples/avatar.jpg - Ekzemplo Bubble esprimo
Selected Profile's image_url - Adreso de la elektita audio-, video- aŭ bilddosiero. Uzu dosiertipon subtenatan de ĉi tiu kromaĵo.
document_contexttext · Defaŭlto: ""- Ekzempla valoro
<current-user-id> - Ekzemplo Bubble esprimo
Current User's unique id - Stabila valoro por ĉi tiu konto aŭ registro. Uzu la saman valoron kiam vi restarigas ĝiajn konservitajn dosierojn aŭ skizojn.
is_activeyes_no · Defaŭlto: true- Ekzempla valoro
yes - Ekzemplo Bubble esprimo
GuideHost's view_is_active (your yes/no custom state) - Agordu jes dum ĉi tiu vido estas malfermita. Agordu ne kiam forlasas, por ke reproduktado aŭ nuna laboro povas ĉesi.
disabledyes_no · Defaŭlto: false- Ekzempla valoro
no - Ekzemplo Bubble esprimo
GuideHost's is_busy (your yes/no custom state) - Malebligu la elementon dum via aplikaĵo estas okupata aŭ ĉi tiu ago ne disponeblas.
show_controlsyes_no · Defaŭlto: true- Ekzempla valoro
yes - Ekzemplo Bubble esprimo
App Settings' show_editor_controls - Montri aŭ kaŝi la enkonstruitajn regilojn.
crop_aspecttext · Defaŭlto: "free"- Ekzempla valoro
1:1 - Ekzemplo Bubble esprimo
Avatar Settings' crop_ratio - Uzu la valoron de la nuna komerca registro; validigu ĝin kontraŭ la subaj limoj.
export_formattext · Defaŭlto: "jpeg"- Ekzempla valoro
jpeg - Ekzemplo Bubble esprimo
Format Dropdown's value - Uzu la valoron de la nuna komerca registro; validigu ĝin kontraŭ la subaj limoj.
export_qualitynumber · Defaŭlto: 0.85- Ekzempla valoro
0.85 - Ekzemplo Bubble esprimo
Image Settings' quality - Uzu la valoron de la nuna komerca registro; validigu ĝin kontraŭ la subaj limoj.
export_max_dimensionnumber · Defaŭlto: 2048- Ekzempla valoro
2048 - Ekzemplo Bubble esprimo
Image Settings' max_side - Uzu la valoron de la nuna komerca registro; validigu ĝin kontraŭ la subaj limoj.
allow_upscaleyes_no · Defaŭlto: false- Ekzempla valoro
no - Ekzemplo Bubble esprimo
Allow upscale Checkbox is checked - Uzu la valoron de la nuna komerca registro; validigu ĝin kontraŭ la subaj limoj.
ui_text_jsontext · Defaŭlto: ""- Ekzempla valoro
{} - Ekzemplo Bubble esprimo
App Settings' player_labels_json (supported keys only) - Nedeviga JSON kun subtenataj butonetiketoj. Lasu malplena por uzi la enkonstruitan tekston.
languagetext · Defaŭlto: "auto"- Ekzempla valoro
uk - Ekzemplo Bubble esprimo
Current User's preferred_language - Agordu language=auto por sekvi subtenatan lingvon de la aparato aŭ retumilo. Enigu subtenatan lingvokodon por elekti ĝin eksplicite.
Agoj kaj iliaj enigoj · 13
Load source
Neniuj ago-parametroj
Begin crop
Neniuj ago-parametroj
Apply crop
origin_xnumber · Defaŭlto: —- Ekzempla valoro
0 - Ekzemplo Bubble esprimo
Crop Settings' x (or omit all rectangle inputs) - Uzu la valoron de la nuna komerca registro; validigu ĝin kontraŭ la subaj limoj.
origin_ynumber · Defaŭlto: —- Ekzempla valoro
0 - Ekzemplo Bubble esprimo
Crop Settings' y (or omit all rectangle inputs) - Uzu la valoron de la nuna komerca registro; validigu ĝin kontraŭ la subaj limoj.
widthnumber · Defaŭlto: —- Ekzempla valoro
512 - Ekzemplo Bubble esprimo
Resize Width Input's value:converted to number - Uzu la valoron de la nuna komerca registro; validigu ĝin kontraŭ la subaj limoj.
heightnumber · Defaŭlto: —- Ekzempla valoro
512 - Ekzemplo Bubble esprimo
Resize Height Input's value:converted to number - Uzu la valoron de la nuna komerca registro; validigu ĝin kontraŭ la subaj limoj.
Cancel crop
Neniuj ago-parametroj
Rotate
degreesnumber · Defaŭlto: —- Ekzempla valoro
90 - Ekzemplo Bubble esprimo
Rotation Dropdown's value - Uzu la valoron de la nuna komerca registro; validigu ĝin kontraŭ la subaj limoj.
Flip
axistext · Defaŭlto: —- Ekzempla valoro
horizontal - Ekzemplo Bubble esprimo
Flip Direction Dropdown's value - Uzu la valoron de la nuna komerca registro; validigu ĝin kontraŭ la subaj limoj.
Resize
widthnumber · Defaŭlto: —- Ekzempla valoro
512 - Ekzemplo Bubble esprimo
Resize Width Input's value:converted to number - Uzu la valoron de la nuna komerca registro; validigu ĝin kontraŭ la subaj limoj.
heightnumber · Defaŭlto: —- Ekzempla valoro
512 - Ekzemplo Bubble esprimo
Resize Height Input's value:converted to number - Uzu la valoron de la nuna komerca registro; validigu ĝin kontraŭ la subaj limoj.
Undo
Neniuj ago-parametroj
Redo
Neniuj ago-parametroj
Reset edits
Neniuj ago-parametroj
Export image
Neniuj ago-parametroj
Cancel operation
Neniuj ago-parametroj
Clear session
Neniuj ago-parametroj
Statoj kaj eventoj
Statoj
editor_status · textNuna rezulto de ĉi tiu ago. Uzu la kongruan finigan eventon antaŭ ol konservi sukceson.
is_busy · yes_noLaboro ankoraŭ progresas. Atendu antaŭ ol komenci alian agon.
has_image · yes_noNuna valoro por la elektita elemento. Legu ĝin post la rilata evento.
has_changes · yes_noNuna valoro por la elektita elemento. Legu ĝin post la rilata evento.
can_undo · yes_noNuna valoro por la elektita elemento. Legu ĝin post la rilata evento.
can_redo · yes_noNuna valoro por la elektita elemento. Legu ĝin post la rilata evento.
image_width · numberNuna valoro por la elektita elemento. Legu ĝin post la rilata evento.
image_height · numberNuna valoro por la elektita elemento. Legu ĝin post la rilata evento.
output_uri · textDosierlokado en ĉi tiu aparato. Konservu aŭ alŝutu la dosieron aparte se ĝi devas esti tenata enrete.
output_width · numberNuna valoro por la elektita elemento. Legu ĝin post la rilata evento.
output_height · numberNuna valoro por la elektita elemento. Legu ĝin post la rilata evento.
output_bytes · numberNuna valoro por la elektita elemento. Legu ĝin post la rilata evento.
output_mime · textNuna valoro por la elektita elemento. Legu ĝin post la rilata evento.
error_code · textErarinformoj por la lasta ago. Montru utilan mesaĝon kaj proponu la rilatan reprovon.
crop_active · yes_noNuna valoro por la elektita elemento. Legu ĝin post la rilata evento.
crop_rect_json · textNuna valoro por la elektita elemento. Legu ĝin post la rilata evento.
Eventoj
source_loadedKiam ĉi tiu evento okazas, legu la rilatajn statojn de la sama elemento.
source_load_failedKiam ĉi tiu evento okazas, legu la rilatajn statojn de la sama elemento.
edit_appliedKiam ĉi tiu evento okazas, legu la rilatajn statojn de la sama elemento.
edit_undoneKiam ĉi tiu evento okazas, legu la rilatajn statojn de la sama elemento.
edit_redoneKiam ĉi tiu evento okazas, legu la rilatajn statojn de la sama elemento.
editor_resetKiam ĉi tiu evento okazas, legu la rilatajn statojn de la sama elemento.
export_startedKiam ĉi tiu evento okazas, legu la rilatajn statojn de la sama elemento.
export_completedKiam ĉi tiu evento okazas, legu la rilatajn statojn de la sama elemento.
operation_cancelledKiam ĉi tiu evento okazas, legu la rilatajn statojn de la sama elemento.
editor_errorKiam ĉi tiu evento okazas, legu la rilatajn statojn de la sama elemento.
Demandoj, kiujn programistoj demandas
Ĉu output_uri estas Bubble File?
Ne. Ĝi estas loka kaŝmemora vojo. Persistigu ĝin per provita loka konservilo aŭ alŝutilo antaŭ ol stoki referencon al nuba dosiero.
Kiel funkcias la abono?
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.
Rilataj gvidiloj
Por helpo, informu nin kiun kromaĵon kaj aparaton vi uzas, la agon kiun vi provis kaj kio okazis. Uzu ekzemplon sen personaj datumoj. Neniam dividu vian ŝlosilon aŭ privatajn dosierojn.