Rhyngwyneb cynharach Photo Editor yn Bubble Native. Mae golygu ac allforio yn y beta cyfredol yn dal i gael eu profi.
Rhyngwyneb cynharach Photo Editor yn Bubble Native. Mae golygu ac allforio yn y beta cyfredol yn dal i gael eu profi.
← Pob canllaw Bubble Native

Xodera Plugins · Bubble Native

Xodera Photo Editor Native

Trowch ffotograff a ddewiswyd yn avatar cyson, delwedd cynnyrch neu atodiad adroddiad. Toriwch, troi a newid maint iddo, yna arbedwch y copi allforiwyd yn eich 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.

Dogfennaeth wedi’i hadolygu ar 6 Tachwedd 2026

Enghreifftiau ymarferol

Afatarau proffil cyson cyn llwytho

Dylai defnyddwyr ddewis pa ran o'u llun fydd yn ymddangos mewn delwedd proffil sgwâr yn lle derbyn torri ar hap.

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

Arhoswch am `source_loaded`; Begin crop → Apply crop, gyda Rotate neu Undo fel sy'n angenrheidiol. Ar arbed penodol, Export image.

Dim ond ar `export_completed`, defnyddiwch `output_uri`, `output_width`, `output_height` a `output_mime` fel mewnbynnau i'ch llif gwaith llwytho ffeil. Cadwch ei gyfeiriad parhaol i'r Proffil wedyn.

Os yw'r defnyddiwr yn canslo neu mae `editor_error` yn cael ei weithredu, cadwch yr afatar hen. Cliriwch y sesiwn wrth newid cyfrif fel na all defnyddiwr arall weld y drafft.

Mae golygu'n creu copi lleol. Mae eich app yn dewis sut i'w arbed neu ei lwytho.

Paratowch luniau marchnad neu gatalog cyson

Mae fframio gwahanol a delweddau rhy fawr yn gwneud catalog yn anghyson ac yn cynyddu maint y llwytho i fyny.

`source_url = selected item photo`; `crop_aspect = the app’s chosen ratio`; `export_max_dimension`, `export_format` a `export_quality` yn dod o'ch polisi lanlwytho.

Tocio'r ardal berthnasol, yn ddewisol Resize, yna Export image ar ôl i'r defnyddiwr gadarnhau. Cadwch y ffeil/gyfeiriad gwreiddiol ar wahân.

Gwiriwch `output_width`, `output_height`, `output_bytes` a `output_mime` cyn i'ch llif gwaith lanlwytho arbed y canlyniad. Storio'r cyfeiriad delwedd sy'n deillio ar yr Eitem.

Os yw'r allforio'n methu neu os yw'r canlyniad yn torri eich polisi llwytho i fyny, dangoswch `error_code` a gadewch i'r defnyddiwr ei ddiwygio. Peidiwch â disodli delwedd flaenorol yr Item cyn cael cadarnhad o'r llwytho i fyny.

Mae golygu'n creu copi lleol. Mae eich app yn dewis sut i'w arbed neu ei lwytho.

Creu copi delwedd ffocysedig ar gyfer adroddiad maes.

Efallai y bydd technegydd angen agosiad o un rhan ddifroedig wrth gadw delwedd yr adroddiad gwreiddiol.

`source_url = Current Report Photo’s source`; `document_context = the report/account reference`; gall cymhareb torri aros heb ei gyfyngu.

Begin crop → Apply crop, yna defnyddiwch Undo/Redo i gymharu golygiadau. Export image yn creu'r copi a olygwyd; mae eich app yn gofyn a ddylid atodi'r copi hon at yr Adroddiad.

Defnyddiwch `has_changes`, `can_undo`, `can_redo` a `output_uri`. Storio'r cyfeiriadau gwreiddiol a'r rhai a olygwyd mewn meysydd app ar wahân ar ôl llwythiad llwyddiannus.

Mae Cancel crop neu Reset edits yn adfer y llwybr golygu; rhaid i ganslo adael atodiad gwreiddiol y Report heb ei newid.

