Xodera Plugins · Bubble Native
Xodera Photo Editor Native
Ubah foto terpilih menjadi avatar, imej produk atau lampiran laporan yang konsisten. Potong, putar dan ubah saiznya, kemudian simpan salinan yang dieksport dalam aplikasi anda.
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.
Dokumentasi disemak 6 November 2026
Contoh praktikal
Avatar profil yang konsisten sebelum muat naik
Pengguna harus memilih bahagian foto mereka yang muncul dalam imej profil segi empat sama dan bukannya menerima pemotongan secara rawak.
`source_url = selected profile image`; `crop_aspect = "1:1"`; `document_context = the account’s stable reference`.
Tunggu `source_loaded`; Begin crop → Apply crop, dengan Rotate atau Undo mengikut keperluan. Pada Simpan eksplisit, Export image.
Hanya pada `export_completed`, gunakan `output_uri`, `output_width`, `output_height` dan `output_mime` sebagai input ke aliran kerja muat naik fail anda. Simpan rujukan tahan lama ke Profil selepas itu.
Jika pengguna membatalkan atau `editor_error` dipicu, kekalkan avatar lama. Kosongkan sesi apabila akaun berubah supaya pengguna lain tidak dapat melihat draf.
Penyuntingan menghasilkan salinan tempatan. Aplikasi anda menentukan cara menyimpan atau memuat naiknya.
Sediakan foto pasar atau katalog yang konsisten
Pembingkaian yang berbeza dan imej berukuran besar menjadikan katalog tidak sekata dan meningkatkan saiz muat naik.
`source_url = selected item photo`; `crop_aspect = the app’s chosen ratio`; `export_max_dimension`, `export_format` dan `export_quality` datang daripada dasar muat naik anda.
Potong kawasan yang relevan, secara pilihan Resize, kemudian Export image selepas pengguna mengesahkan. Simpan fail/rujukan asal secara berasingan.
Periksa `output_width`, `output_height`, `output_bytes` dan `output_mime` sebelum aliran kerja muat naik anda menyimpan hasilnya. Simpan rujukan imej yang terhasil pada Item.
Jika eksport gagal atau hasil melanggar dasar muat naik anda, tunjukkan `error_code` dan biarkan pengguna memperbaikinya. Jangan menulis ganti imej Item sebelumnya sebelum pengesahan muat naik.
Penyuntingan menghasilkan salinan tempatan. Aplikasi anda menentukan cara menyimpan atau memuat naiknya.
Cipta salinan imej terfokus untuk laporan lapangan
Seorang juruteknik mungkin memerlukan gambar dekat satu bahagian rosak sambil mengekalkan imej laporan asal.
`source_url = Current Report Photo’s source`; `document_context = the report/account reference`; nisbah pemotongan boleh tetap tidak terhad.
Begin crop → Apply crop, kemudian gunakan Undo/Redo untuk membandingkan suntingan. Export image menghasilkan salinan yang disunting; aplikasi anda menanya sama ada untuk melampirkan salinan itu kepada Laporan.
Gunakan `has_changes`, `can_undo`, `can_redo` dan `output_uri`. Simpan rujukan asal dan yang disunting dalam medan aplikasi berasingan selepas muat naik berjaya.
Cancel crop atau Reset edits memulihkan laluan penyuntingan; pembatalan mesti membiarkan lampiran Laporan asal tidak berubah.
Penyuntingan menghasilkan salinan tempatan. Aplikasi anda menentukan cara menyimpan atau memuat naiknya.
Apa yang berfungsi sekarang
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.
Bina aliran kerja
Gunakan tindakan beta yang tersedia di bawah dan uji hasilnya pada peranti sasaran anda.
Contoh-contoh ini menggunakan rekod aplikasi seperti Lesson, Message dan Order. Gantikan mereka dengan jenis data dan nama elemen anda sendiri. Alamat media contoh mesti diganti dengan fail anda sendiri.
Tetapkan source_url kepada imej yang dipilih. Gunakan document_context untuk mengenal pasti akaun dan rekod yang sedang disunting, jadi mengubah rekod akan mengosongkan foto sebelumnya.
Selepas source_loaded, jalankan Begin crop. Pilih 1:1 untuk avatar, laraskan pemotongan dan gunakan Apply crop. Cancel crop membiarkan imej tidak berubah.
Gunakan Rotate, Flip atau Resize jika diperlukan. Undo dan Redo melintasi penyuntingan selesai; Reset edits memulihkan imej asal.
Jalankan Export image. Pada export_completed, baca output_uri, output_width, output_height dan output_mime. Simpan atau muat naik salinan itu menggunakan aliran kerja penyimpanan fail pilihan anda, kemudian simpan fail yang disimpan dalam rekod.
Konfigurasi sekali
Pengaktifan kunci dirancang untuk plugin ini. Buat atau pilih projek aplikasi Bubble anda dalam BestPlugins → Dashboard → Plugins. Pilih Xodera Photo Editor Native, salin kuncinya, kemudian buka Bubble → Plugins → Xodera Photo Editor Native dan tampal ke dalam licensing_api_key. Simpan sekali; kemudian gunakan tindakan di bawah. Setiap plugin dalam setiap projek mempunyai kuncinya sendiri.
Pilih atau tangkap imej dengan aplikasi anda terlebih dahulu. Berikan editor alamat imej yang boleh dibaca. Kebenaran kamera dan pustaka foto adalah milik pemilih yang anda gunakan.
Konfigurasi sekali
- Buat atau pilih projek aplikasi Bubble anda di BestPlugins → Dashboard → Plugins.
- Pilih plugin ini dan salin kunci projeknya.
- Open Bubble → Plugins → this plugin. Paste its project key into licensing_api_key and save.
- Tambah elemen, pilih data aplikasi anda dan bina alur kerja di bawah.
- 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.
Pemasangan dan langganan
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.
Simpan hasil dalam aplikasi anda
Simpan imej yang dimuat naik atau disimpan secara kekal ke dalam Profile.image atau medan lampiran anda. output_uri ialah fail sementara pada peranti, jadi pertama simpan fail itu dengan aliran kerja pilihan anda. Kemudian simpan output_width, output_height dan output_mime sebagai metadata. Simpan imej asal jika anda memerlukan kedua-dua versi.
Kegagalan, pembatalan dan pemulihan
Pada source_load_failed atau editor_error, tunjukkan error_code dan tawarkan Load source. Cancel operation menghentikan penerimaan hasil yang belum selesai; tunggu sehingga is_busy=no sebelum memulakan penyuntingan lain. Clear session membersihkan editor, bukan imej yang sudah disimpan di tempat lain.
Keupayaan dan had
Eksport JPEG dan PNG; kualiti 0–1; sisi output maksimum 1–4096 piksel. Input: sehingga 15 MiB dan 20 megapiksel. Sehingga 20 penyuntingan selesai. Pilihan pemotongan: bebas, 1:1, 4:3, 3:4 dan 16:9. Tiada kamera terbina, penapis, lapisan teks, pembetulan perspektif, eksport WebP atau muat naik automatik.
Tetapan, tindakan dan hasil
Gunakan nama-nama ini dalam Bubble. Ciri yang dirancang ditandakan secara berasingan.
Tetapan beta tersedia
Tetapan elemen
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 · textKeadaan
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 · textAcara
source_loadedsource_load_failededit_appliededit_undoneedit_redoneeditor_resetexport_startedexport_completedoperation_cancellededitor_errorTindakan dan inputnya
Load sourceBegin cropApply cropCancel cropRotateFlipResizeUndoRedoReset editsExport imageCancel operationClear sessionTetapan elemen · 12
source_urltext · Lalai: ""- Nilai contoh
https://bestplugins.online/native-samples/avatar.jpg - Contoh ungkapan Bubble
Selected Profile's image_url - Alamat fail audio, video atau imej yang dipilih. Gunakan jenis fail yang disokong plugin ini.
document_contexttext · Lalai: ""- Nilai contoh
<current-user-id> - Contoh ungkapan Bubble
Current User's unique id - Nilai stabil untuk akaun atau rekod ini. Gunakan nilai yang sama semasa memulihkan fail atau draf yang disimpan.
is_activeyes_no · Lalai: true- Nilai contoh
yes - Contoh ungkapan Bubble
GuideHost's view_is_active (your yes/no custom state) - Tetapkan ya semasa pandangan ini dibuka. Tetapkan tidak apabila keluar, supaya main semula atau kerja semasa dapat dihentikan.
disabledyes_no · Lalai: false- Nilai contoh
no - Contoh ungkapan Bubble
GuideHost's is_busy (your yes/no custom state) - Lumpuhkan elemen semasa aplikasi anda sibuk atau tindakan ini tidak tersedia.
show_controlsyes_no · Lalai: true- Nilai contoh
yes - Contoh ungkapan Bubble
App Settings' show_editor_controls - Tunjukkan atau sembunyikan kawalan terbina.
crop_aspecttext · Lalai: "free"- Nilai contoh
1:1 - Contoh ungkapan Bubble
Avatar Settings' crop_ratio - Gunakan nilai rekod perniagaan semasa; sahkan ia terhadap had di bawah.
export_formattext · Lalai: "jpeg"- Nilai contoh
jpeg - Contoh ungkapan Bubble
Format Dropdown's value - Gunakan nilai rekod perniagaan semasa; sahkan ia terhadap had di bawah.
export_qualitynumber · Lalai: 0.85- Nilai contoh
0.85 - Contoh ungkapan Bubble
Image Settings' quality - Gunakan nilai rekod perniagaan semasa; sahkan ia terhadap had di bawah.
export_max_dimensionnumber · Lalai: 2048- Nilai contoh
2048 - Contoh ungkapan Bubble
Image Settings' max_side - Gunakan nilai rekod perniagaan semasa; sahkan ia terhadap had di bawah.
allow_upscaleyes_no · Lalai: false- Nilai contoh
no - Contoh ungkapan Bubble
Allow upscale Checkbox is checked - Gunakan nilai rekod perniagaan semasa; sahkan ia terhadap had di bawah.
ui_text_jsontext · Lalai: ""- Nilai contoh
{} - Contoh ungkapan Bubble
App Settings' player_labels_json (supported keys only) - JSON pilihan dengan label butang yang disokong. Biarkan kosong untuk menggunakan teks terbina dalam.
languagetext · Lalai: "auto"- Nilai contoh
uk - Contoh ungkapan Bubble
Current User's preferred_language - Tetapkan language=auto untuk mengikuti peranti atau bahasa pelayar yang disokong. Masukkan kod bahasa yang disokong untuk memilihnya secara eksplisit.
Tindakan dan inputnya · 13
Load source
Tiada parameter tindakan
Begin crop
Tiada parameter tindakan
Apply crop
origin_xnumber · Lalai: —- Nilai contoh
0 - Contoh ungkapan Bubble
Crop Settings' x (or omit all rectangle inputs) - Gunakan nilai rekod perniagaan semasa; sahkan ia terhadap had di bawah.
origin_ynumber · Lalai: —- Nilai contoh
0 - Contoh ungkapan Bubble
Crop Settings' y (or omit all rectangle inputs) - Gunakan nilai rekod perniagaan semasa; sahkan ia terhadap had di bawah.
widthnumber · Lalai: —- Nilai contoh
512 - Contoh ungkapan Bubble
Resize Width Input's value:converted to number - Gunakan nilai rekod perniagaan semasa; sahkan ia terhadap had di bawah.
heightnumber · Lalai: —- Nilai contoh
512 - Contoh ungkapan Bubble
Resize Height Input's value:converted to number - Gunakan nilai rekod perniagaan semasa; sahkan ia terhadap had di bawah.
Cancel crop
Tiada parameter tindakan
Rotate
degreesnumber · Lalai: —- Nilai contoh
90 - Contoh ungkapan Bubble
Rotation Dropdown's value - Gunakan nilai rekod perniagaan semasa; sahkan ia terhadap had di bawah.
Flip
axistext · Lalai: —- Nilai contoh
horizontal - Contoh ungkapan Bubble
Flip Direction Dropdown's value - Gunakan nilai rekod perniagaan semasa; sahkan ia terhadap had di bawah.
Resize
widthnumber · Lalai: —- Nilai contoh
512 - Contoh ungkapan Bubble
Resize Width Input's value:converted to number - Gunakan nilai rekod perniagaan semasa; sahkan ia terhadap had di bawah.
heightnumber · Lalai: —- Nilai contoh
512 - Contoh ungkapan Bubble
Resize Height Input's value:converted to number - Gunakan nilai rekod perniagaan semasa; sahkan ia terhadap had di bawah.
Undo
Tiada parameter tindakan
Redo
Tiada parameter tindakan
Reset edits
Tiada parameter tindakan
Export image
Tiada parameter tindakan
Cancel operation
Tiada parameter tindakan
Clear session
Tiada parameter tindakan
Keadaan dan peristiwa
Keadaan
editor_status · textKeputusan semasa tindakan ini. Gunakan acara selesai yang sepadan sebelum menyimpan kejayaan.
is_busy · yes_noKerja masih dalam proses. Tunggu sebelum memulakan tindakan lain.
has_image · yes_noNilai semasa untuk item yang dipilih. Baca selepas acara berkaitan.
has_changes · yes_noNilai semasa untuk item yang dipilih. Baca selepas acara berkaitan.
can_undo · yes_noNilai semasa untuk item yang dipilih. Baca selepas acara berkaitan.
can_redo · yes_noNilai semasa untuk item yang dipilih. Baca selepas acara berkaitan.
image_width · numberNilai semasa untuk item yang dipilih. Baca selepas acara berkaitan.
image_height · numberNilai semasa untuk item yang dipilih. Baca selepas acara berkaitan.
output_uri · textLokasi fail pada peranti ini. Simpan atau muat naik fail secara berasingan jika ia perlu disimpan dalam talian.
output_width · numberNilai semasa untuk item yang dipilih. Baca selepas acara berkaitan.
output_height · numberNilai semasa untuk item yang dipilih. Baca selepas acara berkaitan.
output_bytes · numberNilai semasa untuk item yang dipilih. Baca selepas acara berkaitan.
output_mime · textNilai semasa untuk item yang dipilih. Baca selepas acara berkaitan.
error_code · textMaklumat ralat untuk tindakan terakhir. Tunjukkan mesej bantuan dan tawarkan percubaan semula yang relevan.
crop_active · yes_noNilai semasa untuk item yang dipilih. Baca selepas acara berkaitan.
crop_rect_json · textNilai semasa untuk item yang dipilih. Baca selepas acara berkaitan.
Acara
source_loadedApabila acara ini berlaku, baca keadaan berkaitan dari elemen yang sama.
source_load_failedApabila acara ini berlaku, baca keadaan berkaitan dari elemen yang sama.
edit_appliedApabila acara ini berlaku, baca keadaan berkaitan dari elemen yang sama.
edit_undoneApabila acara ini berlaku, baca keadaan berkaitan dari elemen yang sama.
edit_redoneApabila acara ini berlaku, baca keadaan berkaitan dari elemen yang sama.
editor_resetApabila acara ini berlaku, baca keadaan berkaitan dari elemen yang sama.
export_startedApabila acara ini berlaku, baca keadaan berkaitan dari elemen yang sama.
export_completedApabila acara ini berlaku, baca keadaan berkaitan dari elemen yang sama.
operation_cancelledApabila acara ini berlaku, baca keadaan berkaitan dari elemen yang sama.
editor_errorApabila acara ini berlaku, baca keadaan berkaitan dari elemen yang sama.
Soalan yang ditanya pembangun
Adakah output_uri merupakan Fail Bubble?
Tidak. Ia merupakan laluan cache tempatan. Kekalkan ia melalui penyimpan atau pemuat naik tempatan yang terbukti sebelum menyimpan rujukan fail awan.
Bagaimana langganan berfungsi?
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.
Panduan berkaitan
Untuk bantuan, beritahu kami plugin dan peranti yang anda gunakan, tindakan yang anda cuba serta apa yang terjadi. Gunakan contoh tanpa data peribadi. Jangan sekali-kali kongsikan kunci atau fail peribadi anda.