Varasem natiivne Photo Editor liides. Redigeerimine ja eksport praeguses beetaversioonis on endiselt testimisel.
Varasem natiivne Photo Editor liides. Redigeerimine ja eksport praeguses beetaversioonis on endiselt testimisel.
← Kõik natiivrakenduste juhendid

Xodera Plugins · Bubble Native

Xodera Photo Editor Native

Muuda valitud foto ühtlaseks avatara, toote pildiks või aruande manuseks. Kärbi, pöörda ja muuda selle suurust, seejärel salvesta eksporditud koopia oma rakendusse.

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.

Dokumentatsioon üle vaadatud 6 novembris 2026

Praktilised näited

Ühtsed profiilipildid enne üleslaadimist

Kasutajad peaksid valima, milline foto osa kuvatakse ruudukujulises profiilipildis, selle asemel et nõustuda juhusliku kärpimisega.

`source_url = selected profile image`; `crop_aspect = "1:1"`; `document_context = the account’s stable reference`.

Oota `source_loaded`; Begin crop → Apply crop, vajaduse korral Rotate või Undo. Kui kasutaja valib selgesõnaliselt Save, käivita Export image.

Ainult `export_completed` korral kasuta `output_uri`, `output_width`, `output_height` ja `output_mime` faili üleslaadimise töövoo sisenditena. Seejärel salvesta püsiv failiviide Profile kirjele.

Kui kasutaja tühistab või `editor_error` käivitub, säilita vana avatar. Kustuta seanss konto muutmisel, et teine kasutaja ei näeks mustandit.

Redigeerimine loob kohaliku koopia. Sinu rakendus otsustab, kuidas seda salvestada või üles laadida.

Valmista ette ühtsed turu- või kataloogifotod

Erinevad raamid ja ülemahukad pildid muudavad kataloogi ebajärjekindlaks ning suurendavad üleslaadimise mahtu.

`source_url = selected item photo`; `crop_aspect = the app’s chosen ratio`; `export_max_dimension`, `export_format` ja `export_quality` pärinevad teie üleslaadimispoliitikast.

Kärbi asjakohane ala, valikuliselt Resize, seejärel Export image pärast kasutaja kinnitamist. Säilita originaalfail/viide eraldi.

Kontrolli `output_width`, `output_height`, `output_bytes` ja `output_mime` enne, kui üleslaadimise töövoog tulemuse salvestab. Salvesta saadud pildile viitav väärtus Item kirjele.

Kui eksport nurjub või tulemus rikub üleslaadimispoliitikat, näita `error_code` ja lase kasutajal tulemust parandada. Ära kirjuta Item kirje eelmist pilti üle enne üleslaadimise kinnitamist.

Redigeerimine loob kohaliku koopia. Sinu rakendus otsustab, kuidas seda salvestada või üles laadida.

Loo keskendatud pildikoopia väljaraporti jaoks

Tehnik vajab võib-olla kahjustatud osa lähivõttu, säilitades samal ajal originaalse raportipildi.

`source_url = Current Report Photo’s source`; `document_context = the report/account reference`; kärpimise suhe võib olla piiranguta.

Begin crop → Apply crop, seejärel kasuta Undo/Redo muudatuste võrdlemiseks. Export image loob muudetud koopia; rakendus küsib, kas lisada see koopia Report kirjele.

Kasuta `has_changes`, `can_undo`, `can_redo` ja `output_uri`. Salvesta originaal- ja muudetud viited eraldi rakenduse väljadele pärast edukat üleslaadimist.

Cancel crop või Reset edits taastab redigeerimisoleku; tühistamine peab jätma Report kirje algse manuse muutmata.

Redigeerimine loob kohaliku koopia. Sinu rakendus otsustab, kuidas seda salvestada või üles laadida.

Mis töötab praegu

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.

Loo töövoog

Kasuta allpool olevaid saadavalolevaid beetategevusi ja testi tulemust oma sihtseadmetel.

