Xodera Plugins · Bubble Native
Xodera Photo Editor Native
Premeňte vybranú fotografiu na jednotný avatar, obrázok produktu alebo prílohu správy. Orežte, otočte a zmeňte jej veľkosť, potom uložte exportovanú kópiu vo svojej aplikácii.
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ácia skontrolovaná 6 november 2026
Praktické príklady
Konzistentné avatary profilu pred nahraním
Používatelia by mali vybrať, ktorá časť ich fotografie sa zobrazí v štvorcovom profilovom obrázku, namiesto akceptovania ľubovoľného orezania.
`source_url = selected profile image`; `crop_aspect = "1:1"`; `document_context = the account’s stable reference`.
Počkajte na `source_loaded`; Begin crop → Apply crop, s Rotate alebo Undo podľa potreby. Pri explicitnom uložení Export image.
Iba na `export_completed` použite `output_uri`, `output_width`, `output_height` a `output_mime` ako vstupy do vášho pracovného postupu nahrávania súborov. Potom uložte jeho trvalý odkaz do profilu.
Ak používateľ zruší alebo sa spustí `editor_error`, zachovajte starý avatar. Vymažte reláciu pri zmene účtu, aby iný používateľ nemohol vidieť koncept.
Úprava vytvára lokálnu kópiu. Vaša aplikácia si zvolí, ako ju uložiť alebo nahrať.
Pripravte konzistentné fotografie pre trh alebo katalóg
Rôzne ohraničenie a nadmerne veľké obrázky robia katalóg nevyrovnaný a zvyšujú veľkosť nahrávania.
`source_url = selected item photo`; `crop_aspect = the app’s chosen ratio`; `export_max_dimension`, `export_format` a `export_quality` pochádzajú z vašej politiky nahrávania.
Orežte relevantnú oblasť, voliteľne Resize, potom Export image po potvrdení používateľom. Pôvodný súbor/odkaz uchovajte samostatne.
Skontrolujte `output_width`, `output_height`, `output_bytes` a `output_mime` pred tým, ako váš pracovný postup nahrávania uloží výsledok. Uložte odkaz na vzniknutý obrázok na položku.
Ak export zlyhá alebo výsledok poruší vašu politiku nahrávania, zobrazte `error_code` a umožnite používateľovi ho upraviť. Neprepíšte predchádzajúci obrázok položky pred potvrdením nahrávania.
Úprava vytvára lokálnu kópiu. Vaša aplikácia si zvolí, ako ju uložiť alebo nahrať.
Vytvorte zameranú kópiu obrázka pre terénnu správu
Technik môže potrebovať detail jedného poškodeného dielu pri zachovaní pôvodného obrázka správy.
`source_url = Current Report Photo’s source`; `document_context = the report/account reference`; pomer orezania môže zostať neobmedzený.
Begin crop → Apply crop, potom použite Undo/Redo na porovnanie úprav. Export image vytvorí upravenú kópiu; vaša aplikácia sa pýta, či pripojiť túto kópiu k správe.
Použite `has_changes`, `can_undo`, `can_redo` a `output_uri`. Po úspešnom nahraní uložte pôvodné a upravené odkazy do samostatných polí aplikácie.
Cancel crop alebo Reset edits obnoví cestu úprav; zrušenie musí ponechať pôvodnú prílohu Reportu nezmenenú.
Úprava vytvára lokálnu kópiu. Vaša aplikácia si zvolí, ako ju uložiť alebo nahrať.
Čo funguje teraz
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.
Vytvorte pracovný postup
Použite dostupné beta akcie nižšie a otestujte výsledok na svojich cieľových zariadeniach.
Tieto príklady používajú záznamy aplikácie, ako sú Lesson, Message a Order. Nahraďte ich vlastnými typmi údajov a názvami prvkov. Príkladové mediálne adresy musia byť nahradené vašimi vlastnými súbormi.
Nastavte source_url na vybraný obrázok. Použite document_context na identifikáciu účtu a záznamu, ktorý sa upravuje, takže zmena záznamu vymaže predchádzajúcu fotografiu.
Po source_loaded spustite Begin crop. Vyberte 1:1 pre avatar, upravte orezanie a použite Apply crop. Cancel crop ponechá obrázok nezmenený.
Použite Rotate, Flip alebo Resize podľa potreby. Undo a Redo prechádzajú dokončenými úpravami; Reset edits obnoví pôvodný obrázok.
Spustite Export image. Na export_completed prečítajte output_uri, output_width, output_height a output_mime. Uložte alebo nahrajte túto kópiu pomocou vybraného postupu ukladania súborov a potom uložte uložený súbor do záznamu.
Nastavte raz
Aktivácia kľúča je pre tento plugin plánovaná. Vytvorte alebo vyberte svoj projekt aplikácie Bubble v BestPlugins → Dashboard → Plugins. Vyberte Xodera Photo Editor Native, skopírujte jeho kľúč, potom otvorte Bubble → Plugins → Xodera Photo Editor Native a vložte ho do licensing_api_key. Uložte raz; potom použite nižšie uvedené akcie. Každý plugin v každom projekte má svoj vlastný kľúč.
Najprv vyberte alebo zachyťte obrázok pomocou svojej aplikácie. Poskytnite editoru vzniknutú čitateľnú adresu obrázka. Povolenia kamery a knižnice fotografií patria výberovému nástroju, ktorý používate.
Nastavte raz
- Vytvorte alebo vyberte svoj Bubble projekt na BestPlugins → Dashboard → Plugins.
- Vyberte tento plugin a skopírujte jeho projektový kľúč.
- Open Bubble → Plugins → this plugin. Paste its project key into licensing_api_key and save.
- Pridajte element, vyberte svoje údaje aplikácie a zostavte pracovný postup nižšie.
- 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.
Inštalácia a predplatné
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.
Uložte výsledok do svojej aplikácie
Uložte nahraný alebo trvalo uložený obrázok do Profile.image alebo do poľa prílohy. output_uri je dočasný súbor na zariadení, preto najprv uložte tento súbor podľa zvoleného pracovného postupu. Potom uložte output_width, output_height a output_mime ako metadáta. Ponechajte pôvodný obrázok, ak potrebujete obe verzie.
Zlyhanie, zrušenie a obnovenie
Na source_load_failed alebo editor_error zobrazte error_code a ponúknite Load source. Cancel operation prestane prijímať nedokončený výsledok; počkajte až do is_busy=no pred spustením ďalšej úpravy. Clear session vymaže editor, nie obrázok už uložený inde.
Možnosti a limity
Export JPEG a PNG; kvalita 0–1; maximálna výstupná strana 1–4096 pixelov. Vstup: až do 15 MiB a 20 megapixelov. Až do 20 dokončených úprav. Možnosti orezania: voľné, 1:1, 4:3, 3:4 a 16:9. Žiadna vstavaná kamera, filtre, textové prekrytia, korekcia perspektívy, export WebP ani automatické nahrávanie.
Nastavenia, akcie a výsledky
Použite tieto názvy v Bubble. Plánované funkcie sú označené samostatne.
Dostupné beta nastavenia
Nastavenia prvku
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 · textStavy
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 · textUdalosti
source_loadedsource_load_failededit_appliededit_undoneedit_redoneeditor_resetexport_startedexport_completedoperation_cancellededitor_errorAkcie a ich vstupy
Load sourceBegin cropApply cropCancel cropRotateFlipResizeUndoRedoReset editsExport imageCancel operationClear sessionNastavenia prvku · 12
source_urltext · Predvolené: ""- Ukážková hodnota
https://bestplugins.online/native-samples/avatar.jpg - Príklad Bubble výraz
Selected Profile's image_url - Adresa vybraného audio, video alebo obrazového súboru. Použite typ súboru, ktorý tento plugin podporuje.
document_contexttext · Predvolené: ""- Ukážková hodnota
<current-user-id> - Príklad Bubble výraz
Current User's unique id - Stabilná hodnota pre tento účet alebo záznam. Použite rovnakú hodnotu pri obnove jeho uložených súborov alebo konceptov.
is_activeyes_no · Predvolené: true- Ukážková hodnota
yes - Príklad Bubble výraz
GuideHost's view_is_active (your yes/no custom state) - Nastavte áno, kým je tento pohľad otvorený. Nastavte nie pri odchode, aby sa prehrávanie alebo aktuálna práca mohla zastaviť.
disabledyes_no · Predvolené: false- Ukážková hodnota
no - Príklad Bubble výraz
GuideHost's is_busy (your yes/no custom state) - Zakážte prvok, keď je vaša aplikácia zaneprázdnená alebo je táto akcia nedostupná.
show_controlsyes_no · Predvolené: true- Ukážková hodnota
yes - Príklad Bubble výraz
App Settings' show_editor_controls - Zobraziť alebo skryť vstavané ovládacie prvky.
crop_aspecttext · Predvolené: "free"- Ukážková hodnota
1:1 - Príklad Bubble výraz
Avatar Settings' crop_ratio - Použite hodnotu aktuálneho obchodného záznamu; overte ju voči nižšie uvedeným limitom.
export_formattext · Predvolené: "jpeg"- Ukážková hodnota
jpeg - Príklad Bubble výraz
Format Dropdown's value - Použite hodnotu aktuálneho obchodného záznamu; overte ju voči nižšie uvedeným limitom.
export_qualitynumber · Predvolené: 0.85- Ukážková hodnota
0.85 - Príklad Bubble výraz
Image Settings' quality - Použite hodnotu aktuálneho obchodného záznamu; overte ju voči nižšie uvedeným limitom.
export_max_dimensionnumber · Predvolené: 2048- Ukážková hodnota
2048 - Príklad Bubble výraz
Image Settings' max_side - Použite hodnotu aktuálneho obchodného záznamu; overte ju voči nižšie uvedeným limitom.
allow_upscaleyes_no · Predvolené: false- Ukážková hodnota
no - Príklad Bubble výraz
Allow upscale Checkbox is checked - Použite hodnotu aktuálneho obchodného záznamu; overte ju voči nižšie uvedeným limitom.
ui_text_jsontext · Predvolené: ""- Ukážková hodnota
{} - Príklad Bubble výraz
App Settings' player_labels_json (supported keys only) - Voliteľný JSON s podporovanými popiskami tlačidiel. Ponechajte prázdne pre použitie vstavaného textu.
languagetext · Predvolené: "auto"- Ukážková hodnota
uk - Príklad Bubble výraz
Current User's preferred_language - Nastavte language=auto, aby sledoval podporované zariadenie alebo jazyk prehliadača. Zadajte podporovaný kód jazyka pre jeho explicitný výber.
Akcie a ich vstupy · 13
Load source
Žiadne parametre akcie
Begin crop
Žiadne parametre akcie
Apply crop
origin_xnumber · Predvolené: —- Ukážková hodnota
0 - Príklad Bubble výraz
Crop Settings' x (or omit all rectangle inputs) - Použite hodnotu aktuálneho obchodného záznamu; overte ju voči nižšie uvedeným limitom.
origin_ynumber · Predvolené: —- Ukážková hodnota
0 - Príklad Bubble výraz
Crop Settings' y (or omit all rectangle inputs) - Použite hodnotu aktuálneho obchodného záznamu; overte ju voči nižšie uvedeným limitom.
widthnumber · Predvolené: —- Ukážková hodnota
512 - Príklad Bubble výraz
Resize Width Input's value:converted to number - Použite hodnotu aktuálneho obchodného záznamu; overte ju voči nižšie uvedeným limitom.
heightnumber · Predvolené: —- Ukážková hodnota
512 - Príklad Bubble výraz
Resize Height Input's value:converted to number - Použite hodnotu aktuálneho obchodného záznamu; overte ju voči nižšie uvedeným limitom.
Cancel crop
Žiadne parametre akcie
Rotate
degreesnumber · Predvolené: —- Ukážková hodnota
90 - Príklad Bubble výraz
Rotation Dropdown's value - Použite hodnotu aktuálneho obchodného záznamu; overte ju voči nižšie uvedeným limitom.
Flip
axistext · Predvolené: —- Ukážková hodnota
horizontal - Príklad Bubble výraz
Flip Direction Dropdown's value - Použite hodnotu aktuálneho obchodného záznamu; overte ju voči nižšie uvedeným limitom.
Resize
widthnumber · Predvolené: —- Ukážková hodnota
512 - Príklad Bubble výraz
Resize Width Input's value:converted to number - Použite hodnotu aktuálneho obchodného záznamu; overte ju voči nižšie uvedeným limitom.
heightnumber · Predvolené: —- Ukážková hodnota
512 - Príklad Bubble výraz
Resize Height Input's value:converted to number - Použite hodnotu aktuálneho obchodného záznamu; overte ju voči nižšie uvedeným limitom.
Undo
Žiadne parametre akcie
Redo
Žiadne parametre akcie
Reset edits
Žiadne parametre akcie
Export image
Žiadne parametre akcie
Cancel operation
Žiadne parametre akcie
Clear session
Žiadne parametre akcie
Stavy a udalosti
Stavy
editor_status · textAktuálny výsledok tejto akcie. Použite zodpovedajúcu udalosť dokončenia pred uložením úspechu.
is_busy · yes_noPráca stále prebieha. Počkajte pred spustením ďalšej akcie.
has_image · yes_noAktuálna hodnota vybranej položky. Prečítajte ju po súvisiacej udalosti.
has_changes · yes_noAktuálna hodnota vybranej položky. Prečítajte ju po súvisiacej udalosti.
can_undo · yes_noAktuálna hodnota vybranej položky. Prečítajte ju po súvisiacej udalosti.
can_redo · yes_noAktuálna hodnota vybranej položky. Prečítajte ju po súvisiacej udalosti.
image_width · numberAktuálna hodnota vybranej položky. Prečítajte ju po súvisiacej udalosti.
image_height · numberAktuálna hodnota vybranej položky. Prečítajte ju po súvisiacej udalosti.
output_uri · textUmiestnenie súboru na tomto zariadení. Uložte alebo nahrajte súbor samostatne, ak musí zostať online.
output_width · numberAktuálna hodnota vybranej položky. Prečítajte ju po súvisiacej udalosti.
output_height · numberAktuálna hodnota vybranej položky. Prečítajte ju po súvisiacej udalosti.
output_bytes · numberAktuálna hodnota vybranej položky. Prečítajte ju po súvisiacej udalosti.
output_mime · textAktuálna hodnota vybranej položky. Prečítajte ju po súvisiacej udalosti.
error_code · textInformácie o chybe poslednej akcie. Zobrazte užitočnú správu a ponúknite príslušný opätovný pokus.
crop_active · yes_noAktuálna hodnota vybranej položky. Prečítajte ju po súvisiacej udalosti.
crop_rect_json · textAktuálna hodnota vybranej položky. Prečítajte ju po súvisiacej udalosti.
Udalosti
source_loadedKeď nastane táto udalosť, prečítajte súvisiace stavy z rovnakého prvku.
source_load_failedKeď nastane táto udalosť, prečítajte súvisiace stavy z rovnakého prvku.
edit_appliedKeď nastane táto udalosť, prečítajte súvisiace stavy z rovnakého prvku.
edit_undoneKeď nastane táto udalosť, prečítajte súvisiace stavy z rovnakého prvku.
edit_redoneKeď nastane táto udalosť, prečítajte súvisiace stavy z rovnakého prvku.
editor_resetKeď nastane táto udalosť, prečítajte súvisiace stavy z rovnakého prvku.
export_startedKeď nastane táto udalosť, prečítajte súvisiace stavy z rovnakého prvku.
export_completedKeď nastane táto udalosť, prečítajte súvisiace stavy z rovnakého prvku.
operation_cancelledKeď nastane táto udalosť, prečítajte súvisiace stavy z rovnakého prvku.
editor_errorKeď nastane táto udalosť, prečítajte súvisiace stavy z rovnakého prvku.
Otázky, ktoré kladú vývojári
Je output_uri súbor Bubble?
Nie. Ide o lokálnu cestu vyrovnávacej pamäte. Zachovajte ju pomocou osvedčeného lokálneho uložiča alebo nahrávača pred uložením odkazu na cloudový súbor.
Ako funguje predplatné?
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.
Súvisiace návody
Pre pomoc nám povedzte, ktorý plugin a zariadenie používate, akú akciu ste skúšali a čo sa stalo. Použite príklad bez osobných údajov. Nikdy nezdieľajte svoj kľúč ani súkromné súbory.