Xodera Plugins · Bubble Native
Xodera Photo Editor Native
選択した写真を一貫したアバター、製品画像、またはレポート添付ファイルに変換します。トリミング、回転、リサイズを行い、エクスポートされたコピーをアプリに保存してください。
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.
ドキュメント確認日：2026年11月6日
実用的な例
アップロード前の一貫したプロフィールアバター
ユーザーは任意のトリミングを受け入れるのではなく、写真のどの部分を正方形のプロフィール画像に使用するか選択すべきです。
`source_url = selected profile image`; `crop_aspect = "1:1"`; `document_context = the account’s stable reference`.
`source_loaded`が完了するまで待ちます；Begin crop → Apply crop、必要に応じてRotateまたはUndoを使用します。明示的な Save 操作で Export image を実行します。
`export_completed`が完了したときのみ、`output_uri`、`output_width`、`output_height`、`output_mime`をファイルアップロードワークフローの入力として使用してください。その後、永続的な参照をProfile に保存します。
ユーザーがキャンセルした場合、または`editor_error`が発生した場合は、古いアバターを保持します。アカウント変更時にセッションをクリアし、別のユーザーがドラフトを見ることができないようにします。
編集はローカルコピーを作成します。アプリが保存またはアップロード方法を選択します。
一貫したマーケットプレイスまたはカタログ用の写真を用意する
異なるフレーミングや過大な画像はカタログを不均一にし、アップロードサイズを増加させます。
`source_url = selected item photo`; `crop_aspect = the app’s chosen ratio`; `export_max_dimension`、`export_format`、`export_quality`は、あなたのアップロードポリシーから取得されます。
対象領域を切り取ります。必要に応じてResizeを行い、ユーザーが確認した後にExport imageを実行します。元のファイル/参照は別に保持してください。
アップロードワークフローが結果を保存する前に、`output_width`、`output_height`、`output_bytes`、`output_mime`を確認してください。生成された画像参照はItemに保存します。
エクスポートが失敗した場合、または結果がアップロードポリシーに違反する場合は、`error_code`を表示し、ユーザーに修正させてください。アップロード確認前に以前のItem画像を上書きしないでください。
編集はローカルコピーを作成します。アプリが保存またはアップロード方法を選択します。
フィールドレポート用にフォーカスされた画像コピーを作成する
技術者は、元のレポート画像を保持しつつ、損傷した部品のクローズアップが必要になる場合があります。
`source_url = Current Report Photo’s source`; `document_context = the report/account reference`; クロップ比率は制限しなくても構いません。
Begin crop → Apply crop、次にUndo/Redoを使用して編集を比較します。Export imageは編集されたコピーを作成します。アプリはそのコピーをReport に添付するかどうかを尋ねます。
`has_changes`、`can_undo`、`can_redo`、`output_uri`を使用してください。アップロードが成功した後、元の参照と編集後の参照を別々のアプリフィールドに保存します。
Cancel crop または Reset edits は編集パスを復元します。キャンセルは元の Report 添付ファイルを変更せずに残す必要があります。
編集はローカルコピーを作成します。アプリが保存またはアップロード方法を選択します。
現在機能しているもの
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.
ワークフローを構築する
以下の利用可能なベータアクションを使用し、対象デバイスで結果をテストしてください。
これらの例は Lesson、Message、Order などのアプリレコードを使用しています。ご自身のデータ型や要素名に置き換えてください。メディアアドレスの例はご自身のファイルに置き換える必要があります。
選択した画像を source_url に設定します。document_context を使用して編集対象のアカウントとレコードを特定し、レコードを変更すると前の写真がクリアされます。
source_loaded の後、Begin crop を実行します。アバター用に 1:1 を選択し、トリミングを調整して Apply crop を使用します。Cancel crop は画像を変更せずに残します。
必要に応じて Rotate、Flip、または Resize を使用してください。Undo と Redo は完了した編集を元に戻したり、やり直したりし、Reset edits は元の画像を復元します。
Export image を実行します。export_completed で output_uri、output_width、output_height、output_mime を読み取ります。選択したファイル保存ワークフローでそのコピーを保存またはアップロードし、保存したファイルをレコードに格納します。
一度だけ設定する
このプラグインのキーによる有効化は、今後対応予定です。BestPlugins → Dashboard → PluginsでBubbleアプリのプロジェクトを作成するか、既存のプロジェクトを選択してください。Xodera Photo Editor Nativeを選択してキーをコピーし、Bubble → Plugins → Xodera Photo Editor Nativeを開いてlicensing_api_keyに貼り付けます。一度保存したら、以下のアクションを使用してください。各プロジェクトの各プラグインには、それぞれ固有のキーがあります。
まずアプリで画像を選択または撮影してください。エディタに読み取り可能な画像アドレスを渡します。カメラおよびフォトライブラリの権限は使用するピッカーに属します。
一度だけ設定する
- BestPlugins → Dashboard → Plugins で Bubble アプリプロジェクトを作成または選択してください。
- このプラグインを選択し、プロジェクトキーをコピーしてください。
- Open Bubble → Plugins → this plugin. Paste its project key into licensing_api_key and save.
- 要素を追加し、アプリデータを選択して、以下のワークフローを構築してください。
- 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.
インストールとサブスクリプション
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.
結果をアプリに保存する
アップロードされた画像または永続的に保存された画像を Profile.image または添付フィールドに保存します。output_uri はデバイス上の一時ファイルなので、まず選択したワークフローでそのファイルを保存してください。その後、output_width、output_height、output_mime をメタデータとして保存します。両方のバージョンが必要な場合は元の画像を保持してください。
失敗、キャンセル、リカバリー
source_load_failed または editor_error で、error_code を表示し、Load source を提供します。Cancel operation は未完成の結果の受け取りを停止します。次の編集を開始する前に is_busy=no まで待ってください。Clear session はエディタをクリアしますが、他所に保存された画像は削除しません。
機能と制限
JPEG と PNG をエクスポートします；品質は 0〜1；最大出力辺長は 1〜4096 ピクセルです。入力は最大 15 MiB および 20 メガピクセルまで。完了済み編集は最大 20 件です。トリミング選択肢：free、1:1、4:3、3:4、16:9。内蔵カメラ、フィルター、テキストオーバーレイ、遠近補正、WebP エクスポート、または自動アップロードはありません。
設定、アクション、結果
Bubbleでこれらの名前を使用してください。計画中の機能は別途マークされています。
利用可能なベータ設定
要素設定
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ステート
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イベント
source_loadedsource_load_failededit_appliededit_undoneedit_redoneeditor_resetexport_startedexport_completedoperation_cancellededitor_errorアクションとその入力
Load sourceBegin cropApply cropCancel cropRotateFlipResizeUndoRedoReset editsExport imageCancel operationClear session要素設定 · 12
source_urltext · デフォルト: ""- 例の値
https://bestplugins.online/native-samples/avatar.jpg - 例 Bubble 式
Selected Profile's image_url - 選択された音声、動画、画像ファイルのアドレスです。このプラグインがサポートするファイルタイプを使用してください。
document_contexttext · デフォルト: ""- 例の値
<current-user-id> - 例 Bubble 式
Current User's unique id - このアカウントまたはレコードの安定した値です。保存されたファイルやドラフトを復元する際は同じ値を使用してください。
is_activeyes_no · デフォルト: true- 例の値
yes - 例 Bubble 式
GuideHost's view_is_active (your yes/no custom state) - このビューが開いている間はyesに設定し、離れる際はnoに設定して、再生や現在の作業を停止できるようにします。
disabledyes_no · デフォルト: false- 例の値
no - 例 Bubble 式
GuideHost's is_busy (your yes/no custom state) - アプリがビジー状態またはこのアクションが利用できない場合は要素を無効にします。
show_controlsyes_no · デフォルト: true- 例の値
yes - 例 Bubble 式
App Settings' show_editor_controls - 組み込みコントロールを表示または非表示にします。
crop_aspecttext · デフォルト: "free"- 例の値
1:1 - 例 Bubble 式
Avatar Settings' crop_ratio - 現在のビジネスレコードの値を使用し、以下の制限と照合して検証してください。
export_formattext · デフォルト: "jpeg"- 例の値
jpeg - 例 Bubble 式
Format Dropdown's value - 現在のビジネスレコードの値を使用し、以下の制限と照合して検証してください。
export_qualitynumber · デフォルト: 0.85- 例の値
0.85 - 例 Bubble 式
Image Settings' quality - 現在のビジネスレコードの値を使用し、以下の制限と照合して検証してください。
export_max_dimensionnumber · デフォルト: 2048- 例の値
2048 - 例 Bubble 式
Image Settings' max_side - 現在のビジネスレコードの値を使用し、以下の制限と照合して検証してください。
allow_upscaleyes_no · デフォルト: false- 例の値
no - 例 Bubble 式
Allow upscale Checkbox is checked - 現在のビジネスレコードの値を使用し、以下の制限と照合して検証してください。
ui_text_jsontext · デフォルト: ""- 例の値
{} - 例 Bubble 式
App Settings' player_labels_json (supported keys only) - サポートされているボタンラベルを含むオプションの JSON です。空欄にすると組み込みテキストが使用されます。
languagetext · デフォルト: "auto"- 例の値
uk - 例 Bubble 式
Current User's preferred_language - language=auto を設定して、サポートされているデバイスまたはブラウザ言語に従わせます。サポートされている言語コードを入力して明示的に選択してください。
アクションとその入力 · 13
Load source
アクションパラメータなし
Begin crop
アクションパラメータなし
Apply crop
origin_xnumber · デフォルト: —- 例の値
0 - 例 Bubble 式
Crop Settings' x (or omit all rectangle inputs) - 現在のビジネスレコードの値を使用し、以下の制限と照合して検証してください。
origin_ynumber · デフォルト: —- 例の値
0 - 例 Bubble 式
Crop Settings' y (or omit all rectangle inputs) - 現在のビジネスレコードの値を使用し、以下の制限と照合して検証してください。
widthnumber · デフォルト: —- 例の値
512 - 例 Bubble 式
Resize Width Input's value:converted to number - 現在のビジネスレコードの値を使用し、以下の制限と照合して検証してください。
heightnumber · デフォルト: —- 例の値
512 - 例 Bubble 式
Resize Height Input's value:converted to number - 現在のビジネスレコードの値を使用し、以下の制限と照合して検証してください。
Cancel crop
アクションパラメータなし
Rotate
degreesnumber · デフォルト: —- 例の値
90 - 例 Bubble 式
Rotation Dropdown's value - 現在のビジネスレコードの値を使用し、以下の制限と照合して検証してください。
Flip
axistext · デフォルト: —- 例の値
horizontal - 例 Bubble 式
Flip Direction Dropdown's value - 現在のビジネスレコードの値を使用し、以下の制限と照合して検証してください。
Resize
widthnumber · デフォルト: —- 例の値
512 - 例 Bubble 式
Resize Width Input's value:converted to number - 現在のビジネスレコードの値を使用し、以下の制限と照合して検証してください。
heightnumber · デフォルト: —- 例の値
512 - 例 Bubble 式
Resize Height Input's value:converted to number - 現在のビジネスレコードの値を使用し、以下の制限と照合して検証してください。
Undo
アクションパラメータなし
Redo
アクションパラメータなし
Reset edits
アクションパラメータなし
Export image
アクションパラメータなし
Cancel operation
アクションパラメータなし
Clear session
アクションパラメータなし
ステートとイベント
ステート
editor_status · textこのアクションの現在の結果です。成功を保存する前に、対応する完了イベントを使用してください。
is_busy · yes_no作業はまだ進行中です。別の操作を開始する前にお待ちください。
has_image · yes_no選択された項目の現在の値です。関連イベントの後に読み取ります。
has_changes · yes_no選択された項目の現在の値です。関連イベントの後に読み取ります。
can_undo · yes_no選択された項目の現在の値です。関連イベントの後に読み取ります。
can_redo · yes_no選択された項目の現在の値です。関連イベントの後に読み取ります。
image_width · number選択された項目の現在の値です。関連イベントの後に読み取ります。
image_height · number選択された項目の現在の値です。関連イベントの後に読み取ります。
output_uri · textこのデバイス上のファイル場所です。オンラインで保持する必要がある場合は、ファイルを別途保存またはアップロードしてください。
output_width · number選択された項目の現在の値です。関連イベントの後に読み取ります。
output_height · number選択された項目の現在の値です。関連イベントの後に読み取ります。
output_bytes · number選択された項目の現在の値です。関連イベントの後に読み取ります。
output_mime · text選択された項目の現在の値です。関連イベントの後に読み取ります。
error_code · text直前のアクションのエラー情報です。役立つメッセージを表示し、該当する再試行を提供してください。
crop_active · yes_no選択された項目の現在の値です。関連イベントの後に読み取ります。
crop_rect_json · text選択された項目の現在の値です。関連イベントの後に読み取ります。
イベント
source_loadedこのイベントが発生したとき、同じ要素から関連する状態を読み取ります。
source_load_failedこのイベントが発生したとき、同じ要素から関連する状態を読み取ります。
edit_appliedこのイベントが発生したとき、同じ要素から関連する状態を読み取ります。
edit_undoneこのイベントが発生したとき、同じ要素から関連する状態を読み取ります。
edit_redoneこのイベントが発生したとき、同じ要素から関連する状態を読み取ります。
editor_resetこのイベントが発生したとき、同じ要素から関連する状態を読み取ります。
export_startedこのイベントが発生したとき、同じ要素から関連する状態を読み取ります。
export_completedこのイベントが発生したとき、同じ要素から関連する状態を読み取ります。
operation_cancelledこのイベントが発生したとき、同じ要素から関連する状態を読み取ります。
editor_errorこのイベントが発生したとき、同じ要素から関連する状態を読み取ります。
開発者が尋ねる質問
output_uriはBubble Fileですか？
いいえ。ローカルキャッシュパスです。クラウドファイル参照を保存する前に、信頼できるローカルセーバーまたはアップローダーで永続化してください。
サブスクリプションはどのように機能しますか？
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.
関連ガイド
サポートが必要な場合は、使用しているプラグインとデバイス、試したアクションと結果をお知らせください。個人データを含まない例を使用してください。キーやプライベートファイルを決して共有しないでください。