Xodera Plugins · Bubble Native
Xodera Photo Editor Native
Převěďte vybranou fotografii na jednotný avatar, obrázek produktu nebo přílohu zprávy. Ořízněte, otočte a změňte její velikost, poté uložte exportovanou kopii ve své aplikaci.
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.
Dokumentace přezkoumána 6 listopad 2026
Praktické příklady
Konzistentní avatary profilu před nahráním
Uživatelé by měli vybrat, která část jejich fotografie se zobrazí ve čtvercovém profilovém obrázku, místo aby přijímali libovolný ořez.
`source_url = selected profile image`; `crop_aspect = "1:1"`; `document_context = the account’s stable reference`.
Počkejte na `source_loaded`; Begin crop → Apply crop, s Rotate nebo Undo podle potřeby. Při explicitním uložení Export image.
Pouze na `export_completed` použijte `output_uri`, `output_width`, `output_height` a `output_mime` jako vstupy do vašeho workflow nahrávání souborů. Poté uložte jeho trvalý odkaz do profilu.
Pokud uživatel zruší nebo se spustí `editor_error`, zachovejte starý avatar. Vymažte relaci při změně účtu, aby jiný uživatel neviděl koncept.
Úprava vytvoří místní kopii. Vaše aplikace si zvolí, jak ji uložit nebo nahrát.
Připravte konzistentní fotografie pro trh nebo katalog
Různé ohraničení a nadměrně velké obrázky způsobují nerovnoměrnost katalogu a zvyšují velikost nahrávaných souborů.
`source_url = selected item photo`; `crop_aspect = the app’s chosen ratio`; `export_max_dimension`, `export_format` a `export_quality` pocházejí z vaší zásady nahrávání.
Ořízněte relevantní oblast, volitelně Resize, poté Export image po potvrzení uživatelem. Původní soubor/reference uchovejte odděleně.
Zkontrolujte `output_width`, `output_height`, `output_bytes` a `output_mime` předtím, než váš pracovní postup nahrávání uloží výsledek. Uložte odkaz na vzniklý obrázek do položky.
Pokud export selže nebo výsledek poruší vaši zásadu nahrávání, zobrazte `error_code` a nechte uživatele jej upravit. Nepřepisujte předchozí obrázek položky před potvrzením nahrávání.
Úprava vytvoří místní kopii. Vaše aplikace si zvolí, jak ji uložit nebo nahrát.
Vytvořte zaměřenou kopii obrázku pro terénní zprávu
Technik může potřebovat detailní záběr poškozené části při zachování původního obrázku zprávy.
`source_url = Current Report Photo’s source`; `document_context = the report/account reference`; poměr ořezu může zůstat neomezený.
Begin crop → Apply crop, poté použijte Undo/Redo k porovnání úprav. Export image vytvoří upravenou kopii; vaše aplikace se ptá, zda tuto kopii připojit k Zprávě.
Použijte `has_changes`, `can_undo`, `can_redo` a `output_uri`. Po úspěšném nahrání uložte původní a upravené odkazy do samostatných polí aplikace.
Cancel crop nebo Reset edits obnoví editační cestu; zrušení musí ponechat původní přílohu zprávy nezměněnou.
Úprava vytvoří místní kopii. Vaše aplikace si zvolí, jak ji uložit nebo nahrát.
Co funguje nyní
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.
Vytvořte pracovní postup
Použijte níže dostupné beta akce a otestujte výsledek na svých cílových zařízeních.
Tyto příklady používají záznamy aplikace, jako jsou Lesson, Message a Order. Nahraďte je vlastními typy dat a názvy prvků. Příkladové adresy médií je třeba nahradit vlastními soubory.
Nastavte source_url na vybraný obrázek. Použijte document_context k identifikaci účtu a záznamu, který se upravuje, takže změna záznamu vymaže předchozí fotografii.
Po source_loaded spusťte Begin crop. Vyberte 1:1 pro avatar, upravte ořez a použijte Apply crop. Cancel crop ponechá obrázek beze změny.
Použijte Rotate, Flip nebo Resize podle potřeby. Undo a Redo procházejí dokončené úpravy; Reset edits obnoví originální obrázek.
Spusťte Export image. Na export_completed přečtěte output_uri, output_width, output_height a output_mime. Uložte nebo nahrajte tuto kopii pomocí vámi zvoleného workflow pro ukládání souborů a poté uložte soubor do záznamu.
Nastavte jednou
Aktivace klíče je pro tento plugin plánována. Vytvořte nebo vyberte svůj projekt aplikace Bubble v BestPlugins → Dashboard → Plugins. Vyberte Xodera Photo Editor Native, zkopírujte jeho klíč, poté otevřete Bubble → Plugins → Xodera Photo Editor Native a vložte jej do licensing_api_key. Uložte jednou; poté použijte akce níže. Každý plugin v každém projektu má svůj vlastní klíč.
Nejprve vyberte nebo zachyťte obrázek ve své aplikaci. Poskytněte editoru vzniklou čitelnou adresu obrázku. Oprávnění k fotoaparátu a knihovně fotografií patří výběru, který používáte.
Nastavte jednou
- Vytvořte nebo vyberte svůj projekt aplikace Bubble v BestPlugins → Dashboard → Plugins.
- Vyberte tento plugin a zkopírujte jeho projektový klíč.
- Open Bubble → Plugins → this plugin. Paste its project key into licensing_api_key and save.
- Přidejte prvek, vyberte svá data aplikace a vytvořte níže uvedený pracovní postup.
- 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.
Instalace a předplatné
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ýsledek ve své aplikaci
Uložte nahraný nebo trvale uložený obrázek do Profile.image nebo do pole přílohy. output_uri je dočasný soubor na zařízení, takže nejprve uložte tento soubor pomocí zvoleného postupu. Poté uložte output_width, output_height a output_mime jako metadata. Ponechte originální obrázek, pokud potřebujete obě verze.
Selhání, zrušení a obnovení
Na source_load_failed nebo editor_error zobrazte error_code a nabídněte Load source. Cancel operation přestane přijímat nedokončený výsledek; počkejte až do is_busy=no, než zahájíte další úpravu. Clear session vymaže editor, nikoli obrázek již uložený jinde.
Možnosti a limity
JPEG a PNG export; kvalita 0–1; maximální výstupní strana 1–4096 pixelů. Vstup: až 15 MiB a 20 megapixelů. Až 20 dokončených úprav. Možnosti ořezu: volný, 1:1, 4:3, 3:4 a 16:9. Žádná vestavěná kamera, filtry, textové překryvy, korekce perspektivy, WebP export ani automatické nahrávání.
Nastavení, akce a výsledky
Použijte tyto názvy v Bubble. Plánované funkce jsou označeny zvlášť.
Dostupná beta nastavení
Nastavení 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 · textUdálosti
source_loadedsource_load_failededit_appliededit_undoneedit_redoneeditor_resetexport_startedexport_completedoperation_cancellededitor_errorAkce a jejich vstupy
Load sourceBegin cropApply cropCancel cropRotateFlipResizeUndoRedoReset editsExport imageCancel operationClear sessionNastavení prvku · 12
source_urltext · Výchozí: ""- Ukázková hodnota
https://bestplugins.online/native-samples/avatar.jpg - Příklad Bubble výrazu
Selected Profile's image_url - Adresa vybraného audio, video nebo obrázkového souboru. Použijte typ souboru, který tento plugin podporuje.
document_contexttext · Výchozí: ""- Ukázková hodnota
<current-user-id> - Příklad Bubble výrazu
Current User's unique id - Stabilní hodnota pro tento účet nebo záznam. Použijte stejnou hodnotu při obnově jeho uložených souborů nebo konceptů.
is_activeyes_no · Výchozí: true- Ukázková hodnota
yes - Příklad Bubble výrazu
GuideHost's view_is_active (your yes/no custom state) - Nastavte ano, dokud je tento pohled otevřený. Nastavte ne při odchodu, aby se přehrávání nebo aktuální práce mohly zastavit.
disabledyes_no · Výchozí: false- Ukázková hodnota
no - Příklad Bubble výrazu
GuideHost's is_busy (your yes/no custom state) - Deaktivujte prvek, když je aplikace zaneprázdněná nebo je tato akce nedostupná.
show_controlsyes_no · Výchozí: true- Ukázková hodnota
yes - Příklad Bubble výrazu
App Settings' show_editor_controls - Zobrazit nebo skrýt vestavěné ovládací prvky.
crop_aspecttext · Výchozí: "free"- Ukázková hodnota
1:1 - Příklad Bubble výrazu
Avatar Settings' crop_ratio - Použijte hodnotu aktuálního obchodního záznamu; ověřte ji vůči níže uvedeným limitům.
export_formattext · Výchozí: "jpeg"- Ukázková hodnota
jpeg - Příklad Bubble výrazu
Format Dropdown's value - Použijte hodnotu aktuálního obchodního záznamu; ověřte ji vůči níže uvedeným limitům.
export_qualitynumber · Výchozí: 0.85- Ukázková hodnota
0.85 - Příklad Bubble výrazu
Image Settings' quality - Použijte hodnotu aktuálního obchodního záznamu; ověřte ji vůči níže uvedeným limitům.
export_max_dimensionnumber · Výchozí: 2048- Ukázková hodnota
2048 - Příklad Bubble výrazu
Image Settings' max_side - Použijte hodnotu aktuálního obchodního záznamu; ověřte ji vůči níže uvedeným limitům.
allow_upscaleyes_no · Výchozí: false- Ukázková hodnota
no - Příklad Bubble výrazu
Allow upscale Checkbox is checked - Použijte hodnotu aktuálního obchodního záznamu; ověřte ji vůči níže uvedeným limitům.
ui_text_jsontext · Výchozí: ""- Ukázková hodnota
{} - Příklad Bubble výrazu
App Settings' player_labels_json (supported keys only) - Volitelný JSON s podporovanými popisky tlačítek. Nechte prázdné pro použití vestavěného textu.
languagetext · Výchozí: "auto"- Ukázková hodnota
uk - Příklad Bubble výrazu
Current User's preferred_language - Nastavte language=auto tak, aby sledoval podporované zařízení nebo jazyk prohlížeče. Zadejte podporovaný kód jazyka pro jeho explicitní výběr.
Akce a jejich vstupy · 13
Load source
Žádné parametry akce
Begin crop
Žádné parametry akce
Apply crop
origin_xnumber · Výchozí: —- Ukázková hodnota
0 - Příklad Bubble výrazu
Crop Settings' x (or omit all rectangle inputs) - Použijte hodnotu aktuálního obchodního záznamu; ověřte ji vůči níže uvedeným limitům.
origin_ynumber · Výchozí: —- Ukázková hodnota
0 - Příklad Bubble výrazu
Crop Settings' y (or omit all rectangle inputs) - Použijte hodnotu aktuálního obchodního záznamu; ověřte ji vůči níže uvedeným limitům.
widthnumber · Výchozí: —- Ukázková hodnota
512 - Příklad Bubble výrazu
Resize Width Input's value:converted to number - Použijte hodnotu aktuálního obchodního záznamu; ověřte ji vůči níže uvedeným limitům.
heightnumber · Výchozí: —- Ukázková hodnota
512 - Příklad Bubble výrazu
Resize Height Input's value:converted to number - Použijte hodnotu aktuálního obchodního záznamu; ověřte ji vůči níže uvedeným limitům.
Cancel crop
Žádné parametry akce
Rotate
degreesnumber · Výchozí: —- Ukázková hodnota
90 - Příklad Bubble výrazu
Rotation Dropdown's value - Použijte hodnotu aktuálního obchodního záznamu; ověřte ji vůči níže uvedeným limitům.
Flip
axistext · Výchozí: —- Ukázková hodnota
horizontal - Příklad Bubble výrazu
Flip Direction Dropdown's value - Použijte hodnotu aktuálního obchodního záznamu; ověřte ji vůči níže uvedeným limitům.
Resize
widthnumber · Výchozí: —- Ukázková hodnota
512 - Příklad Bubble výrazu
Resize Width Input's value:converted to number - Použijte hodnotu aktuálního obchodního záznamu; ověřte ji vůči níže uvedeným limitům.
heightnumber · Výchozí: —- Ukázková hodnota
512 - Příklad Bubble výrazu
Resize Height Input's value:converted to number - Použijte hodnotu aktuálního obchodního záznamu; ověřte ji vůči níže uvedeným limitům.
Undo
Žádné parametry akce
Redo
Žádné parametry akce
Reset edits
Žádné parametry akce
Export image
Žádné parametry akce
Cancel operation
Žádné parametry akce
Clear session
Žádné parametry akce
Stavy a události
Stavy
editor_status · textAktuální výsledek této akce. Použijte odpovídající událost dokončení před uložením úspěchu.
is_busy · yes_noPráce stále probíhá. Počkejte, než spustíte další akci.
has_image · yes_noAktuální hodnota vybrané položky. Přečtěte ji po související události.
has_changes · yes_noAktuální hodnota vybrané položky. Přečtěte ji po související události.
can_undo · yes_noAktuální hodnota vybrané položky. Přečtěte ji po související události.
can_redo · yes_noAktuální hodnota vybrané položky. Přečtěte ji po související události.
image_width · numberAktuální hodnota vybrané položky. Přečtěte ji po související události.
image_height · numberAktuální hodnota vybrané položky. Přečtěte ji po související události.
output_uri · textUmístění souboru na tomto zařízení. Uložte nebo nahrajte soubor samostatně, pokud má být uchován online.
output_width · numberAktuální hodnota vybrané položky. Přečtěte ji po související události.
output_height · numberAktuální hodnota vybrané položky. Přečtěte ji po související události.
output_bytes · numberAktuální hodnota vybrané položky. Přečtěte ji po související události.
output_mime · textAktuální hodnota vybrané položky. Přečtěte ji po související události.
error_code · textInformace o chybě poslední akce. Zobrazte užitečnou zprávu a nabídněte příslušný opakovaný pokus.
crop_active · yes_noAktuální hodnota vybrané položky. Přečtěte ji po související události.
crop_rect_json · textAktuální hodnota vybrané položky. Přečtěte ji po související události.
Události
source_loadedKdyž nastane tato událost, přečtěte související stavy ze stejného prvku.
source_load_failedKdyž nastane tato událost, přečtěte související stavy ze stejného prvku.
edit_appliedKdyž nastane tato událost, přečtěte související stavy ze stejného prvku.
edit_undoneKdyž nastane tato událost, přečtěte související stavy ze stejného prvku.
edit_redoneKdyž nastane tato událost, přečtěte související stavy ze stejného prvku.
editor_resetKdyž nastane tato událost, přečtěte související stavy ze stejného prvku.
export_startedKdyž nastane tato událost, přečtěte související stavy ze stejného prvku.
export_completedKdyž nastane tato událost, přečtěte související stavy ze stejného prvku.
operation_cancelledKdyž nastane tato událost, přečtěte související stavy ze stejného prvku.
editor_errorKdyž nastane tato událost, přečtěte související stavy ze stejného prvku.
Otázky, které vývojáři kladou
Je output_uri soubor Bubble?
Ne. Jedná se o místní cestu cache. Uchovejte ji pomocí osvědčeného místního ukladače nebo nahrávače před uložením odkazu na cloudový soubor.
Jak funguje předplatné?
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.
Související průvodci
Pro pomoc nám sdělte, který plugin a zařízení používáte, jakou akci jste zkusili a co se stalo. Použijte příklad bez osobních údajů. Nikdy nesdílejte svůj klíč ani soukromé soubory.