Interfatscha precedenta dal Photo Editor per Bubble Native. La modificaziun e l'export en la beta actuala vegnan anc testads.
Interfatscha precedenta dal Photo Editor per Bubble Native. La modificaziun e l'export en la beta actuala vegnan anc testads.
← Tut las guidas Bubble Native

Xodera Plugins · Bubble Native

Xodera Photo Editor Native

Transfurma ina fotografia selecziunada en in avatar coerent, in maletg da product u in annex da rapport. Taglia, gira e redimensiona, suenter memorisescha la copia exportada en tia app.

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.

Documentaziun controllada ils 6 da november 2026

Exemplars pratics

Avatars da profil consistents avant l'incaricament

Ils utilisaders duvravan tscherner tge part da lur fotografia cumpara en ina maletg da profil quadrà, empè da acceptar in tagli arbitrari.

`source_url = selected profile image`; `crop_aspect = "1:1"`; `document_context = the account’s stable reference`.

Spetga per `source_loaded`; Begin crop → Apply crop, cun Rotate u Undo sco necessari. Cun Save explicì, Export image.

Mo suenter `export_completed`, duvrar `output_uri`, `output_width`, `output_height` e `output_mime` sco inputs per il flux da lavur d'incaricament da datoteca. Salva la sia referenza durabla al Profil suenter.

Sche l'utilisader annullescha u `editor_error` succeda, conserva l'avatar vegl. Stizza la sessiun cura ch'il conto mida, per che in auter utilisader na possia betg vesair il sboz.

Modifitgar crea ina copia locala. La tia app tscherna co salvar u incaricar ella.

Prepara fotografias consistentas per il marcà u il catalog

In cadrage different e maletgs memia gronds rendan in catalog irregular ed augmentan la grondezza da chargiar.

`source_url = selected item photo`; `crop_aspect = the app’s chosen ratio`; `export_max_dimension`, `export_format` e `export_quality` derivan da tia politica d'incaricament.

Taglia la zona relevanta, eventualmain Resize, suenter Export image suenter che l'utilisader confermescha. Mantegna la datoteca/referenza originala separadamain.

Controlla `output_width`, `output_height`, `output_bytes` e `output_mime` avant ch'il flus da chargiar memorisescha il resultat. Memorisescha la referenza dal maletg resultant en l'Item.

Sche l'export falla u il resultat na correspunda betg a tia politica da chargiar, mussa `error_code` e lascha l'utilisader modifitgar el. Na remplazza betg il maletg precedent da l'Item avant la conferma dal chargiar.

Modifitgar crea ina copia locala. La tia app tscherna co salvar u incaricar ella.

Crees ina copia d'imagin focalisada per in rapport da camp

In technic po basegnar in prim plan d'in element damà, preservand l'imagin original dal rapport.

`source_url = Current Report Photo’s source`; `document_context = the report/account reference`; il raport da tagli po restar senza constricziuns.

Begin crop → Apply crop, lura dovra Undo/Redo per cumparegliar las modificaziuns. Export image crea la copia modifitgada; tia app dumonda sche questa copia duai vegnir agiuntada al Report.

Duvra `has_changes`, `can_undo`, `can_redo` e `output_uri`. Memorisescha las referenzas originalas e modificadas en champs separads da l'app suenter in incaricament reussì.

Cancel crop u Reset edits restaura il percurs da modificaziun; la cancellaziun sto laschar l'atach original dal Rapport inunchangià.

Modifitgar crea ina copia locala. La tia app tscherna co salvar u incaricar ella.

Tge che funcziuna ussa

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.

Crear il flus da lavur

Utilisescha las acziuns beta disponiblas sutvart e testa il resultat sin tes apparats mira.