Mae golygu'n creu copi lleol. Mae eich app yn dewis sut i'w arbed neu ei lwytho.

Beth sy'n gweithio nawr

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.

Creu'r gweithdull

Defnyddiwch y gweithredoedd beta sydd ar gael isod a phrofwch y canlyniad ar eich dyfeisiau targed.

Defnyddir y enghreifftiau hyn cofnodion app fel Lesson, Message a Order. Disodlwch nhw gyda'ch mathau data eich hun a enwau elfennau. Rhaid disodli cyfeiriadau cyfryngau enghreifftiol gyda'ch ffeiliau eich hun.

  1. Gosod source_url i'r ddelwedd ddewisiedig. Defnyddiwch document_context i adnabod y cyfrif a'r cofnod sy'n cael ei olygu, felly mae newid y cofnod yn clirio'r llun blaenorol.

  2. Ar ôl source_loaded, rhedwch Begin crop. Dewiswch 1:1 ar gyfer afatar, addaswch y tocio a defnyddiwch Apply crop. Mae Cancel crop yn gadael y ddelwedd heb ei newid.

  3. Defnyddiwch Rotate, Flip neu Resize os oes angen. Mae Undo a Redo yn symud trwy olygiadau wedi'u cwblhau; mae Reset edits yn adfer y ddelwedd wreiddiol.

  4. Rhedeg Export image. Ar export_completed, darllen output_uri, output_width, output_height a output_mime. Cadwch neu uwchlwythwch y copi hwn gan ddefnyddio eich llif gwaith cadw ffeiliau dewisiedig, yna storwch y ffeil a gadwyd yn y cofnod.

Diagram llif gwaith — nid sgrinlun app

Ffurfweddu unwaith

Mae gweithredu allwedd wedi'i gynllunio ar gyfer y ategyn hwn. Creu neu ddewis eich prosiect app Bubble yn BestPlugins → Dashboard → Plugins. Dewiswch Xodera Photo Editor Native, copïwch ei allwedd, yna agor Bubble → Plugins → Xodera Photo Editor Native a gludwch hi i licensing_api_key. Cadwch unwaith; yna defnyddiwch y gweithredoedd isod. Mae gan bob ategyn mewn pob prosiect ei allwedd ei hun.

Dewiswch neu gipiwch y ddelwedd gyda'ch app yn gyntaf. Rhowch gyfeiriad y ddelwedd ddarllenadwy i'r golygydd. Mae caniatâd y camera a'r llyfrgell ffotograffau yn perthyn i'r dewiswr rydych chi'n ei ddefnyddio.

Ffurfweddu unwaith
  1. Creuwch neu dewiswch eich prosiect app Bubble yn BestPlugins → Dashboard → Plugins.
  2. Dewiswch yr ategyn hwn a chopiwch ei allwedd prosiect.
  3. Open Bubble → Plugins → this plugin. Paste its project key into licensing_api_key and save.
  4. Ychwanegwch yr elfen, dewiswch eich data app a chreu'r llif gwaith isod.
  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.
Gosod a thanysgrifiad

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.

Cadw'r canlyniad yn eich ap

Cadwch y ddelwedd a lwythwyd i fyny neu a gadwyd yn barhaol i Profile.image neu'ch maes atodiad. Mae output_uri yn ffeil dros dro ar y ddyfais, felly cadwch y ffeil honno'n gyntaf gyda'ch llif gwaith a ddewiswyd. Yna storwch output_width, output_height a output_mime fel metadata. Cadwch y ddelwedd wreiddiol os oes angen y ddwy fersiwn arnoch.

Methiant, canslo a adfer

Ar source_load_failed neu editor_error, dangos error_code a chynnig Load source. Mae Cancel operation yn stopio derbyn y canlyniad anorffenedig; arhoswch tan is_busy=no cyn cychwyn golygu arall. Mae Clear session yn clirio'r golygydd, nid ddelwedd sydd eisoes wedi'i chadw mewn man arall.

Galluoedd a chyfyngiadau

