Xodera Plugins · Bubble Native
Xodera Photo Editor Native
Alakítsa a kiválasztott fényképet egységes avatarra, termékképre vagy jelentésmellékletre. Vágja le, forgassa és méretezze át, majd mentse az exportált másolatot az alkalmazásában.
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áció felülvizsgált 6 november 2026
Gyakorlati példák
Következetes profilavatárok feltöltés előtt
A felhasználóknak ki kell választaniuk, hogy a fényképük mely része jelenjen meg egy négyzet alakú profilképen, ahelyett, hogy egy tetszőleges vágást elfogadnának.
`source_url = selected profile image`; `crop_aspect = "1:1"`; `document_context = the account’s stable reference`.
Várj a `source_loaded`-re; Begin crop → Apply crop, szükség szerint Rotate vagy Undo használatával. Kifejezett mentéskor Export image.
Csak a `export_completed` esetén használd a `output_uri`, `output_width`, `output_height` és `output_mime` értékeket a fájlfeltöltési munkafolyamatod bemeneteként. Ezután mentsd el a tartós hivatkozását a Profilba.
Ha a felhasználó megszakítja vagy a `editor_error` aktiválódik, tartsd meg a régi avatárt. Töröld a munkamenetet fiókváltáskor, hogy más felhasználó ne láthassa a vázlatot.
A szerkesztés helyi másolatot hoz létre. Az alkalmazásod dönt arról, hogyan menti vagy tölti fel.
Készíts következetes piactéri vagy katalógusfotókat
A különböző keretezés és a túlméretes képek egyenetlenné teszik a katalógust, és növelik a feltöltési méretet.
`source_url = selected item photo`; `crop_aspect = the app’s chosen ratio`; `export_max_dimension`, `export_format` és `export_quality` az Ön feltöltési szabályzatából származnak.
Vágja le a releváns területet, opcionálisan Resize, majd a felhasználó megerősítése után Export image. Tartsa meg az eredeti fájlt/hivatkozást külön.
Ellenőrizze a `output_width`, `output_height`, `output_bytes` és `output_mime` értékeket, mielőtt a feltöltési munkafolyamat elmenti az eredményt. Tárolja a keletkezett kép hivatkozását az Elemben.
Ha az exportálás sikertelen vagy az eredmény megsérti az Ön feltöltési szabályzatát, jelenítse meg a `error_code` értéket, és engedje a felhasználót, hogy módosítsa azt. Ne írja felül a korábbi Elem képet a feltöltés megerősítése előtt.
A szerkesztés helyi másolatot hoz létre. Az alkalmazásod dönt arról, hogyan menti vagy tölti fel.
Készítsen egy fókuszált képmásolatot a terepi jelentéshez
A technikusnak szüksége lehet egy sérült rész közeli felvételére, miközben megőrzi az eredeti jelentésképet.
`source_url = Current Report Photo’s source`; `document_context = the report/account reference`; a vágási arány korlátozatlan maradhat.
Begin crop → Apply crop, majd használja a Undo/Redo értékeket a szerkesztések összehasonlításához. Export image létrehozza a szerkesztett másolatot; az alkalmazás megkérdezi, hogy csatolja-e ezt a másolatot a Jelentéshez.
Használja a `has_changes`, `can_undo`, `can_redo` és `output_uri` értékeket. A sikeres feltöltés után tárolja az eredeti és a szerkesztett hivatkozásokat külön alkalmazásmezőkben.
A Cancel crop vagy a Reset edits visszaállítja a szerkesztési útvonalat; a megszakításnak változatlanul kell hagynia az eredeti Jelentés mellékletet.
A szerkesztés helyi másolatot hoz létre. Az alkalmazásod dönt arról, hogyan menti vagy tölti fel.
Mi működik most
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.
A munkafolyamat felépítése
Használja az alább elérhető béta műveleteket, és tesztelje az eredményt a céleszközein.
Ezek a példák olyan alkalmazásrekordokat használnak, mint a Lesson, Message és Order. Cserélje ki őket saját adat típusokra és elemnevekre. A példaként megadott média címeket saját fájljaival kell helyettesíteni.
Állítsa be a source_url-t a kiválasztott képre. Használja a document_context-t a szerkesztett fiók és rekord azonosításához, így a rekord módosítása törli az előző fényképet.
A source_loaded után futtassa a Begin crop-t. Válassza a 1:1-t avatarhoz, állítsa be a vágást, és használja a Apply crop-t. A Cancel crop változatlanul hagyja a képet.
Használja a Rotate-t, a Flip-t vagy a Resize-t szükség esetén. A Undo és a Redo a befejezett szerkesztéseken navigál; a Reset edits visszaállítja az eredeti képet.
Futtassa a Export image-t. A export_completed-n olvassa a output_uri-t, output_width-t, output_height-t és output_mime-t. Mentse vagy töltse fel ezt a másolatot a választott fájlmentési munkafolyamatával, majd tárolja a mentett fájlt a rekordban.
Egyszeri beállítás
A kulcsaktiválás erre a bővítményre tervezett. Hozzon létre vagy válasszon egy Bubble alkalmazásprojektet a BestPlugins → Dashboard → Plugins alatt. Válassza ki a Xodera Photo Editor Native-t, másolja a kulcsát, majd nyissa meg a Bubble → Plugins → Xodera Photo Editor Native-t, és illessze be a licensing_api_key-be. Mentse el egyszer; ezután használja az alábbi műveleteket. Minden bővítmény minden projektben saját kulccsal rendelkezik.
Először válassza ki vagy rögzítse a képet az alkalmazásával. Adja meg a szerkesztőnek a kapott olvasható kép címet. A kamera- és fényképtár-engedélyek a használt kiválasztóhoz tartoznak.
Egyszeri beállítás
- Hozzon létre vagy válasszon egy Bubble alkalmazásprojektet a BestPlugins → Dashboard → Plugins alatt.
- Válassza ki ezt a bővítményt, és másolja a projekt kulcsát.
- Open Bubble → Plugins → this plugin. Paste its project key into licensing_api_key and save.
- Adja hozzá az elemet, válassza ki az alkalmazásadatait, és építse fel az alábbi munkafolyamatot.
- 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.
Telepítés és előfizetés
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.
Eredmény mentése az alkalmazásodba
Mentse a feltöltött vagy véglegesen mentett képet a Profile.image-be vagy a csatolmány mezőbe. A output_uri egy ideiglenes fájl az eszközön, ezért először mentse azt a választott munkafolyamatával. Ezután tárolja a output_width, output_height és output_mime metaadatként. Tartsa meg az eredeti képet, ha mindkét verzióra szüksége van.
Hiba, megszakítás és helyreállítás
A source_load_failed vagy a editor_error esetén jelenítse meg a error_code-t, és kínálja fel a Load source-t. A Cancel operation leállítja a befejezetlen eredmény elfogadását; várjon a is_busy=no-re, mielőtt új szerkesztést indítana. A Clear session törli a szerkesztőt, nem pedig máshol már mentett képet.
Képességek és korlátok
A JPEG és a PNG exportál; minőség 0–1; maximális kimeneti oldal 1–4096 pixel. Bemenet: legfeljebb 15 MiB és 20 megapixel. Legfeljebb 20 befejezett szerkesztés. Vágási lehetőségek: szabad, 1:1, 4:3, 3:4 és 16:9. Nincs beépített kamera, szűrők, szövegátfedések, perspektívakorrekció, WebP export vagy automatikus feltöltés.
Beállítások, műveletek és eredmények
Használja ezeket a neveket a Bubble-ben. A tervezett funkciók külön vannak jelölve.
Elérhető béta beállítások
Elem beállítások
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Állapotok
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 · textEsemények
source_loadedsource_load_failededit_appliededit_undoneedit_redoneeditor_resetexport_startedexport_completedoperation_cancellededitor_errorMűveletek és azok bemenetei
Load sourceBegin cropApply cropCancel cropRotateFlipResizeUndoRedoReset editsExport imageCancel operationClear sessionElem beállítások · 12
source_urltext · Alapértelmezett: ""- Példaérték
https://bestplugins.online/native-samples/avatar.jpg - Példa Bubble kifejezés
Selected Profile's image_url - Hivatkozás a kiválasztott hang-, videó- vagy képfájlra. Használjon olyan fájltípust, amelyet a bővítmény támogat.
document_contexttext · Alapértelmezett: ""- Példaérték
<current-user-id> - Példa Bubble kifejezés
Current User's unique id - Stabil érték ehhez a fiókhoz vagy rekordhoz. Használja ugyanazt az értéket a mentett fájlok vagy vázlatok visszaállításakor.
is_activeyes_no · Alapértelmezett: true- Példaérték
yes - Példa Bubble kifejezés
GuideHost's view_is_active (your yes/no custom state) - Állítsa igent, amíg ez a nézet nyitva van. Állítsa nemet a kilépéskor, hogy a lejátszás vagy a jelenlegi munka leállhasson.
disabledyes_no · Alapértelmezett: false- Példaérték
no - Példa Bubble kifejezés
GuideHost's is_busy (your yes/no custom state) - Tiltja le az elemet, amíg az alkalmazás foglalt vagy a művelet nem érhető el.
show_controlsyes_no · Alapértelmezett: true- Példaérték
yes - Példa Bubble kifejezés
App Settings' show_editor_controls - Beépített vezérlők megjelenítése vagy elrejtése.
crop_aspecttext · Alapértelmezett: "free"- Példaérték
1:1 - Példa Bubble kifejezés
Avatar Settings' crop_ratio - Használja az aktuális üzleti rekord értékét; ellenőrizze a lenti határok szerint.
export_formattext · Alapértelmezett: "jpeg"- Példaérték
jpeg - Példa Bubble kifejezés
Format Dropdown's value - Használja az aktuális üzleti rekord értékét; ellenőrizze a lenti határok szerint.
export_qualitynumber · Alapértelmezett: 0.85- Példaérték
0.85 - Példa Bubble kifejezés
Image Settings' quality - Használja az aktuális üzleti rekord értékét; ellenőrizze a lenti határok szerint.
export_max_dimensionnumber · Alapértelmezett: 2048- Példaérték
2048 - Példa Bubble kifejezés
Image Settings' max_side - Használja az aktuális üzleti rekord értékét; ellenőrizze a lenti határok szerint.
allow_upscaleyes_no · Alapértelmezett: false- Példaérték
no - Példa Bubble kifejezés
Allow upscale Checkbox is checked - Használja az aktuális üzleti rekord értékét; ellenőrizze a lenti határok szerint.
ui_text_jsontext · Alapértelmezett: ""- Példaérték
{} - Példa Bubble kifejezés
App Settings' player_labels_json (supported keys only) - Választható JSON a támogatott gombcímkékkel. Hagyja üresen a beépített szöveg használatához.
languagetext · Alapértelmezett: "auto"- Példaérték
uk - Példa Bubble kifejezés
Current User's preferred_language - Állítsa be a language=auto-t, hogy egy támogatott eszköz vagy böngésző nyelvét kövesse. Adjon meg egy támogatott nyelvkódot a kifejezett kiválasztáshoz.
Műveletek és azok bemenetei · 13
Load source
Nincsenek műveletparaméterek
Begin crop
Nincsenek műveletparaméterek
Apply crop
origin_xnumber · Alapértelmezett: —- Példaérték
0 - Példa Bubble kifejezés
Crop Settings' x (or omit all rectangle inputs) - Használja az aktuális üzleti rekord értékét; ellenőrizze a lenti határok szerint.
origin_ynumber · Alapértelmezett: —- Példaérték
0 - Példa Bubble kifejezés
Crop Settings' y (or omit all rectangle inputs) - Használja az aktuális üzleti rekord értékét; ellenőrizze a lenti határok szerint.
widthnumber · Alapértelmezett: —- Példaérték
512 - Példa Bubble kifejezés
Resize Width Input's value:converted to number - Használja az aktuális üzleti rekord értékét; ellenőrizze a lenti határok szerint.
heightnumber · Alapértelmezett: —- Példaérték
512 - Példa Bubble kifejezés
Resize Height Input's value:converted to number - Használja az aktuális üzleti rekord értékét; ellenőrizze a lenti határok szerint.
Cancel crop
Nincsenek műveletparaméterek
Rotate
degreesnumber · Alapértelmezett: —- Példaérték
90 - Példa Bubble kifejezés
Rotation Dropdown's value - Használja az aktuális üzleti rekord értékét; ellenőrizze a lenti határok szerint.
Flip
axistext · Alapértelmezett: —- Példaérték
horizontal - Példa Bubble kifejezés
Flip Direction Dropdown's value - Használja az aktuális üzleti rekord értékét; ellenőrizze a lenti határok szerint.
Resize
widthnumber · Alapértelmezett: —- Példaérték
512 - Példa Bubble kifejezés
Resize Width Input's value:converted to number - Használja az aktuális üzleti rekord értékét; ellenőrizze a lenti határok szerint.
heightnumber · Alapértelmezett: —- Példaérték
512 - Példa Bubble kifejezés
Resize Height Input's value:converted to number - Használja az aktuális üzleti rekord értékét; ellenőrizze a lenti határok szerint.
Undo
Nincsenek műveletparaméterek
Redo
Nincsenek műveletparaméterek
Reset edits
Nincsenek műveletparaméterek
Export image
Nincsenek műveletparaméterek
Cancel operation
Nincsenek műveletparaméterek
Clear session
Nincsenek műveletparaméterek
Állapotok és események
Állapotok
editor_status · textA művelet jelenlegi eredménye. Használja a megfelelő befejezési eseményt a siker mentése előtt.
is_busy · yes_noA munka még folyamatban van. Várjon, mielőtt újabb műveletet indítana.
has_image · yes_noA kiválasztott elem jelenlegi értéke. Olvassa el a kapcsolódó esemény után.
has_changes · yes_noA kiválasztott elem jelenlegi értéke. Olvassa el a kapcsolódó esemény után.
can_undo · yes_noA kiválasztott elem jelenlegi értéke. Olvassa el a kapcsolódó esemény után.
can_redo · yes_noA kiválasztott elem jelenlegi értéke. Olvassa el a kapcsolódó esemény után.
image_width · numberA kiválasztott elem jelenlegi értéke. Olvassa el a kapcsolódó esemény után.
image_height · numberA kiválasztott elem jelenlegi értéke. Olvassa el a kapcsolódó esemény után.
output_uri · textFájl helye ezen az eszközön. Mentse vagy töltse fel a fájlt külön, ha online kell maradnia.
output_width · numberA kiválasztott elem jelenlegi értéke. Olvassa el a kapcsolódó esemény után.
output_height · numberA kiválasztott elem jelenlegi értéke. Olvassa el a kapcsolódó esemény után.
output_bytes · numberA kiválasztott elem jelenlegi értéke. Olvassa el a kapcsolódó esemény után.
output_mime · textA kiválasztott elem jelenlegi értéke. Olvassa el a kapcsolódó esemény után.
error_code · textHibainformáció az utolsó műveletről. Mutasson hasznos üzenetet és kínálja a megfelelő újrapróbálást.
crop_active · yes_noA kiválasztott elem jelenlegi értéke. Olvassa el a kapcsolódó esemény után.
crop_rect_json · textA kiválasztott elem jelenlegi értéke. Olvassa el a kapcsolódó esemény után.
Események
source_loadedAmikor ez az esemény bekövetkezik, olvassa ki a kapcsolódó állapotokat ugyanabból az elemből.
source_load_failedAmikor ez az esemény bekövetkezik, olvassa ki a kapcsolódó állapotokat ugyanabból az elemből.
edit_appliedAmikor ez az esemény bekövetkezik, olvassa ki a kapcsolódó állapotokat ugyanabból az elemből.
edit_undoneAmikor ez az esemény bekövetkezik, olvassa ki a kapcsolódó állapotokat ugyanabból az elemből.
edit_redoneAmikor ez az esemény bekövetkezik, olvassa ki a kapcsolódó állapotokat ugyanabból az elemből.
editor_resetAmikor ez az esemény bekövetkezik, olvassa ki a kapcsolódó állapotokat ugyanabból az elemből.
export_startedAmikor ez az esemény bekövetkezik, olvassa ki a kapcsolódó állapotokat ugyanabból az elemből.
export_completedAmikor ez az esemény bekövetkezik, olvassa ki a kapcsolódó állapotokat ugyanabból az elemből.
operation_cancelledAmikor ez az esemény bekövetkezik, olvassa ki a kapcsolódó állapotokat ugyanabból az elemből.
editor_errorAmikor ez az esemény bekövetkezik, olvassa ki a kapcsolódó állapotokat ugyanabból az elemből.
Fejlesztők által feltett kérdések
A output_uri egy Bubble fájl?
Nem. Ez egy helyi gyorsítótár útvonal. Tárold egy bevált helyi mentő vagy feltöltő segítségével, mielőtt felhőfájl hivatkozást tárolnál.
Hogyan működik az előfizetés?
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.
Kapcsolódó útmutatók
Segítségért mondja el, melyik plugint és eszközt használja, milyen műveletet próbált és mi történt. Használjon személyes adatokat nem tartalmazó példát. Soha ne ossza meg a kulcsát vagy privát fájljait.