Quests exempels dovran endataziuns da l'app sco Lesson, Message ed Order. Remplazza quellas cun tes agens tips da datas e nums d'elements. Remplazza las adressas da medias d'exempel cun tias atgnas datotecas.

  1. Definischa source_url cun l’imagin tschernida. Utilisescha document_context per identificar il conto e il registraziun che vegn modifitgà, uschia che la modificaziun dal registraziun netta la fotografia precedenta.

  2. Suenter source_loaded, exequa Begin crop. Tscherna 1:1 per in avatar, ajusta il tagli e utilisescha Apply crop. Cancel crop lascha l’imagin inchangià.

  3. Utilisescha Rotate, Flip u Resize sch’èn necessari. Undo e Redo navigan tranter las modificaziuns cumpigliadas; Reset edits restaura l’imagin originala.

  4. Executa Export image. Sin export_completed, legia output_uri, output_width, output_height e output_mime. Salva u incaricha quella copia cun il flux da lavur da salvament da datotecas che ti has tschernì, suenter memorisescha la datoteca salvada en il registr.

Diagramma dal flus da lavur — betg ina captura d’app

Configurar ina giada

L’activaziun da clav è planificada per quest plugin. Crees u tscherna tes project Bubble en BestPlugins → Dashboard → Plugins. Tscherna Xodera Photo Editor Native, copia sia clav, suenter avra Bubble → Plugins → Xodera Photo Editor Native e incolla ella en licensing_api_key. Memorisescha ina giada; suenter utilisescha las acziuns sutvart. Mintga plugin en mintga project ha sia clav propia.

Primier tscherna u captura l’imagin cun tia app. Dà al editur l’adressa da l’imagin legibla resultant. Las permissiuns da camera e da biblioteca da fotografias appartenen al selector che ti utiliseschas.

Configurar ina giada
  1. Creescha u tscherna tes project d'app Bubble en BestPlugins → Dashboard → Plugins.
  2. Tscherna quest plugin e copia sia clav dal project.
  3. Open Bubble → Plugins → this plugin. Paste its project key into licensing_api_key and save.
  4. Agiunta l'element, tscherna tias datas d'app e construescha il flus da lavur sutvart.
  5. 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.
Installaziun e abonnament

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.

Memorisar il resultat en tia app

Memorisescha l’imagin chargiada u permanentamain salvada en Profile.image u en tes champ d’annex. output_uri è in datoteca temporara sin il dispositiv, uschia memorisescha l’emprim quella datoteca cun il flux da lavur che ti tschernas. Suenter memorisescha output_width, output_height e output_mime sco metadata. Conserva l’imagin originala sch’ti dovras ambas versiones.

Falliment, annullar e restaurar

Sin source_load_failed u editor_error, mussa error_code ed offra Load source. Cancel operation ferma l'acceptaziun dal resultat betg terminà; spetga enfin is_busy=no avant da cumenzar in'autra modificaziun. Clear session stizza l'editur, betg in maletg gia memorisà en in auter lieu.

Capacitads e lims

Export JPEG e PNG; qualitad 0–1; vart maximala dal maletg da sortida 1–4096 pixels. Entrada: fin a 15 MiB e 20 megapixels. Fin a 20 modificaziuns terminadas. Opziuns da tagliar: liber, 1:1, 4:3, 3:4 e 16:9. Nagina camera integrada, nagins filters, surposiziuns da text, correctura da perspectiva, export WebP u chargiar automatic.

Configuraziuns, acziuns e resultats

Utilisescha quests numens en Bubble. Funcziuns planisadas èn marcadas separadamain.

Configuraziuns beta disponiblas

Configuraziun da l'element

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 · text

Stadis

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

Eveniments

source_loadedsource_load_failededit_appliededit_undoneedit_redoneeditor_resetexport_startedexport_completedoperation_cancellededitor_error

Acziuns e lur inputs