Allforio JPEG a PNG; ansawdd 0–1; ochr allbwn fwyaf 1–4096 picsel. Mewnbwn: hyd at 15 MiB a 20 megapicsel. Hyd at 20 o olygiadau wedi'u cwblhau. Dewisiadau tocio: rhydd, 1:1, 4:3, 3:4 a 16:9. Dim camera mewnol, hidlwyr, haenau testun dros y ddelwedd, cywiro persbectif, allforio WebP na llwytho i fyny'n awtomatig.

Gosodiadau, gweithredoedd a chanlyniadau

Defnyddiwch y enwau hyn yn Bubble. Nodir nodweddion a gynlluniwyd ar wahân.

Gosodiadau beta ar gael

Gosodiadau elfen

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

Cyflyrau

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

Digwyddiadau

source_loadedsource_load_failededit_appliededit_undoneedit_redoneeditor_resetexport_startedexport_completedoperation_cancellededitor_error

Gweithredoedd a'u mewnbynnau

Load sourceBegin cropApply cropCancel cropRotateFlipResizeUndoRedoReset editsExport imageCancel operationClear session
Gosodiadau elfen · 12
source_urltext · Rhagosodedig: ""
Gwerth enghreifftiolhttps://bestplugins.online/native-samples/avatar.jpg
Enghraifft o fynegiad BubbleSelected Profile's image_url
Cyfeiriad y ffeil sain, fideo neu ddelwedd a ddewiswyd. Defnyddiwch fath ffeil y mae'r ategyn hwn yn ei gefnogi.
document_contexttext · Rhagosodedig: ""
Gwerth enghreifftiol<current-user-id>
Enghraifft o fynegiad BubbleCurrent User's unique id
Gwerth sefydlog ar gyfer y cyfrif neu'r cofnod hwn. Defnyddiwch yr un gwerth wrth adfer ei ffeiliau neu ddrafftau a gadwyd.
is_activeyes_no · Rhagosodedig: true
Gwerth enghreifftiolyes
Enghraifft o fynegiad BubbleGuideHost's view_is_active (your yes/no custom state)
Gosodwch yes tra bo'r olygfa hon ar agor. Gosodwch no wrth adael, fel y gall chwarae neu'r gwaith cyfredol stopio.
disabledyes_no · Rhagosodedig: false
Gwerth enghreifftiolno
Enghraifft o fynegiad BubbleGuideHost's is_busy (your yes/no custom state)
Analluogwch yr elfen tra mae eich app yn brysur neu mae'r weithred hon ddim ar gael.
show_controlsyes_no · Rhagosodedig: true
Gwerth enghreifftiolyes
Enghraifft o fynegiad BubbleApp Settings' show_editor_controls
Dangos neu guddio'r rheolyddion mewnol.
crop_aspecttext · Rhagosodedig: "free"
Gwerth enghreifftiol1:1
Enghraifft o fynegiad BubbleAvatar Settings' crop_ratio
Defnyddiwch werth y cofnod busnes cyfredol; dilyswch ef yn erbyn y terfynau isod.
export_formattext · Rhagosodedig: "jpeg"
Gwerth enghreifftioljpeg
Enghraifft o fynegiad BubbleFormat Dropdown's value
Defnyddiwch werth y cofnod busnes cyfredol; dilyswch ef yn erbyn y terfynau isod.
export_qualitynumber · Rhagosodedig: 0.85
Gwerth enghreifftiol0.85
Enghraifft o fynegiad BubbleImage Settings' quality
Defnyddiwch werth y cofnod busnes cyfredol; dilyswch ef yn erbyn y terfynau isod.
export_max_dimensionnumber · Rhagosodedig: 2048
Gwerth enghreifftiol2048
Enghraifft o fynegiad BubbleImage Settings' max_side
Defnyddiwch werth y cofnod busnes cyfredol; dilyswch ef yn erbyn y terfynau isod.
allow_upscaleyes_no · Rhagosodedig: false
Gwerth enghreifftiolno
Enghraifft o fynegiad BubbleAllow upscale Checkbox is checked
Defnyddiwch werth y cofnod busnes cyfredol; dilyswch ef yn erbyn y terfynau isod.
ui_text_jsontext · Rhagosodedig: ""
Gwerth enghreifftiol{}
Enghraifft o fynegiad BubbleApp Settings' player_labels_json (supported keys only)
JSON dewisol gyda labeli botwm sy'n cael eu cefnogi. Gadewch yn wag i ddefnyddio'r testun mewnol.
languagetext · Rhagosodedig: "auto"
Gwerth enghreifftioluk
Enghraifft o fynegiad BubbleCurrent User's preferred_language
Gosodwch language=auto i ddilyn iaith y ddyfais neu'r porwr, os yw'r iaith honno'n cael ei chefnogi. Rhowch god iaith a gefnogir i ddewis yr iaith yn benodol.
Gweithredoedd a'u mewnbynnau · 13
Load source

