Kiolesura cha awali cha Photo Editor katika programu ya Bubble Native. Uhariri na utoaji wa faili katika beta ya sasa bado vinajaribiwa.
Kiolesura cha awali cha Photo Editor katika programu ya Bubble Native. Uhariri na utoaji wa faili katika beta ya sasa bado vinajaribiwa.
← Miongozo yote ya Bubble Native

Xodera Plugins · Bubble Native

Xodera Photo Editor Native

Geuza picha iliyochaguliwa kuwa avatar, picha ya bidhaa au kiambatisho cha ripoti kinacholingana. Ikate, izungushe na irekebishe ukubwa, kisha hifadhi nakala iliyosafirishwa katika programu yako.

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.

Nyaraka zilizokaguliwa 6 Novemba 2026

Mifano ya vitendo

Avatari za wasifu zenye mwonekano unaolingana kabla ya kupakia

Watumiaji wanapaswa kuchagua sehemu gani ya picha yao itaonekana katika picha ya wasifu ya mraba badala ya kukubali kukatwa kwa hiari.

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

Subiri `source_loaded`; Begin crop → Apply crop, ukitumia Rotate au Undo inapohitajika. Mtumiaji akichagua Save waziwazi, endesha Export image.

Tu kwenye `export_completed`, tumia `output_uri`, `output_width`, `output_height` na `output_mime` kama ingizo kwa mtiririko wako wa kupakia faili. Hifadhi rejea yake imara kwenye Wasifu baadaye.

Kama mtumiaji ataghairi au `editor_error` itatokea, weka avatar ya zamani. Safisha kikao wakati wa mabadiliko ya akaunti ili mtumiaji mwingine asiweze kuona rasimu.

Uhariri huunda nakala ya ndani. Programu yako inaamua jinsi ya kuihifadhi au kuiapakisha.

Tayarisha picha za soko au katalogi zenye mwonekano unaolingana

Fremu tofauti na picha kubwa sana hufanya katalogi isiyo sawa na kuongeza ukubwa wa upakiaji.

`source_url = selected item photo`; `crop_aspect = the app’s chosen ratio`; `export_max_dimension`, `export_format` na `export_quality` hutokana na sera yako ya upakiaji.

Kata eneo husika, kwa hiari Resize, kisha Export image baada ya mtumiaji kuthibitisha. Hifadhi faili/rejea ya awali kando.

Angalia `output_width`, `output_height`, `output_bytes` na `output_mime` kabla ya mtiririko wako wa upakiaji kuhifadhi matokeo. Hifadhi rejea ya picha iliyotokana kwenye rekodi ya Item.

Kama usafirishaji unashindwa au matokeo yanavunja sera yako ya upakiaji, onyesha `error_code` na uruhusu mtumiaji kuurekebisha. Usibadilishe picha ya awali ya rekodi ya Item kabla ya uthibitisho wa upakiaji.

Uhariri huunda nakala ya ndani. Programu yako inaamua jinsi ya kuihifadhi au kuiapakisha.

Unda nakala ya picha iliyo na umakini kwa ripoti ya uga

Fundisi anaweza kuhitaji picha ya karibu ya sehemu moja iliyoharibika huku akihifadhi picha ya asili ya ripoti.

`source_url = Current Report Photo’s source`; `document_context = the report/account reference`; uwiano wa kukata unaweza kubaki usio na vikwazo.

Begin crop → Apply crop, kisha tumia Undo/Redo kulinganisha mabadiliko. Export image huunda nakala iliyorekebishwa; programu yako inauliza kama itaambatanisha nakala hiyo kwenye Ripoti.

Tumia `has_changes`, `can_undo`, `can_redo` na `output_uri`. Hifadhi rejea za awali na zilizorekebishwa katika sehemu tofauti za programu baada ya upakiaji wenye mafanikio.

Cancel crop au Reset edits hurudisha njia ya uhariri; kughairi lazima kuacha kiambatisho cha Ripoti asili kisichobadilika.

Uhariri huunda nakala ya ndani. Programu yako inaamua jinsi ya kuihifadhi au kuiapakisha.

Kinachofanya kazi sasa

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.

Jenga mtiririko wa kazi

Tumia vitendo vya beta vinavyopatikana hapa chini na jaribu matokeo kwenye vifaa unavyolenga.