Load sourceBegin cropApply cropCancel cropRotateFlipResizeUndoRedoReset editsExport imageCancel operationClear session
Configuraziun da l'element · 12
source_urltext · Standard: ""
Valur d'exempelhttps://bestplugins.online/native-samples/avatar.jpg
Exempel Bubble expressiunSelected Profile's image_url
Adress da la datoteca audio, video u maletg selecziunada. Utilisescha in tip da datoteca che quest plugin sustegna.
document_contexttext · Standard: ""
Valur d'exempel<current-user-id>
Exempel Bubble expressiunCurrent User's unique id
Valur stabla per quest conto u questa endataziun. Dovra la medema valur per restaurar sias datotecas u ses sbozs memorisads.
is_activeyes_no · Standard: true
Valur d'exempelyes
Exempel Bubble expressiunGuideHost's view_is_active (your yes/no custom state)
Definiescha yes durant che questa vista è averta. Definiescha no cura che ti bandunas ella, per che la reproducziun u il lavur actual possia sa fermar.
disabledyes_no · Standard: false
Valur d'exempelno
Exempel Bubble expressiunGuideHost's is_busy (your yes/no custom state)
Deactiva l'element cura che tia app è occupada u che questa acziun è betg disponibla.
show_controlsyes_no · Standard: true
Valur d'exempelyes
Exempel Bubble expressiunApp Settings' show_editor_controls
Mussar u zuppentar ils controlls integrads.
crop_aspecttext · Standard: "free"
Valur d'exempel1:1
Exempel Bubble expressiunAvatar Settings' crop_ratio
Utilisescha il valur dal registr da l'interpresa actual; validescha el cun ils limits sutvart.
export_formattext · Standard: "jpeg"
Valur d'exempeljpeg
Exempel Bubble expressiunFormat Dropdown's value
Utilisescha il valur dal registr da l'interpresa actual; validescha el cun ils limits sutvart.
export_qualitynumber · Standard: 0.85
Valur d'exempel0.85
Exempel Bubble expressiunImage Settings' quality
Utilisescha il valur dal registr da l'interpresa actual; validescha el cun ils limits sutvart.
export_max_dimensionnumber · Standard: 2048
Valur d'exempel2048
Exempel Bubble expressiunImage Settings' max_side
Utilisescha il valur dal registr da l'interpresa actual; validescha el cun ils limits sutvart.
allow_upscaleyes_no · Standard: false
Valur d'exempelno
Exempel Bubble expressiunAllow upscale Checkbox is checked
Utilisescha il valur dal registr da l'interpresa actual; validescha el cun ils limits sutvart.
ui_text_jsontext · Standard: ""
Valur d'exempel{}
Exempel Bubble expressiunApp Settings' player_labels_json (supported keys only)
JSON facultativ cun etichettas da buttun sustegnidas. Lascha vid per duvrar il text integrà.
languagetext · Standard: "auto"
Valur d'exempeluk
Exempel Bubble expressiunCurrent User's preferred_language
Definiescha language=auto per suandar la lingua da l'apparat u dal navigatur, sch'ella è sustegnida. Endatescha in code da lingua sustegnì per tscherner quella explicitamain.
Acziuns e lur inputs · 13
Load source

Nagins parameters d'acziun

Begin crop

Nagins parameters d'acziun

Apply crop
origin_xnumber · Standard: —
Valur d'exempel0
Exempel Bubble expressiunCrop Settings' x (or omit all rectangle inputs)
Utilisescha il valur dal registr da l'interpresa actual; validescha el cun ils limits sutvart.
origin_ynumber · Standard: —
Valur d'exempel0
Exempel Bubble expressiunCrop Settings' y (or omit all rectangle inputs)
Utilisescha il valur dal registr da l'interpresa actual; validescha el cun ils limits sutvart.
widthnumber · Standard: —
Valur d'exempel512
Exempel Bubble expressiunResize Width Input's value:converted to number
Utilisescha il valur dal registr da l'interpresa actual; validescha el cun ils limits sutvart.
heightnumber · Standard: —
Valur d'exempel512
Exempel Bubble expressiunResize Height Input's value:converted to number
Utilisescha il valur dal registr da l'interpresa actual; validescha el cun ils limits sutvart.
Cancel crop

Nagins parameters d'acziun