Dim paramedrau gweithred

Begin crop

Dim paramedrau gweithred

Apply crop
origin_xnumber · Rhagosodedig: —
Gwerth enghreifftiol0
Enghraifft o fynegiad BubbleCrop Settings' x (or omit all rectangle inputs)
Defnyddiwch werth y cofnod busnes cyfredol; dilyswch ef yn erbyn y terfynau isod.
origin_ynumber · Rhagosodedig: —
Gwerth enghreifftiol0
Enghraifft o fynegiad BubbleCrop Settings' y (or omit all rectangle inputs)
Defnyddiwch werth y cofnod busnes cyfredol; dilyswch ef yn erbyn y terfynau isod.
widthnumber · Rhagosodedig: —
Gwerth enghreifftiol512
Enghraifft o fynegiad BubbleResize Width Input's value:converted to number
Defnyddiwch werth y cofnod busnes cyfredol; dilyswch ef yn erbyn y terfynau isod.
heightnumber · Rhagosodedig: —
Gwerth enghreifftiol512
Enghraifft o fynegiad BubbleResize Height Input's value:converted to number
Defnyddiwch werth y cofnod busnes cyfredol; dilyswch ef yn erbyn y terfynau isod.
Cancel crop

Dim paramedrau gweithred

Rotate
degreesnumber · Rhagosodedig: —
Gwerth enghreifftiol90
Enghraifft o fynegiad BubbleRotation Dropdown's value
Defnyddiwch werth y cofnod busnes cyfredol; dilyswch ef yn erbyn y terfynau isod.
Flip
axistext · Rhagosodedig: —
Gwerth enghreifftiolhorizontal
Enghraifft o fynegiad BubbleFlip Direction Dropdown's value
Defnyddiwch werth y cofnod busnes cyfredol; dilyswch ef yn erbyn y terfynau isod.
Resize
widthnumber · Rhagosodedig: —
Gwerth enghreifftiol512
Enghraifft o fynegiad BubbleResize Width Input's value:converted to number
Defnyddiwch werth y cofnod busnes cyfredol; dilyswch ef yn erbyn y terfynau isod.
heightnumber · Rhagosodedig: —
Gwerth enghreifftiol512
Enghraifft o fynegiad BubbleResize Height Input's value:converted to number
Defnyddiwch werth y cofnod busnes cyfredol; dilyswch ef yn erbyn y terfynau isod.
Undo

Dim paramedrau gweithred

Redo

Dim paramedrau gweithred

Reset edits

Dim paramedrau gweithred

Export image

Dim paramedrau gweithred

Cancel operation

Dim paramedrau gweithred

Clear session

Dim paramedrau gweithred

Cyflyrau a digwyddiadau

Cyflyrau

editor_status · text

Canlyniad cyfredol y weithred hon. Defnyddiwch y digwyddiad cwblhau cyfatebol cyn arbed llwyddiant.

is_busy · yes_no

Mae'r gwaith dal yn mynd rhagddo. Arhoswch cyn cychwyn gweithred arall.

has_image · yes_no

Gwerth cyfredol yr eitem a ddewiswyd. Darllenwch ef ar ôl y digwyddiad cysylltiedig.

has_changes · yes_no

Gwerth cyfredol yr eitem a ddewiswyd. Darllenwch ef ar ôl y digwyddiad cysylltiedig.