Mifano hii inatumia rekodi za programu kama Lesson, Message na Order. Zibadilishe kwa aina zako za data na majina ya vipengele. Anwani za media za mfano lazima zibadilishwe na faili zako.

  1. Weka source_url kuwa anwani ya picha iliyochaguliwa. Tumia document_context kutambua akaunti na rekodi inayohaririwa, ili rekodi ikibadilika picha ya awali iondolewe kwenye mhariri.

  2. Baada ya source_loaded, endesha Begin crop. Chagua 1:1 kwa avatar, rekebisha kukata na tumia Apply crop. Cancel crop huaacha picha bila kubadilika.

  3. Tumia Rotate, Flip au Resize ikiwa inahitajika. Undo na Redo husonga kupitia uhariri uliokamilika; Reset edits hurudisha picha asili.

  4. Endesha Export image. Katika export_completed, soma output_uri, output_width, output_height na output_mime. Hifadhi au pakia nakala hiyo kwa kutumia mtiririko wako wa kuhifadhi faili, kisha weka faili iliyohifadhiwa katika rekodi.

Mchoro wa mtiririko wa kazi — si picha ya programu

Sanidi mara moja

Uanzishaji wa ufunguo umepangwa kwa plugin hii. Unda au chagua mradi wako wa Bubble katika BestPlugins → Dashboard → Plugins. Chagua Xodera Photo Editor Native, nakili ufunguo wake, kisha fungua Bubble → Plugins → Xodera Photo Editor Native na ubandike ndani ya licensing_api_key. Hifadhi mara moja; kisha tumia vitendo vilivyo hapa chini. Kila plugin katika kila mradi ina ufunguo wake.

Chagua au piga picha kwa kutumia programu yako kwanza. Mpe mhariri anwani ya picha inayoweza kusomwa. Ruhusa za kamera na maktaba ya picha ni za mteua unaotumia.

Sanidi mara moja
  1. Unda au chagua mradi wako wa Bubble katika BestPlugins → Dashboard → Plugins.
  2. Chagua plugin hii na nakili ufunguo wa mradi wake.
  3. Open Bubble → Plugins → this plugin. Paste its project key into licensing_api_key and save.
  4. Ongeza kipengele, chagua data ya programu yako na jenga mtiririko wa kazi hapa chini.
  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.
Ufungaji na usajili

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.

Hifadhi matokeo katika programu yako

Hifadhi picha iliyopakiwa au iliyohifadhiwa kudumu katika Profile.image au sehemu yako ya kiambatisho. output_uri ni faili ya muda kwenye kifaa, hivyo kwanza hifadhi faili hiyo kwa mtiririko unaochagua. Kisha hifadhi output_width, output_height na output_mime kama metadata. Hifadhi picha asili ikiwa unahitaji matoleo yote mawili.

Kushindwa, kughairi na urejeshaji

Katika source_load_failed au editor_error, onyesha error_code na toa Load source. Cancel operation humaliza kupokea matokeo yasiyokamilika; subiri hadi is_busy=no kabla ya kuanza uhariri mwingine. Clear session husafisha mhariri, si picha iliyohifadhiwa mahali pengine.

Uwezo na vikwazo

JPEG na PNG usafirishaji; ubora 0–1; urefu wa juu zaidi wa upande wa picha inayotolewa ni pikseli 1–4096. Ingizo: hadi 15 MiB na 20 megapikseli. Hadi 20 uhariri uliokamilika. Chaguo za kukata: huru, 1:1, 4:3, 3:4 na 16:9. Hakuna kamera iliyojengwa ndani, vichujio, maandishi ya juu, usahihishaji wa mtazamo, usafirishaji wa WebP au upakiaji otomatiki.

Mipangilio, vitendo na matokeo

Tumia majina haya katika Bubble. Vipengele vilivyopangwa vimewekwa alama kando.

Mipangilio ya beta inayopatikana

Mipangilio ya kipengele

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

Hali

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

Matukio

source_loadedsource_load_failededit_appliededit_undoneedit_redoneeditor_resetexport_startedexport_completedoperation_cancellededitor_error

Vitendo na ingizo lake