Need näited kasutavad rakenduse kirjeid, nagu Lesson, Message ja Order. Asenda need oma andmetüüpide ja elementide nimedega. Näidismeedia aadresse tuleb asendada oma failidega.

  1. Määra source_url valitud pildile. Kasuta document_context konto ja muudetava kirje tuvastamiseks, et teisele kirjele liikumisel tühjendataks eelmine foto redaktoris.

  2. Pärast source_loaded käivita Begin crop. Vali 1:1 avatari jaoks, kohanda kadrust ja kasuta Apply crop. Cancel crop jätab pildi muutmata.

  3. Kasuta vajadusel Rotate, Flip või Resize. Undo ja Redo liigutavad läbi lõpetatud redigeeringute; Reset edits taastab originaalpildi.

  4. Käivita Export image. export_completed korral loe output_uri, output_width, output_height ja output_mime. Salvesta või laadi see koopia üles oma valitud failisalvestusprotsessi abil, seejärel salvesta salvestatud fail kirjesse.

Töövoodiagramm — mitte rakenduse ekraanipilt

Seadista üks kord

Selle plugina jaoks on plaanis võtme aktiveerimine. Loo või vali oma Bubble rakenduse projekt BestPlugins → Dashboard → Plugins. Vali Xodera Photo Editor Native, kopeeri selle võti, seejärel ava Bubble → Plugins → Xodera Photo Editor Native ja kleebi see licensing_api_key. Salvesta üks kord; seejärel kasuta allolevaid toiminguid. Igal pluginal igas projektis on oma võti.

Vali või pildista pilt kõigepealt oma rakendusega. Anna redaktorile saadud loetav pildi aadress. Kaamera- ja fototeegi õigused kuuluvad kasutatavale valijale.

Seadista üks kord
  1. Loo või vali oma Bubble rakenduse projekt BestPlugins → Dashboard → Plugins.
  2. Vali see pistikprogramm ja kopeeri selle projekti võti.
  3. Open Bubble → Plugins → this plugin. Paste its project key into licensing_api_key and save.
  4. Lisa element, vali oma rakenduse andmed ja loo allpool toodud töövoog.
  5. 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.
Paigaldus ja tellimus

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.

Salvesta tulemus oma rakendusse

Salvesta üleslaaditud või püsivalt salvestatud pilt Profile.image või oma manusvälja. output_uri on seadmes ajutine fail, seega salvesta see fail esmalt oma valitud töövooga. Seejärel salvesta output_width, output_height ja output_mime metaandmetena. Säilita originaalpilt, kui vajad mõlemat versiooni.

Tõrge, tühistamine ja taastamine

source_load_failed või editor_error korral näita error_code ja paku Load source. Cancel operation lõpetab pooliku tulemuse vastuvõtmise; oota is_busy=no enne järgmise redigeerimise alustamist. Clear session tühjendab redaktori, mitte juba mujal salvestatud pilti.

Võimekused ja piirangud

JPEG ja PNG eksport; kvaliteet 0–1; väljundpildi suurima külje pikkus 1–4096 pikslit. Sisend: kuni 15 MiB ja 20 megapikslit. Kuni 20 lõpetatud muudatust. Kärpimisvalikud: free, 1:1, 4:3, 3:4 ja 16:9. Puuduvad sisseehitatud kaamera, filtrid, tekstikatted, perspektiiviparandus, WebP eksport ja automaatne üleslaadimine.

Seaded, toimingud ja tulemused

Kasuta neid nimesid Bubble-s. Planeeritud funktsioonid on märgitud eraldi.

Saadaolevad beetaversiooni seaded

Elemendi seaded

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

Olekud

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 · text

Sündmused

source_loadedsource_load_failededit_appliededit_undoneedit_redoneeditor_resetexport_startedexport_completedoperation_cancellededitor_error

Toimingud ja nende sisendid