can_undo · yes_no

Gwerth cyfredol yr eitem a ddewiswyd. Darllenwch ef ar ôl y digwyddiad cysylltiedig.

can_redo · yes_no

Gwerth cyfredol yr eitem a ddewiswyd. Darllenwch ef ar ôl y digwyddiad cysylltiedig.

image_width · number

Gwerth cyfredol yr eitem a ddewiswyd. Darllenwch ef ar ôl y digwyddiad cysylltiedig.

image_height · number

Gwerth cyfredol yr eitem a ddewiswyd. Darllenwch ef ar ôl y digwyddiad cysylltiedig.

output_uri · text

Lleoliad y ffeil ar y ddyfais hon. Cadwch neu uwchlwythwch y ffeil ar wahân os mae'n rhaid i'w chadw ar-lein.

output_width · number

Gwerth cyfredol yr eitem a ddewiswyd. Darllenwch ef ar ôl y digwyddiad cysylltiedig.

output_height · number

Gwerth cyfredol yr eitem a ddewiswyd. Darllenwch ef ar ôl y digwyddiad cysylltiedig.

output_bytes · number

Gwerth cyfredol yr eitem a ddewiswyd. Darllenwch ef ar ôl y digwyddiad cysylltiedig.

output_mime · text

Gwerth cyfredol yr eitem a ddewiswyd. Darllenwch ef ar ôl y digwyddiad cysylltiedig.

error_code · text

Gwybodaeth gwall am y weithred diwethaf. Dangoswch neges ddefnyddiol a chynnig y ceisiad ailadrodd perthnasol.

crop_active · yes_no

Gwerth cyfredol yr eitem a ddewiswyd. Darllenwch ef ar ôl y digwyddiad cysylltiedig.

crop_rect_json · text

Gwerth cyfredol yr eitem a ddewiswyd. Darllenwch ef ar ôl y digwyddiad cysylltiedig.

Digwyddiadau

source_loaded

Pan fydd y digwyddiad hwn yn digwydd, darllenwch y cyflyrau cysylltiedig o'r un elfen.

source_load_failed

Pan fydd y digwyddiad hwn yn digwydd, darllenwch y cyflyrau cysylltiedig o'r un elfen.

edit_applied

Pan fydd y digwyddiad hwn yn digwydd, darllenwch y cyflyrau cysylltiedig o'r un elfen.

edit_undone

Pan fydd y digwyddiad hwn yn digwydd, darllenwch y cyflyrau cysylltiedig o'r un elfen.

edit_redone

Pan fydd y digwyddiad hwn yn digwydd, darllenwch y cyflyrau cysylltiedig o'r un elfen.

editor_reset

Pan fydd y digwyddiad hwn yn digwydd, darllenwch y cyflyrau cysylltiedig o'r un elfen.

export_started

Pan fydd y digwyddiad hwn yn digwydd, darllenwch y cyflyrau cysylltiedig o'r un elfen.

export_completed

Pan fydd y digwyddiad hwn yn digwydd, darllenwch y cyflyrau cysylltiedig o'r un elfen.

operation_cancelled

Pan fydd y digwyddiad hwn yn digwydd, darllenwch y cyflyrau cysylltiedig o'r un elfen.

editor_error

Pan fydd y digwyddiad hwn yn digwydd, darllenwch y cyflyrau cysylltiedig o'r un elfen.

Cwestiynau y mae datblygwyr yn eu gofyn

A yw output_uri yn ffeil Bubble?

Na. Mae'n lwybr storfa lleol. Cadwch hi trwy arbedwr lleol profi neu lwythwr cyn storio cyfeiriad ffeil cwmwl.

Sut mae'r tanysgrifiad yn gweithio?

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.

Canllawiau cysylltiedig

Am gymorth, dywedwch wrthym pa ategyn a dyfais rydych chi'n eu defnyddio, y weithred a cheisiwyd a beth ddigwyddodd. Defnyddiwch enghraifft heb ddata personol. Peidiwch byth â rhannu eich allwedd na'ch ffeiliau preifat.