Load sourceBegin cropApply cropCancel cropRotateFlipResizeUndoRedoReset editsExport imageCancel operationClear session
Mipangilio ya kipengele · 12
source_urltext · Chaguo-msingi: ""
Thamani ya mfanohttps://bestplugins.online/native-samples/avatar.jpg
Mfano wa usemi BubbleSelected Profile's image_url
Anwani ya faili ya sauti, video au picha iliyochaguliwa. Tumia aina ya faili ambayo kiendelezi hiki kinasaidia.
document_contexttext · Chaguo-msingi: ""
Thamani ya mfano<current-user-id>
Mfano wa usemi BubbleCurrent User's unique id
Thamani thabiti kwa akaunti au rekodi hii. Tumia thamani ileile wakati wa kurejesha faili au rasimu zake zilizohifadhiwa.
is_activeyes_no · Chaguo-msingi: true
Thamani ya mfanoyes
Mfano wa usemi BubbleGuideHost's view_is_active (your yes/no custom state)
Weka yes (ndiyo) wakati mwonekano huu uko wazi. Weka no (hapana) unapoondoka, ili uchezaji au kazi ya sasa viweze kusimamishwa.
disabledyes_no · Chaguo-msingi: false
Thamani ya mfanono
Mfano wa usemi BubbleGuideHost's is_busy (your yes/no custom state)
Zima kipengele wakati programu yako ina shughuli au kitendo hiki hakipatikani.
show_controlsyes_no · Chaguo-msingi: true
Thamani ya mfanoyes
Mfano wa usemi BubbleApp Settings' show_editor_controls
Onyesha au ficha vidhibiti vilivyojengwa.
crop_aspecttext · Chaguo-msingi: "free"
Thamani ya mfano1:1
Mfano wa usemi BubbleAvatar Settings' crop_ratio
Tumia thamani ya rekodi ya biashara ya sasa; thibitisha dhidi ya mipaka ifuatayo.
export_formattext · Chaguo-msingi: "jpeg"
Thamani ya mfanojpeg
Mfano wa usemi BubbleFormat Dropdown's value
Tumia thamani ya rekodi ya biashara ya sasa; thibitisha dhidi ya mipaka ifuatayo.
export_qualitynumber · Chaguo-msingi: 0.85
Thamani ya mfano0.85
Mfano wa usemi BubbleImage Settings' quality
Tumia thamani ya rekodi ya biashara ya sasa; thibitisha dhidi ya mipaka ifuatayo.
export_max_dimensionnumber · Chaguo-msingi: 2048
Thamani ya mfano2048
Mfano wa usemi BubbleImage Settings' max_side
Tumia thamani ya rekodi ya biashara ya sasa; thibitisha dhidi ya mipaka ifuatayo.
allow_upscaleyes_no · Chaguo-msingi: false
Thamani ya mfanono
Mfano wa usemi BubbleAllow upscale Checkbox is checked
Tumia thamani ya rekodi ya biashara ya sasa; thibitisha dhidi ya mipaka ifuatayo.
ui_text_jsontext · Chaguo-msingi: ""
Thamani ya mfano{}
Mfano wa usemi BubbleApp Settings' player_labels_json (supported keys only)
JSON ya hiari yenye lebo za vitufe zinazotumika. Iache tupu ili kutumia maandishi yaliyojengewa ndani.
languagetext · Chaguo-msingi: "auto"
Thamani ya mfanouk
Mfano wa usemi BubbleCurrent User's preferred_language
Weka language=auto ili kufuata lugha inayotumika ya kifaa au kivinjari. Ingiza msimbo wa lugha inayotumika ili kuichagua mwenyewe.
Vitendo na ingizo lake · 13
Load source

Hakuna vigezo vya kitendo

Begin crop

Hakuna vigezo vya kitendo

Apply crop
origin_xnumber · Chaguo-msingi: —
Thamani ya mfano0
Mfano wa usemi BubbleCrop Settings' x (or omit all rectangle inputs)
Tumia thamani ya rekodi ya biashara ya sasa; thibitisha dhidi ya mipaka ifuatayo.
origin_ynumber · Chaguo-msingi: —
Thamani ya mfano0
Mfano wa usemi BubbleCrop Settings' y (or omit all rectangle inputs)
Tumia thamani ya rekodi ya biashara ya sasa; thibitisha dhidi ya mipaka ifuatayo.
widthnumber · Chaguo-msingi: —
Thamani ya mfano512
Mfano wa usemi BubbleResize Width Input's value:converted to number
Tumia thamani ya rekodi ya biashara ya sasa; thibitisha dhidi ya mipaka ifuatayo.
heightnumber · Chaguo-msingi: —
Thamani ya mfano512
Mfano wa usemi BubbleResize Height Input's value:converted to number
Tumia thamani ya rekodi ya biashara ya sasa; thibitisha dhidi ya mipaka ifuatayo.
Cancel crop

Hakuna vigezo vya kitendo

Rotate
degreesnumber · Chaguo-msingi: —
Thamani ya mfano90
Mfano wa usemi BubbleRotation Dropdown's value
Tumia thamani ya rekodi ya biashara ya sasa; thibitisha dhidi ya mipaka ifuatayo.
Flip
axistext · Chaguo-msingi: —
Thamani ya mfanohorizontal
Mfano wa usemi BubbleFlip Direction Dropdown's value
Tumia thamani ya rekodi ya biashara ya sasa; thibitisha dhidi ya mipaka ifuatayo.
Resize
widthnumber · Chaguo-msingi: —
Thamani ya mfano512
Mfano wa usemi BubbleResize Width Input's value:converted to number
Tumia thamani ya rekodi ya biashara ya sasa; thibitisha dhidi ya mipaka ifuatayo.
heightnumber · Chaguo-msingi: —
Thamani ya mfano512
Mfano wa usemi BubbleResize Height Input's value:converted to number
Tumia thamani ya rekodi ya biashara ya sasa; thibitisha dhidi ya mipaka ifuatayo.
Undo