Load sourceBegin cropApply cropCancel cropRotateFlipResizeUndoRedoReset editsExport imageCancel operationClear session
Elemendi seaded · 12
source_urltext · Vaikimisi: ""
Näidisväärtushttps://bestplugins.online/native-samples/avatar.jpg
Bubble avaldise näideSelected Profile's image_url
Valitud audio-, video- või pildifaili aadress. Kasuta failitüüpi, mida see plugin toetab.
document_contexttext · Vaikimisi: ""
Näidisväärtus<current-user-id>
Bubble avaldise näideCurrent User's unique id
Stabiilne väärtus selle konto või kirje jaoks. Kasuta sama väärtust selle salvestatud failide või mustandite taastamisel.
is_activeyes_no · Vaikimisi: true
Näidisväärtusyes
Bubble avaldise näideGuideHost's view_is_active (your yes/no custom state)
Määra yes, kui see vaade on avatud. Vaate sulgemisel määra no, et taasesitus või pooleliolev töö saaks peatuda.
disabledyes_no · Vaikimisi: false
Näidisväärtusno
Bubble avaldise näideGuideHost's is_busy (your yes/no custom state)
Keela element, kui teie rakendus on hõivatud või see toiming pole saadaval.
show_controlsyes_no · Vaikimisi: true
Näidisväärtusyes
Bubble avaldise näideApp Settings' show_editor_controls
Kuva või peida sisseehitatud juhtelemente.
crop_aspecttext · Vaikimisi: "free"
Näidisväärtus1:1
Bubble avaldise näideAvatar Settings' crop_ratio
Kasutage praeguse ärirekordi väärtust; kontrollige seda allpool toodud piiride suhtes.
export_formattext · Vaikimisi: "jpeg"
Näidisväärtusjpeg
Bubble avaldise näideFormat Dropdown's value
Kasutage praeguse ärirekordi väärtust; kontrollige seda allpool toodud piiride suhtes.
export_qualitynumber · Vaikimisi: 0.85
Näidisväärtus0.85
Bubble avaldise näideImage Settings' quality
Kasutage praeguse ärirekordi väärtust; kontrollige seda allpool toodud piiride suhtes.
export_max_dimensionnumber · Vaikimisi: 2048
Näidisväärtus2048
Bubble avaldise näideImage Settings' max_side
Kasutage praeguse ärirekordi väärtust; kontrollige seda allpool toodud piiride suhtes.
allow_upscaleyes_no · Vaikimisi: false
Näidisväärtusno
Bubble avaldise näideAllow upscale Checkbox is checked
Kasutage praeguse ärirekordi väärtust; kontrollige seda allpool toodud piiride suhtes.
ui_text_jsontext · Vaikimisi: ""
Näidisväärtus{}
Bubble avaldise näideApp Settings' player_labels_json (supported keys only)
Valikuline JSON toetatud nuppude siltidega. Jäta tühjaks, et kasutada sisseehitatud teksti.
languagetext · Vaikimisi: "auto"
Näidisväärtusuk
Bubble avaldise näideCurrent User's preferred_language
Määra language=auto, et kasutada seadme või brauseri keelt, kui see keel on toetatud. Kindla keele valimiseks sisesta toetatud keelekood.
Toimingud ja nende sisendid · 13
Load source

Ei ole toimingu parameetreid

Begin crop

Ei ole toimingu parameetreid

Apply crop
origin_xnumber · Vaikimisi: —
Näidisväärtus0
Bubble avaldise näideCrop Settings' x (or omit all rectangle inputs)
Kasutage praeguse ärirekordi väärtust; kontrollige seda allpool toodud piiride suhtes.
origin_ynumber · Vaikimisi: —
Näidisväärtus0
Bubble avaldise näideCrop Settings' y (or omit all rectangle inputs)
Kasutage praeguse ärirekordi väärtust; kontrollige seda allpool toodud piiride suhtes.
widthnumber · Vaikimisi: —
Näidisväärtus512
Bubble avaldise näideResize Width Input's value:converted to number
Kasutage praeguse ärirekordi väärtust; kontrollige seda allpool toodud piiride suhtes.
heightnumber · Vaikimisi: —
Näidisväärtus512
Bubble avaldise näideResize Height Input's value:converted to number
Kasutage praeguse ärirekordi väärtust; kontrollige seda allpool toodud piiride suhtes.
Cancel crop

Ei ole toimingu parameetreid

