
Xodera Plugins · Bubble Native
Xodera Photo Editor Native
Pārvērtiet izvēlēto fotoattēlu par konsekventu avatāru, produkta attēlu vai pārskata pielikumu. Apgrieziet, pagrieziet un mainiet tā izmērus, pēc tam saglabājiet eksportēto kopiju savā lietotnē.
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.
Dokumentācija pārskatīta 6 novembrī 2026
Praktiski piemēri
Vienotas profila avatāri pirms augšupielādes
Lietotājiem jāizvēlas, kura foto daļa tiek parādīta kvadrātiskā profila attēlā, nevis jāpieņem patvaļīgs apgrieztums.
`source_url = selected profile image`; `crop_aspect = "1:1"`; `document_context = the account’s stable reference`.
Pagaidiet uz `source_loaded`; Begin crop → Apply crop, vajadzības gadījumā ar Rotate vai Undo. Pie skaidras saglabāšanas, Export image.
Tikai `export_completed` laikā, izmantojiet `output_uri`, `output_width`, `output_height` un `output_mime` kā ievades savā failu augšupielādes darbplūsmā. Pēc tam saglabājiet tās izturīgo atsauci profilā.
Ja lietotājs atceļ vai `editor_error` tiek aktivizēts, saglabājiet veco avatāru. Notīriet sesiju konta maiņas gadījumā, lai cits lietotājs nevarētu redzēt melnrakstu.
Rediģēšana izveido lokālu kopiju. Jūsu lietotne izvēlas, kā to saglabāt vai augšupielādēt.
Sagatavojiet vienotus tirgus vai kataloga fotoattēlus
Dažādas ietvari un pārāk lieli attēli padara katalogu nevienmērīgu un palielina augšupielādes apjomu.
`source_url = selected item photo`; `crop_aspect = the app’s chosen ratio`; `export_max_dimension`, `export_format` un `export_quality` nāk no jūsu augšupielādes politikas.
Apgrieziet attiecīgo apgabalu, pēc izvēles Resize, pēc tam Export image, kad lietotājs apstiprina. Saglabājiet oriģinālo failu/atsauci atsevišķi.
Pārbaudiet `output_width`, `output_height`, `output_bytes` un `output_mime` pirms jūsu augšupielādes darbplūsma saglabā rezultātu. Saglabājiet izveidotās attēla atsauci priekšmetā.
Ja eksportēšana neizdodas vai rezultāts pārkāpj jūsu augšupielādes politiku, parādiet `error_code` un ļaujiet lietotājam to labot. Nepārrakstiet iepriekšējo priekšmeta attēlu pirms augšupielādes apstiprinājuma.
Rediģēšana izveido lokālu kopiju. Jūsu lietotne izvēlas, kā to saglabāt vai augšupielādēt.
Izveidojiet fokusētu attēla kopiju lauka ziņojumam
Tehniķim var būt vajadzīgs tuvplāns vienam bojātam daļai, saglabājot oriģinālo ziņojuma attēlu.
`source_url = Current Report Photo’s source`; `document_context = the report/account reference`; apgriešanas attiecība var palikt neierobežota.
Begin crop → Apply crop, pēc tam izmantojiet Undo/Redo, lai salīdzinātu labojumus. Export image izveido rediģēto kopiju; jūsu lietotne jautā, vai pievienot šo kopiju ziņojumam.
Izmantojiet `has_changes`, `can_undo`, `can_redo` un `output_uri`. Pēc veiksmīgas augšupielādes saglabājiet oriģinālo un rediģēto atsauci atsevišķos lietotnes laukos.
Cancel crop vai Reset edits atjauno rediģēšanas ceļu; atcelšana jāatstāj sākotnējais Report pielikums nemainīts.
Rediģēšana izveido lokālu kopiju. Jūsu lietotne izvēlas, kā to saglabāt vai augšupielādēt.
Kas pašlaik darbojas
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.
Izveidojiet darbplūsmu
Izmantojiet zemāk pieejamās beta darbības un pārbaudiet rezultātu savās mērķierīcēs.
Šie piemēri izmanto lietotnes ierakstus, piemēram, Lesson, Message un Order. Aizstājiet tos ar saviem datu tipiem un elementu nosaukumiem. Piemēru multivides adreses jāaizstāj ar jūsu failiem.
Iestatiet source_url uz izvēlēto attēlu. Izmantojiet document_context, lai identificētu kontu un rediģējamo ierakstu, tāpēc ieraksta maiņa notīra iepriekšējo foto.
Pēc source_loaded palaidiet Begin crop. Izvēlieties 1:1 avatāram, pielāgojiet apgriešanu un izmantojiet Apply crop. Cancel crop atstāj attēlu nemainītu.
Izmantojiet Rotate, Flip vai Resize, ja nepieciešams. Undo un Redo pārvietojas cauri pabeigtajām rediģēm; Reset edits atjauno oriģinālo attēlu.
Izpildiet Export image. export_completed laikā nolasiet output_uri, output_width un output_height, kā arī output_mime. Saglabājiet vai augšupielādējiet šo kopiju, izmantojot izvēlēto failu saglabāšanas darbplūsmu, pēc tam saglabājiet saglabāto failu ierakstā.
Konfigurējiet vienreiz
Atslēgas aktivēšana ir plānota šim spraudnim. Izveidojiet vai izvēlieties savu Bubble lietotnes projektu BestPlugins → Dashboard → Plugins. Izvēlieties Xodera Photo Editor Native, nokopējiet tā atslēgu, pēc tam atveriet Bubble → Plugins → Xodera Photo Editor Native un ielīmējiet to licensing_api_key. Saglabājiet vienreiz; pēc tam izmantojiet zemāk redzamās darbības. Katram spraudnim katrā projektā ir sava atslēga.
Vispirms izvēlieties vai uzņemiet attēlu ar savu lietotni. Nododiet redaktoram iegūto lasāmo attēla adresi. Kameras un foto bibliotēkas atļaujas pieder pie izvēlētāja, ko izmantojat.
Konfigurējiet vienreiz
- Izveidojiet vai izvēlieties savu Bubble lietotnes projektu vietnē BestPlugins → Dashboard → Plugins.
- Izvēlieties šo spraudni un nokopējiet tā projekta atslēgu.
- Open Bubble → Plugins → this plugin. Paste its project key into licensing_api_key and save.
- Pievienojiet elementu, izvēlieties savus lietotnes datus un izveidojiet zemāk redzamo darbplūsmu.
- 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.
Instalēšana un abonements
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.
Saglabājiet rezultātu savā lietotnē
Saglabājiet augšupielādēto vai pastāvīgi saglabāto attēlu Profile.image vai savā pievienojuma laukā. output_uri ir pagaidu fails ierīcē, tāpēc vispirms saglabājiet šo failu ar izvēlēto darbplūsmu. Pēc tam saglabājiet output_width, output_height un output_mime kā metadatus. Saglabājiet oriģinālo attēlu, ja jums vajag abas versijas.
Kļūda, atcelšana un atjaunošana
Uz source_load_failed vai editor_error parādiet error_code un piedāvājiet Load source. Cancel operation pārtrauc pieņemt nepabeigto rezultātu; pagaidiet līdz is_busy=no, pirms sākt nākamo rediģēšanu. Clear session notīra redaktoru, nevis jau citur saglabāto attēlu.
Iespējas un ierobežojumi
JPEG un PNG eksportē; kvalitāte 0–1; maksimālais izvades malas izmērs 1–4096 pikseļi. Ievade: līdz 15 MiB un 20 megapikseļi. Līdz 20 pabeigtām rediģēm. Apgriešanas iespējas: brīva, 1:1, 4:3, 3:4 un 16:9. Nav iebūvētas kameras, filtru, teksta pārklājumu, perspektīvas korekcijas, WebP eksportēšanas vai automātiskās augšupielādes.
Iestatījumi, darbības un rezultāti
Izmantojiet šos nosaukumus Bubble. Plānotās funkcijas ir atzīmētas atsevišķi.
Pieejamie beta iestatījumi
Elementa iestatījumi
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 · textStāvokļi
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 · textNotikumi
source_loadedsource_load_failededit_appliededit_undoneedit_redoneeditor_resetexport_startedexport_completedoperation_cancellededitor_errorDarbības un to ievades
Load sourceBegin cropApply cropCancel cropRotateFlipResizeUndoRedoReset editsExport imageCancel operationClear sessionElementa iestatījumi · 12
source_urltext · Noklusējums: ""- Piemēra vērtība
https://bestplugins.online/native-samples/avatar.jpg - Piemērs Bubble izteiksmei
Selected Profile's image_url - Atlasītā audio, video vai attēla faila adrese. Izmantojiet faila tipu, ko šis spraudnis atbalsta.
document_contexttext · Noklusējums: ""- Piemēra vērtība
<current-user-id> - Piemērs Bubble izteiksmei
Current User's unique id - Stabila vērtība šim kontam vai ierakstam. Izmantojiet to pašu vērtību, atjaunojot saglabātos failus vai melnrakstus.
is_activeyes_no · Noklusējums: true- Piemēra vērtība
yes - Piemērs Bubble izteiksmei
GuideHost's view_is_active (your yes/no custom state) - Iestatiet jā, kamēr šis skats ir atvērts. Iestatiet nē, kad iziet, lai atskaņošana vai pašreizējais darbs varētu apturēties.
disabledyes_no · Noklusējums: false- Piemēra vērtība
no - Piemērs Bubble izteiksmei
GuideHost's is_busy (your yes/no custom state) - Atspējojiet elementu, kamēr jūsu lietotne ir aizņemta vai šī darbība nav pieejama.
show_controlsyes_no · Noklusējums: true- Piemēra vērtība
yes - Piemērs Bubble izteiksmei
App Settings' show_editor_controls - Rādīt vai paslēpt iebūvētos vadīklus.
crop_aspecttext · Noklusējums: "free"- Piemēra vērtība
1:1 - Piemērs Bubble izteiksmei
Avatar Settings' crop_ratio - Izmantojiet pašreizējā biznesa ieraksta vērtību; pārbaudiet to pret zemāk norādītajiem ierobežojumiem.
export_formattext · Noklusējums: "jpeg"- Piemēra vērtība
jpeg - Piemērs Bubble izteiksmei
Format Dropdown's value - Izmantojiet pašreizējā biznesa ieraksta vērtību; pārbaudiet to pret zemāk norādītajiem ierobežojumiem.
export_qualitynumber · Noklusējums: 0.85- Piemēra vērtība
0.85 - Piemērs Bubble izteiksmei
Image Settings' quality - Izmantojiet pašreizējā biznesa ieraksta vērtību; pārbaudiet to pret zemāk norādītajiem ierobežojumiem.
export_max_dimensionnumber · Noklusējums: 2048- Piemēra vērtība
2048 - Piemērs Bubble izteiksmei
Image Settings' max_side - Izmantojiet pašreizējā biznesa ieraksta vērtību; pārbaudiet to pret zemāk norādītajiem ierobežojumiem.
allow_upscaleyes_no · Noklusējums: false- Piemēra vērtība
no - Piemērs Bubble izteiksmei
Allow upscale Checkbox is checked - Izmantojiet pašreizējā biznesa ieraksta vērtību; pārbaudiet to pret zemāk norādītajiem ierobežojumiem.
ui_text_jsontext · Noklusējums: ""- Piemēra vērtība
{} - Piemērs Bubble izteiksmei
App Settings' player_labels_json (supported keys only) - Papildu JSON ar atbalstītām pogu etiķetēm. Atstājiet tukšu, lai izmantotu iebūvēto tekstu.
languagetext · Noklusējums: "auto"- Piemēra vērtība
uk - Piemērs Bubble izteiksmei
Current User's preferred_language - Iestatiet language=auto, lai sekotu atbalstītai ierīcei vai pārlūkprogrammas valodai. Ievadiet atbalstītu valodas kodu, lai to izvēlētos tieši.
Darbības un to ievades · 13
Load source
Nav darbības parametru
Begin crop
Nav darbības parametru
Apply crop
origin_xnumber · Noklusējums: —- Piemēra vērtība
0 - Piemērs Bubble izteiksmei
Crop Settings' x (or omit all rectangle inputs) - Izmantojiet pašreizējā biznesa ieraksta vērtību; pārbaudiet to pret zemāk norādītajiem ierobežojumiem.
origin_ynumber · Noklusējums: —- Piemēra vērtība
0 - Piemērs Bubble izteiksmei
Crop Settings' y (or omit all rectangle inputs) - Izmantojiet pašreizējā biznesa ieraksta vērtību; pārbaudiet to pret zemāk norādītajiem ierobežojumiem.
widthnumber · Noklusējums: —- Piemēra vērtība
512 - Piemērs Bubble izteiksmei
Resize Width Input's value:converted to number - Izmantojiet pašreizējā biznesa ieraksta vērtību; pārbaudiet to pret zemāk norādītajiem ierobežojumiem.
heightnumber · Noklusējums: —- Piemēra vērtība
512 - Piemērs Bubble izteiksmei
Resize Height Input's value:converted to number - Izmantojiet pašreizējā biznesa ieraksta vērtību; pārbaudiet to pret zemāk norādītajiem ierobežojumiem.
Cancel crop
Nav darbības parametru
Rotate
degreesnumber · Noklusējums: —- Piemēra vērtība
90 - Piemērs Bubble izteiksmei
Rotation Dropdown's value - Izmantojiet pašreizējā biznesa ieraksta vērtību; pārbaudiet to pret zemāk norādītajiem ierobežojumiem.
Flip
axistext · Noklusējums: —- Piemēra vērtība
horizontal - Piemērs Bubble izteiksmei
Flip Direction Dropdown's value - Izmantojiet pašreizējā biznesa ieraksta vērtību; pārbaudiet to pret zemāk norādītajiem ierobežojumiem.
Resize
widthnumber · Noklusējums: —- Piemēra vērtība
512 - Piemērs Bubble izteiksmei
Resize Width Input's value:converted to number - Izmantojiet pašreizējā biznesa ieraksta vērtību; pārbaudiet to pret zemāk norādītajiem ierobežojumiem.
heightnumber · Noklusējums: —- Piemēra vērtība
512 - Piemērs Bubble izteiksmei
Resize Height Input's value:converted to number - Izmantojiet pašreizējā biznesa ieraksta vērtību; pārbaudiet to pret zemāk norādītajiem ierobežojumiem.
Undo
Nav darbības parametru
Redo
Nav darbības parametru
Reset edits
Nav darbības parametru
Export image
Nav darbības parametru
Cancel operation
Nav darbības parametru
Clear session
Nav darbības parametru
Stāvokļi un notikumi
Stāvokļi
editor_status · textPašreizējais šīs darbības rezultāts. Izmantojiet atbilstošo pabeigšanas notikumu pirms saglabājat veiksmi.
is_busy · yes_noDarbs joprojām notiek. Pagaidiet, pirms uzsākt citu darbību.
has_image · yes_noPašreizējā izvēlētā vienuma vērtība. Nolasiet to pēc saistītā notikuma.
has_changes · yes_noPašreizējā izvēlētā vienuma vērtība. Nolasiet to pēc saistītā notikuma.
can_undo · yes_noPašreizējā izvēlētā vienuma vērtība. Nolasiet to pēc saistītā notikuma.
can_redo · yes_noPašreizējā izvēlētā vienuma vērtība. Nolasiet to pēc saistītā notikuma.
image_width · numberPašreizējā izvēlētā vienuma vērtība. Nolasiet to pēc saistītā notikuma.
image_height · numberPašreizējā izvēlētā vienuma vērtība. Nolasiet to pēc saistītā notikuma.
output_uri · textFaila atrašanās vieta šajā ierīcē. Saglabājiet vai augšupielādējiet failu atsevišķi, ja tas jāuzglabā tiešsaistē.
output_width · numberPašreizējā izvēlētā vienuma vērtība. Nolasiet to pēc saistītā notikuma.
output_height · numberPašreizējā izvēlētā vienuma vērtība. Nolasiet to pēc saistītā notikuma.
output_bytes · numberPašreizējā izvēlētā vienuma vērtība. Nolasiet to pēc saistītā notikuma.
output_mime · textPašreizējā izvēlētā vienuma vērtība. Nolasiet to pēc saistītā notikuma.
error_code · textKļūdas informācija par pēdējo darbību. Rādiet noderīgu ziņojumu un piedāvājiet atbilstošu atkārtotu mēģinājumu.
crop_active · yes_noPašreizējā izvēlētā vienuma vērtība. Nolasiet to pēc saistītā notikuma.
crop_rect_json · textPašreizējā izvēlētā vienuma vērtība. Nolasiet to pēc saistītā notikuma.
Notikumi
source_loadedKad šis notikums notiek, nolasiet saistītās stāvokļus no tā paša elementa.
source_load_failedKad šis notikums notiek, nolasiet saistītās stāvokļus no tā paša elementa.
edit_appliedKad šis notikums notiek, nolasiet saistītās stāvokļus no tā paša elementa.
edit_undoneKad šis notikums notiek, nolasiet saistītās stāvokļus no tā paša elementa.
edit_redoneKad šis notikums notiek, nolasiet saistītās stāvokļus no tā paša elementa.
editor_resetKad šis notikums notiek, nolasiet saistītās stāvokļus no tā paša elementa.
export_startedKad šis notikums notiek, nolasiet saistītās stāvokļus no tā paša elementa.
export_completedKad šis notikums notiek, nolasiet saistītās stāvokļus no tā paša elementa.
operation_cancelledKad šis notikums notiek, nolasiet saistītās stāvokļus no tā paša elementa.
editor_errorKad šis notikums notiek, nolasiet saistītās stāvokļus no tā paša elementa.
Izstrādātāju uzdotie jautājumi
Vai output_uri ir Bubble fails?
Nē. Tas ir lokāls kešatmiņas ceļš. Saglabājiet to, izmantojot pārbaudītu lokālu saglabātāju vai augšupielādētāju, pirms saglabājat mākoņa faila atsauci.
Kā darbojas abonements?
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.
Saistītie ceļveži
Palīdzībai, informējiet mūs, kuru spraudni un ierīci izmantojat, kādu darbību mēģinājāt veikt un kas notika. Izmantojiet piemēru bez personas datiem. Nekad neizpaudiet savu atslēgu vai privātos failus.