Hakuna vigezo vya kitendo

Redo

Hakuna vigezo vya kitendo

Reset edits

Hakuna vigezo vya kitendo

Export image

Hakuna vigezo vya kitendo

Cancel operation

Hakuna vigezo vya kitendo

Clear session

Hakuna vigezo vya kitendo

Hali na matukio

Hali

editor_status · text

Matokeo ya sasa ya kitendo hiki. Tumia tukio la kukamilika linalolingana kabla ya kuhifadhi mafanikio.

is_busy · yes_no

Kazi bado inaendelea. Subiri kabla ya kuanza kitendo kingine.

has_image · yes_no

Thamani ya sasa ya kipengele kilichochaguliwa. Isome baada ya tukio linalohusiana.

has_changes · yes_no

Thamani ya sasa ya kipengele kilichochaguliwa. Isome baada ya tukio linalohusiana.

can_undo · yes_no

Thamani ya sasa ya kipengele kilichochaguliwa. Isome baada ya tukio linalohusiana.

can_redo · yes_no

Thamani ya sasa ya kipengele kilichochaguliwa. Isome baada ya tukio linalohusiana.

image_width · number

Thamani ya sasa ya kipengele kilichochaguliwa. Isome baada ya tukio linalohusiana.

image_height · number

Thamani ya sasa ya kipengele kilichochaguliwa. Isome baada ya tukio linalohusiana.

output_uri · text

Mahali pa faili kwenye kifaa hiki. Hifadhi au pakia faili kando ikiwa lazima iwe kwenye mtandaoni.

output_width · number

Thamani ya sasa ya kipengele kilichochaguliwa. Isome baada ya tukio linalohusiana.

output_height · number

Thamani ya sasa ya kipengele kilichochaguliwa. Isome baada ya tukio linalohusiana.

output_bytes · number

Thamani ya sasa ya kipengele kilichochaguliwa. Isome baada ya tukio linalohusiana.

output_mime · text

Thamani ya sasa ya kipengele kilichochaguliwa. Isome baada ya tukio linalohusiana.

error_code · text

Taarifa ya hitilafu ya kitendo cha mwisho. Onyesha ujumbe wenye msaada na utoe chaguo linalofaa la kujaribu tena.

crop_active · yes_no

Thamani ya sasa ya kipengele kilichochaguliwa. Isome baada ya tukio linalohusiana.

crop_rect_json · text

Thamani ya sasa ya kipengele kilichochaguliwa. Isome baada ya tukio linalohusiana.

Matukio

source_loaded

Wakati tukio hili litapotokea, soma hali husika kutoka kwa kipengele hicho.

source_load_failed

Wakati tukio hili litapotokea, soma hali husika kutoka kwa kipengele hicho.

edit_applied

Wakati tukio hili litapotokea, soma hali husika kutoka kwa kipengele hicho.

edit_undone

Wakati tukio hili litapotokea, soma hali husika kutoka kwa kipengele hicho.

edit_redone

Wakati tukio hili litapotokea, soma hali husika kutoka kwa kipengele hicho.

editor_reset

Wakati tukio hili litapotokea, soma hali husika kutoka kwa kipengele hicho.

export_started

Wakati tukio hili litapotokea, soma hali husika kutoka kwa kipengele hicho.

export_completed

Wakati tukio hili litapotokea, soma hali husika kutoka kwa kipengele hicho.

operation_cancelled

Wakati tukio hili litapotokea, soma hali husika kutoka kwa kipengele hicho.

editor_error

Wakati tukio hili litapotokea, soma hali husika kutoka kwa kipengele hicho.

Maswali yanayoulizwa na wasanidi programu

Je, output_uri ni Faili la Bubble?

Hapana. Hii ni njia ya faili katika akiba ya ndani ya kifaa. Ihifadhi kwa kudumu kupitia zana iliyothibitishwa ya kuhifadhi kwenye kifaa au kupakia faili, kabla ya kuhifadhi rejea ya faili ya wingu.

Usajili unafanya kazi vipi?

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.

Miongozo husika

Kwa msaada, tuambie plugin na kifaa unachotumia, kitendo ulichojaribu na kilichotokea. Tumia mfano usio na data binafsi. Usishiriki ufunguo wako wala faili za kibinafsi.