Rotate
degreesnumber · Vaikimisi: —
Näidisväärtus90
Bubble avaldise näideRotation Dropdown's value
Kasutage praeguse ärirekordi väärtust; kontrollige seda allpool toodud piiride suhtes.
Flip
axistext · Vaikimisi: —
Näidisväärtushorizontal
Bubble avaldise näideFlip Direction Dropdown's value
Kasutage praeguse ärirekordi väärtust; kontrollige seda allpool toodud piiride suhtes.
Resize
widthnumber · Vaikimisi: —
Näidisväärtus512
Bubble avaldise näideResize Width Input's value:converted to number
Kasutage praeguse ärirekordi väärtust; kontrollige seda allpool toodud piiride suhtes.
heightnumber · Vaikimisi: —
Näidisväärtus512
Bubble avaldise näideResize Height Input's value:converted to number
Kasutage praeguse ärirekordi väärtust; kontrollige seda allpool toodud piiride suhtes.
Undo

Ei ole toimingu parameetreid

Redo

Ei ole toimingu parameetreid

Reset edits

Ei ole toimingu parameetreid

Export image

Ei ole toimingu parameetreid

Cancel operation

Ei ole toimingu parameetreid

Clear session

Ei ole toimingu parameetreid

Olekud ja sündmused

Olekud

editor_status · text

Selle toimingu praegune tulemus. Kasuta sobivat lõpetamise sündmust enne edu salvestamist.

is_busy · yes_no

Töö on endiselt pooleli. Oota enne järgmise toimingu alustamist.

has_image · yes_no

Valitud üksuse praegune väärtus. Loe seda pärast seotud sündmust.

has_changes · yes_no

Valitud üksuse praegune väärtus. Loe seda pärast seotud sündmust.

can_undo · yes_no

Valitud üksuse praegune väärtus. Loe seda pärast seotud sündmust.

can_redo · yes_no

Valitud üksuse praegune väärtus. Loe seda pärast seotud sündmust.

image_width · number

Valitud üksuse praegune väärtus. Loe seda pärast seotud sündmust.

image_height · number

Valitud üksuse praegune väärtus. Loe seda pärast seotud sündmust.

output_uri · text

Faili asukoht selles seadmes. Salvesta või laadi fail eraldi üles, kui see peab olema internetis.

output_width · number

Valitud üksuse praegune väärtus. Loe seda pärast seotud sündmust.

output_height · number

Valitud üksuse praegune väärtus. Loe seda pärast seotud sündmust.

output_bytes · number

Valitud üksuse praegune väärtus. Loe seda pärast seotud sündmust.

output_mime · text

Valitud üksuse praegune väärtus. Loe seda pärast seotud sündmust.

error_code · text

Vea teave viimase toimingu kohta. Kuva abistav sõnum ja paku asjakohast kordamist.

crop_active · yes_no

Valitud üksuse praegune väärtus. Loe seda pärast seotud sündmust.

crop_rect_json · text

Valitud üksuse praegune väärtus. Loe seda pärast seotud sündmust.

Sündmused

source_loaded

Kui see sündmus toimub, loe seotud olekuid samast elemendist.

source_load_failed

Kui see sündmus toimub, loe seotud olekuid samast elemendist.

edit_applied

Kui see sündmus toimub, loe seotud olekuid samast elemendist.

edit_undone

Kui see sündmus toimub, loe seotud olekuid samast elemendist.

edit_redone

Kui see sündmus toimub, loe seotud olekuid samast elemendist.

editor_reset

Kui see sündmus toimub, loe seotud olekuid samast elemendist.

export_started

Kui see sündmus toimub, loe seotud olekuid samast elemendist.

export_completed

Kui see sündmus toimub, loe seotud olekuid samast elemendist.

operation_cancelled

Kui see sündmus toimub, loe seotud olekuid samast elemendist.

editor_error

Kui see sündmus toimub, loe seotud olekuid samast elemendist.

Küsimused, mida arendajad esitavad

Kas output_uri on Bubble File?

Ei. See on kohalik vahemälutee. Enne pilvefaili viite salvestamist talleta fail töökindla kohaliku salvestaja või üleslaadija abil püsivalt.

Kuidas tellimus töötab?

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.

Seotud juhendid

Abi saamiseks andke meile teada, millist pistikprogrammi ja seadet kasutate, millist toimingut proovisite ning mis juhtus. Kasutage näidet ilma isikuandmeteta. Ärge kunagi jagage oma võtit ega privaatfaile.