Xodera Plugins · Bubble Native
Xodera Photo Editor Native
Shndërroni një foto të zgjedhur në një avatar të qëndrueshëm, imazh produkti ose bashkëngjitje raporti. Prijeni, rrotulloni dhe ndryshoni përmasat, pastaj ruani kopjen e eksportuar në aplikacionin tuaj.
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.
Dokumentacioni i rishikuar 6 November 2026
Shembuj praktikë
Avatarë profili të qëndrueshëm përpara ngarkimit
Përdoruesit duhet të zgjedhin cili pjesë e fotos së tyre shfaqet në një imazh profili katror, në vend që të pranojnë një prerje arbitrare.
`source_url = selected profile image`; `crop_aspect = "1:1"`; `document_context = the account’s stable reference`.
Prisni për `source_loaded`; Begin crop → Apply crop, me Rotate ose Undo sipas nevojës. Kur përdoruesi zgjedh Save shprehimisht, ekzekutoni Export image.
Vetëm në `export_completed`, përdorni `output_uri`, `output_width`, `output_height` dhe `output_mime` si hyrje në rrjedhën tuaj të ngarkimit të skedarëve. Ruani referencën e qëndrueshme te Profili më pas.
Nëse përdoruesi anullon ose `editor_error` aktivizohet, mbani avatarin e vjetër. Pastroni sesionin në ndryshimin e llogarisë që një përdorues tjetër të mos shohë draftin.
Redaktimi krijon një kopje lokale. Aplikacioni juaj zgjedh si ta ruajë ose ta ngarkojë atë.
Përgatitni foto të qëndrueshme për tregun ose katalogun
Kornizat e ndryshme dhe imazhet me përmasa tepër të mëdha e bëjnë katalogun jo uniform dhe rrisin madhësinë e ngarkimit.
`source_url = selected item photo`; `crop_aspect = the app’s chosen ratio`; `export_max_dimension`, `export_format` dhe `export_quality` vijnë nga politika juaj e ngarkimit.
Prenini zonën përkatëse, opsionalisht Resize, pastaj Export image pasi përdoruesi konfirmon. Mbani skedarin/referencën origjinale veçmas.
Kontrolloni `output_width`, `output_height`, `output_bytes` dhe `output_mime` përpara se rrjedha juaj e ngarkimit të ruajë rezultatin. Ruani referencën e imazhit të rezultuar në Artikull.
Nëse eksporti dështojë ose rezultati shkel politikën tuaj të ngarkimit, shfaqni `error_code` dhe lejoni përdoruesin ta rishikojë. Mos e mbishkruani imazhin e mëparshëm të Artikullit përpara konfirmimit të ngarkimit.
Redaktimi krijon një kopje lokale. Aplikacioni juaj zgjedh si ta ruajë ose ta ngarkojë atë.
Krijoni një kopje imazhi që përqendrohet te detaji për një raport nga terreni
Një teknik mund të ketë nevojë për një foto të afërt të një pjese të dëmtuar, duke ruajtur imazhin origjinal të raportit.
`source_url = Current Report Photo’s source`; `document_context = the report/account reference`; raporti i prerjes mund të mbetet i pakufizuar.
Begin crop → Apply crop, pastaj përdorni Undo/Redo për të krahasuar ndryshimet. Export image krijon kopjen e redaktuar; aplikacioni juaj pyet nëse të bashkëngjitet ajo kopje te Raporti.
Përdorni `has_changes`, `can_undo`, `can_redo` dhe `output_uri`. Ruani referencat origjinale dhe të redaktuara në fusha të veçanta të aplikacionit pas një ngarkimi të suksesshëm.
Cancel crop ose Reset edits rikthen rrugën e redaktimit; anulimi duhet të lërë bashkëngjitjen origjinale të Raportit të pandryshuar.
Redaktimi krijon një kopje lokale. Aplikacioni juaj zgjedh si ta ruajë ose ta ngarkojë atë.
Çfarë funksionon tani
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.
Krijoni rrjedhën e punës
Përdorni veprimet beta të disponueshme më poshtë dhe testoni rezultatin në pajisjet tuaja të synuara.
Këto shembuj përdorin regjistrime aplikacioni si Lesson, Message dhe Order. Zëvendësoni ato me llojet tuaja të të dhënave dhe emrat e elementeve. Adresat e mediave shembull duhet të zëvendësohen me skedarët tuaj.
Caktoni source_url në imazhin e zgjedhur. Përdorni document_context për të identifikuar llogarinë dhe regjistrin që po redaktohet, kështu që ndryshimi i regjistrit pastron foton e mëparshme nga redaktori.
Pas source_loaded, ekzekutoni Begin crop. Zgjidhni 1:1 për një avatar, rregulloni prerjen dhe përdorni Apply crop. Cancel crop lë imazhin të pandryshuar.
Përdorni Rotate, Flip ose Resize nëse është e nevojshme. Undo dhe Redo kalojnë nëpër redaktimet e përfunduara; Reset edits rikthen imazhin origjinal.
Ekzekutoni Export image. Në export_completed, lexoni output_uri, output_width, output_height dhe output_mime. Ruani ose ngarkoni atë kopje duke përdorur rrjedhën e punës për ruajtjen e skedarëve që keni zgjedhur, më pas ruani skedarin e ruajtur në regjistër.
Konfigurojeni një herë
Aktivizimi i çelësit është i planifikuar për këtë plugin. Krijoni ose zgjidhni projektin tuaj të aplikacionit Bubble në BestPlugins → Dashboard → Plugins. Zgjidhni Xodera Photo Editor Native, kopjoni çelësin e tij, pastaj hapni Bubble → Plugins → Xodera Photo Editor Native dhe ngjitni në licensing_api_key. Ruani një herë; më pas përdorni veprimet më poshtë. Çdo plugin në çdo projekt ka çelësin e vet.
Zgjidhni ose kapni imazhin me aplikacionin tuaj së pari. Jepni redaktorit adresën e imazhit të lexueshëm që rezulton. Lejet për kamerën dhe bibliotekën e fotove i përkasin zgjedhësit që përdorni.
Konfigurojeni një herë
- Krijoni ose zgjidhni projektin tuaj të aplikacionit Bubble në BestPlugins → Dashboard → Plugins.
- Zgjidhni këtë shtojcë dhe kopjoni çelësin e projektit.
- Open Bubble → Plugins → this plugin. Paste its project key into licensing_api_key and save.
- Shtoni elementin, zgjidhni të dhënat e aplikacionit tuaj dhe ndërtoni rrjedhën e punës më poshtë.
- 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.
Instalim dhe abonim
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.
Ruani rezultatin në aplikacionin tuaj
Ruani imazhin e ngarkuar ose të ruajtur në mënyrë permanente në Profile.image ose në fushën tuaj të bashkëngjitjes. output_uri është një skedar i përkohshëm në pajisje, ndaj së pari ruani atë skedar me rrjedhën e punës që keni zgjedhur. Më pas ruani output_width, output_height dhe output_mime si metadata. Mbani imazhin origjinal nëse ju duhen të dyja versionet.
Dështim, anulim dhe rikuperim
Në source_load_failed ose editor_error, shfaqni error_code dhe ofroni Load source. Cancel operation ndalon pranimin e rezultatit të paplotë; prisni deri në is_busy=no përpara se të filloni një redaktim tjetër. Clear session pastron redaktorin, jo një imazh që tashmë është ruajtur diku tjetër.
Aftësitë dhe kufizimet
JPEG dhe PNG eksportojnë; cilësia 0–1; ana maksimale e daljes 1–4096 piksela. Hyrja: deri në 15 MiB dhe 20 megapiksela. Deri në 20 redaktime të përfunduara. Zgjedhjet e prerjes: free, 1:1, 4:3, 3:4 dhe 16:9. Pa kamerë të integruar, filtra, shtresa teksti, korrigjim perspektive, eksport WebP ose ngarkim automatik.
Rregullimet, veprimet dhe rezultatet
Përdorni këto emra në Bubble. Veçoritë e planifikuara janë shënuar veçmas.
Cilësimet beta të disponueshme
Rregullimet e elementit
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 · textGjendjet
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 · textNgjarjet
source_loadedsource_load_failededit_appliededit_undoneedit_redoneeditor_resetexport_startedexport_completedoperation_cancellededitor_errorVeprimet dhe inputet e tyre
Load sourceBegin cropApply cropCancel cropRotateFlipResizeUndoRedoReset editsExport imageCancel operationClear sessionRregullimet e elementit · 12
source_urltext · Parazgjedhur: ""- Vlera shembull
https://bestplugins.online/native-samples/avatar.jpg - Shembull i shprehjes Bubble
Selected Profile's image_url - Adresa e skedarit audio, video ose imazhi të zgjedhur. Përdorni një lloj skedari që ky shtojcë mbulon.
document_contexttext · Parazgjedhur: ""- Vlera shembull
<current-user-id> - Shembull i shprehjes Bubble
Current User's unique id - Vlerë e qëndrueshme për këtë llogari ose rekord. Përdorni të njëjtën vlerë kur riktheni skedarët ose skicat e ruajtur.
is_activeyes_no · Parazgjedhur: true- Vlera shembull
yes - Shembull i shprehjes Bubble
GuideHost's view_is_active (your yes/no custom state) - Vendosni yes ndërsa kjo pamje është e hapur. Vendosni no kur dilni, në mënyrë që riprodhimi ose puna aktuale të mund të ndalojë.
disabledyes_no · Parazgjedhur: false- Vlera shembull
no - Shembull i shprehjes Bubble
GuideHost's is_busy (your yes/no custom state) - Çaktivizo elementin ndërsa aplikacioni juaj është i zënë ose kjo veprim është i padisponueshëm.
show_controlsyes_no · Parazgjedhur: true- Vlera shembull
yes - Shembull i shprehjes Bubble
App Settings' show_editor_controls - Trego ose fshih kontrollet e integruara.
crop_aspecttext · Parazgjedhur: "free"- Vlera shembull
1:1 - Shembull i shprehjes Bubble
Avatar Settings' crop_ratio - Përdorni vlerën e regjistrimit aktual të biznesit; verifikojeni kundrejt kufijve më poshtë.
export_formattext · Parazgjedhur: "jpeg"- Vlera shembull
jpeg - Shembull i shprehjes Bubble
Format Dropdown's value - Përdorni vlerën e regjistrimit aktual të biznesit; verifikojeni kundrejt kufijve më poshtë.
export_qualitynumber · Parazgjedhur: 0.85- Vlera shembull
0.85 - Shembull i shprehjes Bubble
Image Settings' quality - Përdorni vlerën e regjistrimit aktual të biznesit; verifikojeni kundrejt kufijve më poshtë.
export_max_dimensionnumber · Parazgjedhur: 2048- Vlera shembull
2048 - Shembull i shprehjes Bubble
Image Settings' max_side - Përdorni vlerën e regjistrimit aktual të biznesit; verifikojeni kundrejt kufijve më poshtë.
allow_upscaleyes_no · Parazgjedhur: false- Vlera shembull
no - Shembull i shprehjes Bubble
Allow upscale Checkbox is checked - Përdorni vlerën e regjistrimit aktual të biznesit; verifikojeni kundrejt kufijve më poshtë.
ui_text_jsontext · Parazgjedhur: ""- Vlera shembull
{} - Shembull i shprehjes Bubble
App Settings' player_labels_json (supported keys only) - JSON opsionale me etiketa butonash të mbështetura. Lëreni bosh për të përdorur tekstin e brendshëm.
languagetext · Parazgjedhur: "auto"- Vlera shembull
uk - Shembull i shprehjes Bubble
Current User's preferred_language - Vendosni language=auto për të ndjekur gjuhën e pajisjes ose të shfletuesit, nëse ajo mbështetet. Futni një kod gjuhe të mbështetur për ta zgjedhur gjuhën shprehimisht.
Veprimet dhe inputet e tyre · 13
Load source
Pa parametra veprimi
Begin crop
Pa parametra veprimi
Apply crop
origin_xnumber · Parazgjedhur: —- Vlera shembull
0 - Shembull i shprehjes Bubble
Crop Settings' x (or omit all rectangle inputs) - Përdorni vlerën e regjistrimit aktual të biznesit; verifikojeni kundrejt kufijve më poshtë.
origin_ynumber · Parazgjedhur: —- Vlera shembull
0 - Shembull i shprehjes Bubble
Crop Settings' y (or omit all rectangle inputs) - Përdorni vlerën e regjistrimit aktual të biznesit; verifikojeni kundrejt kufijve më poshtë.
widthnumber · Parazgjedhur: —- Vlera shembull
512 - Shembull i shprehjes Bubble
Resize Width Input's value:converted to number - Përdorni vlerën e regjistrimit aktual të biznesit; verifikojeni kundrejt kufijve më poshtë.
heightnumber · Parazgjedhur: —- Vlera shembull
512 - Shembull i shprehjes Bubble
Resize Height Input's value:converted to number - Përdorni vlerën e regjistrimit aktual të biznesit; verifikojeni kundrejt kufijve më poshtë.
Cancel crop
Pa parametra veprimi
Rotate
degreesnumber · Parazgjedhur: —- Vlera shembull
90 - Shembull i shprehjes Bubble
Rotation Dropdown's value - Përdorni vlerën e regjistrimit aktual të biznesit; verifikojeni kundrejt kufijve më poshtë.
Flip
axistext · Parazgjedhur: —- Vlera shembull
horizontal - Shembull i shprehjes Bubble
Flip Direction Dropdown's value - Përdorni vlerën e regjistrimit aktual të biznesit; verifikojeni kundrejt kufijve më poshtë.
Resize
widthnumber · Parazgjedhur: —- Vlera shembull
512 - Shembull i shprehjes Bubble
Resize Width Input's value:converted to number - Përdorni vlerën e regjistrimit aktual të biznesit; verifikojeni kundrejt kufijve më poshtë.
heightnumber · Parazgjedhur: —- Vlera shembull
512 - Shembull i shprehjes Bubble
Resize Height Input's value:converted to number - Përdorni vlerën e regjistrimit aktual të biznesit; verifikojeni kundrejt kufijve më poshtë.
Undo
Pa parametra veprimi
Redo
Pa parametra veprimi
Reset edits
Pa parametra veprimi
Export image
Pa parametra veprimi
Cancel operation
Pa parametra veprimi
Clear session
Pa parametra veprimi
Gjendjet dhe ngjarjet
Gjendjet
editor_status · textRezultati aktual i kësaj veprimi. Përdorni ngjarjen përfundimtare përkatëse përpara se të ruani suksesin.
is_busy · yes_noPuna është ende në zhvillim. Prisni përpara se të filloni një veprim tjetër.
has_image · yes_noVlera aktuale për elementin e zgjedhur. Lexojeni pas ngjarjes përkatëse.
has_changes · yes_noVlera aktuale për elementin e zgjedhur. Lexojeni pas ngjarjes përkatëse.
can_undo · yes_noVlera aktuale për elementin e zgjedhur. Lexojeni pas ngjarjes përkatëse.
can_redo · yes_noVlera aktuale për elementin e zgjedhur. Lexojeni pas ngjarjes përkatëse.
image_width · numberVlera aktuale për elementin e zgjedhur. Lexojeni pas ngjarjes përkatëse.
image_height · numberVlera aktuale për elementin e zgjedhur. Lexojeni pas ngjarjes përkatëse.
output_uri · textVendndodhja e skedarit në këtë pajisje. Ruani ose ngarkoni skedarin veçmas nëse duhet të mbahet online.
output_width · numberVlera aktuale për elementin e zgjedhur. Lexojeni pas ngjarjes përkatëse.
output_height · numberVlera aktuale për elementin e zgjedhur. Lexojeni pas ngjarjes përkatëse.
output_bytes · numberVlera aktuale për elementin e zgjedhur. Lexojeni pas ngjarjes përkatëse.
output_mime · textVlera aktuale për elementin e zgjedhur. Lexojeni pas ngjarjes përkatëse.
error_code · textInformacioni i gabimit për veprimin e fundit. Shfaqni një mesazh i dobishëm dhe ofroni riprovimin përkatës.
crop_active · yes_noVlera aktuale për elementin e zgjedhur. Lexojeni pas ngjarjes përkatëse.
crop_rect_json · textVlera aktuale për elementin e zgjedhur. Lexojeni pas ngjarjes përkatëse.
Ngjarjet
source_loadedKur ndodh kjo ngjarje, lexoni gjendjet përkatëse nga i njëjti element.
source_load_failedKur ndodh kjo ngjarje, lexoni gjendjet përkatëse nga i njëjti element.
edit_appliedKur ndodh kjo ngjarje, lexoni gjendjet përkatëse nga i njëjti element.
edit_undoneKur ndodh kjo ngjarje, lexoni gjendjet përkatëse nga i njëjti element.
edit_redoneKur ndodh kjo ngjarje, lexoni gjendjet përkatëse nga i njëjti element.
editor_resetKur ndodh kjo ngjarje, lexoni gjendjet përkatëse nga i njëjti element.
export_startedKur ndodh kjo ngjarje, lexoni gjendjet përkatëse nga i njëjti element.
export_completedKur ndodh kjo ngjarje, lexoni gjendjet përkatëse nga i njëjti element.
operation_cancelledKur ndodh kjo ngjarje, lexoni gjendjet përkatëse nga i njëjti element.
editor_errorKur ndodh kjo ngjarje, lexoni gjendjet përkatëse nga i njëjti element.
Pyetjet që bëjnë zhvilluesit
A është output_uri një Bubble File?
Jo. Është një shteg në cache lokale. Ruajeni skedarin në mënyrë të qëndrueshme me një proces të provuar ruajtjeje lokale ose ngarkimi, përpara se të ruani referencën e skedarit në re.
Si funksionon abonimi?
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.
Udhëzues të lidhur
Për ndihmë, na tregoni cilin shtojcë dhe pajisje përdorni, veprimin që provuat dhe çfarë ndodhi. Përdorni një shembull pa të dhëna personale. Kurrë mos ndani çelësin tuaj ose skedarët privatë.