Rotate
degreesnumber · Standard: —
Valur d'exempel90
Exempel Bubble expressiunRotation Dropdown's value
Utilisescha il valur dal registr da l'interpresa actual; validescha el cun ils limits sutvart.
Flip
axistext · Standard: —
Valur d'exempelhorizontal
Exempel Bubble expressiunFlip Direction Dropdown's value
Utilisescha il valur dal registr da l'interpresa actual; validescha el cun ils limits sutvart.
Resize
widthnumber · Standard: —
Valur d'exempel512
Exempel Bubble expressiunResize Width Input's value:converted to number
Utilisescha il valur dal registr da l'interpresa actual; validescha el cun ils limits sutvart.
heightnumber · Standard: —
Valur d'exempel512
Exempel Bubble expressiunResize Height Input's value:converted to number
Utilisescha il valur dal registr da l'interpresa actual; validescha el cun ils limits sutvart.
Undo

Nagins parameters d'acziun

Redo

Nagins parameters d'acziun

Reset edits

Nagins parameters d'acziun

Export image

Nagins parameters d'acziun

Cancel operation

Nagins parameters d'acziun

Clear session

Nagins parameters d'acziun

Stadis e eveniments

Stadis

editor_status · text

Resultat actual da questa acziun. Dovra l'eveniment correspundent che inditgescha la fin da l'acziun avant da memorisar il success.

is_busy · yes_no

Il lavur è anc en cors. Spetga avant da cumenzar ina nova acziun.

has_image · yes_no

Valur actual per l'element selecziunà. Legia el suenter l'eveniment relatà.

has_changes · yes_no

Valur actual per l'element selecziunà. Legia el suenter l'eveniment relatà.

can_undo · yes_no

Valur actual per l'element selecziunà. Legia el suenter l'eveniment relatà.

can_redo · yes_no

Valur actual per l'element selecziunà. Legia el suenter l'eveniment relatà.

image_width · number

Valur actual per l'element selecziunà. Legia el suenter l'eveniment relatà.

image_height · number

Valur actual per l'element selecziunà. Legia el suenter l'eveniment relatà.

output_uri · text

Posiziun dal datoteca sin quest apparat. Salva u incaricha il datoteca separadamain sch'igl è necessari da mantenerla online.

output_width · number

Valur actual per l'element selecziunà. Legia el suenter l'eveniment relatà.

output_height · number

Valur actual per l'element selecziunà. Legia el suenter l'eveniment relatà.

output_bytes · number

Valur actual per l'element selecziunà. Legia el suenter l'eveniment relatà.

output_mime · text

Valur actual per l'element selecziunà. Legia el suenter l'eveniment relatà.

error_code · text

Informaziuns d'error per l'ultima acziun. Mussar in messadi d'agid e porscher il reprovà pertinent.

crop_active · yes_no

Valur actual per l'element selecziunà. Legia el suenter l'eveniment relatà.

crop_rect_json · text

Valur actual per l'element selecziunà. Legia el suenter l'eveniment relatà.

Eveniments

source_loaded

Sch'quest event succeda, legia ils stadi relatads da l'istess element.

source_load_failed

Sch'quest event succeda, legia ils stadi relatads da l'istess element.

edit_applied

Sch'quest event succeda, legia ils stadi relatads da l'istess element.

edit_undone

Sch'quest event succeda, legia ils stadi relatads da l'istess element.

edit_redone

Sch'quest event succeda, legia ils stadi relatads da l'istess element.

editor_reset

Sch'quest event succeda, legia ils stadi relatads da l'istess element.

export_started

Sch'quest event succeda, legia ils stadi relatads da l'istess element.

export_completed

Sch'quest event succeda, legia ils stadi relatads da l'istess element.

operation_cancelled

Sch'quest event succeda, legia ils stadi relatads da l'istess element.

editor_error

Sch'quest event succeda, legia ils stadi relatads da l'istess element.

Dumondas che ils sviluppaders fan

È output_uri ina Bubble File?

Na. È in percurs da cache local. Conservescha el cun in salvader u incaricader local provà avant da memorisar ina referenza da datoteca cloud.

Co funcziuna l'abunament?

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.

Guidas colliadas

Per agid, indichescha nus tge plugin e tge apparat ti dovras, l'acziun che ti has empruvà e tge succedì. Dovra in exempel senza datas persunalas. Mai cundivida tia clav ni tes files privats.