Xodera Plugins · Bubble Native
Xodera QR Passes 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日
実用的な例
同日イベント用の単一使用入場
通常の QR 値のスクリーンショットは、複数の入口で再利用される可能性があります。
アプリは Admission レコードと安定した発行 `request_id` を保存します。`label=event` と `ttl_seconds` を 1–86400 秒の契約内で使用してください。
認可された発行者は Issue QR pass を実行し、返された QR を非公開で配信します。スタッフはスキャン → Check QR pass → `ok=yes` かつ `status=available` の場合にのみ確認 → 保存された安定したリクエスト ID を使用して Confirm QR redemption を実行します。
`status=redeemed` と `receipt_id` のみがアプリの Admission 領収書を認可します。Admission にパス/領収書参照を保存し、QR の内容を分析に公開しないでください。
`outcome_unknown` の場合、同一のユーザー/環境/パスで同じリクエストを復元してください。新しい確認 ID を生成してはいけません。expired、revoked、既に使用された状態は別個の結果として処理します。
計画中です。スキャンとチェックではパスを消費しません。パスを消費するのは明示的な確認だけです。
パートナーのカウンターで短期間有効な特典を一度だけ利用してください。
パートナーは QR の画像や画面アニメーションを信頼するのではなく、使用済み/未使用の確定結果を必要とします。
`label=coupon`；アプリの Benefit レコードで、認可された発行アクションを行う前に、適格性と短い有効期間を定義します。
アプリの適格性チェックの後にのみパスを発行してください。カウンターでは、Check QR pass がパスを消費せずに利用可否を示します。スタッフがベネフィットの配信を確認した後、Confirm QR redemption を実行します。
Benefit レコードは `receipt_id` と `status=redeemed` 後の確定された引換時間を保存できる場合があります。プラグインはパスの状態を管理し、アプリはベネフィットと顧客関係を管理します。
ベネフィットが使用前にキャンセルされた場合、同じ認可された発行者は `pass_id` を使用して Revoke QR pass を行うことができます。`ok=yes` のみで返金や成功した引換を発表しないでください。
計画中です。スキャンとチェックではパスを消費しません。パスを消費するのは明示的な確認だけです。
同日設備または注文の受取を確認してください。
スタッフのワークフローは、受取用の参照のスキャンと実際にアイテムを手渡すことを区別する必要があります。
アプリが所有する Collection レコードは認可、対象アイテム、別個の安定した発行/引換リクエスト ID を保持します。短命な `label=access` パスを使用してください。
アプリが受取を許可した後、Issue QR pass を実行します。スタッフがスキャンして Check を行い、アプリ内の該当する Collection を確認し、受け渡しを明示的に確認してから Confirm QR redemption を実行します。
確認済みの`redeemed`領収書がある場合にのみ、ワークフローで Collection を受け渡し済みと設定してください。`receipt_id`はパス結果へのリンクとして保持します。
再スキャンするとalready_usedが返されることがあります；別のアイテムを受け渡すのではなく、既存のアプリレコードを表示してください。同じIDと入力で不確かな確認を復元します。
計画中です。スキャンとチェックではパスを消費しません。パスを消費するのは明示的な確認だけです。
現在機能しているもの
プライベートベータです。現在のスキャナーはカメラと権限コントロールを備えています。一回限りのパスの作成、確認、使用確認は計画中で、まだアプリで使用できる状態ではありません。
ワークフローを構築する
計画中
計画中のワークフローです。現在のベータ版ではまだ利用できません。
これらの例は Lesson、Message、Order などのアプリレコードを使用しています。ご自身のデータ型や要素名に置き換えてください。メディアアドレスの例はご自身のファイルに置き換える必要があります。
計画: 認可された従業員が Issue QR pass をAdmission または Order 用に使用します。例: label=event、ttl_seconds=900、environment=development。その発行のために安定した request_id を保持し、pass_id をレコードに保存してください。
返却された QR を対象者に見せてください。スタッフがスキャンします。計画されたパスワークフローでは、workflow_mode=yes を使用し、scanned_pass_token を pass_scanned 後に読み取ります。これらのパスワークフロー設定は現在のスキャナーでは利用できません。
Check QR pass を pass_token = QR Scanner's scanned_pass_token と共に実行します。パスを使用せずにチェックします。status=available の場合、該当する注文またはエントリ詳細を表示し、スタッフが確認できるようにします。
別個の Confirm ボタンのみが、同じ pass_token、安定した request_id と confirm=yes を使用して Confirm QR redemption を実行します。status=redeemed で receipt_id を保存し、注文またはエントリを完了としてマークしてください。
already_used、expired、revoked、または invalid は、入場または注文の引き渡しを行わないことを意味します。スキャンや単独の成功したチェックだけでは取引は完了しません。
一度だけ設定する
Bubble アプリプロジェクトを BestPlugins → Dashboard → Plugins で作成または選択します。Xodera QR Passes Native を選び、キーをコピーし、次に Bubble → Plugins → Xodera QR Passes Native を開いて project_api_key に貼り付けます。一度保存し、以下のアクションを使用してください。各プロジェクトの各プラグインはそれぞれ固有のキーを持ちます。
スキャンにはカメラ許可が必要です。ワンタイムパスについて、誰がパスを作成でき、誰がドアや受取場所で確認できるかを決定してください。一般顧客はスタッフロールを必要としません。
qr_issuer_permission_field
qr_pass_issuer · パスの作成または取り消しを許可された従業員を示すUser の yes/no フィールドの名前です。例/デフォルト: qr_pass_issuer。ここにはフィールド名を入力し、yes や no は入力しないでください。この権限は認可された管理者のみがユーザーに対して変更すべきです。
qr_staff_permission_field
qr_staff · 使用の確認とチェックを許可されたスタッフを示すUser の yes/no フィールドの名前です。例/デフォルト: qr_staff。チケット保有者はこの権限を必要としません。公開のサインアップやプロフィールフォームには含めないでください。
一度だけ設定する
- BestPlugins → Dashboard → Plugins で Bubble アプリプロジェクトを作成または選択してください。
- このプラグインを選択し、プロジェクトキーをコピーしてください。
- Bubble → Plugins → Xodera QR Passes Native を開き、キーを project_api_key に貼り付けて保存してください。
- 要素を追加し、アプリデータを選択して、以下のワークフローを構築してください。
- 現在はプライベートベータアクセスのみです。一般公開インストールや有料アクティベーションはまだ利用できません。
インストールとサブスクリプション
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.
結果をアプリに保存する
例: Admission または Pickup: 関連する注文/イベントを保存し、pass_id、expires_at、issue_request_id を記録します。確認済み使用後、receipt_id、redeemed_at と確認した従業員を追加してください。コードが単にスキャンまたはチェックされただけの場合、レコードを完了としてマークしないでください。QR コードは人物の身元を確認するものではありません。
失敗、キャンセル、リカバリー
outcome_unknown=yes の場合、結果を再確認する際に同じパス、request_id および入力を保持してください。新しい確認を作成しないでください。already_used、expired、revoked は最終的なビジネス結果です。権限が拒否された場合、認可された管理者に従業員のロールをレビューしてもらってください。Clear session はスキャナーをリセットします；完了した使用を元に戻すことはできません。
機能と制限
計画されたパスは単一使用で、寿命は 1–86400 秒です；デフォルトは 900。パスタイプ: access、event、coupon、membership。チェックはパスを予約しません。パス使用にはインターネット接続が必要です。支払い処理、本人確認、または再利用可能な長期会員カードはありません。通常の QR 値の読み取りは、パスのチェックとは別です。
設定、アクション、結果
Bubbleでこれらの名前を使用してください。計画中の機能は別途マークされています。
利用可能なベータ設定
要素設定
disabled · yes/nois_active · yes/noui_text_json · textlanguage · textステート
scanner_status · textserver_status · textpass_id · textpass_label · textreceipt_id · texterror_code · textis_busy · yes/nois_scanning · yes/notorch_enabled · yes/noscan_source · textpending_redemption · yes/noイベント
scanner_startedscanner_pausedscanner_cancelledpermission_deniedpass_scannedvalidation_startedvalidation_completedredemption_startedpass_redeemedredemption_rejectedredemption_pendingfixture_decodedqr_errorアクションとその入力
Clear session要素設定 · 5
計画中のワークフローです。現在のベータ版ではまだ利用できません。
disabledyes/no · デフォルト: false- 例の値
no - 例 Bubble 式
GuideHost's is_busy (your yes/no custom state) - アプリがビジー状態またはこのアクションが利用できない場合は要素を無効にします。
is_activeyes/no · デフォルト: true- 例の値
yes - 例 Bubble 式
GuideHost's view_is_active (your yes/no custom state) - このビューが開いている間はyesに設定し、離れる際はnoに設定して、再生や現在の作業を停止できるようにします。
ui_text_jsontext · デフォルト: "{}"- 例の値
{} - 例 Bubble 式
App Settings' player_labels_json (supported keys only) - サポートされているボタンラベルを含むオプションの JSON です。空欄にすると組み込みテキストが使用されます。
languagetext · デフォルト: "auto"- 例の値
uk - 例 Bubble 式
Current User's preferred_language - language=auto を設定して、サポートされているデバイスまたはブラウザ言語に従わせます。サポートされている言語コードを入力して明示的に選択してください。
workflow_modeyes/no · デフォルト: false- 例の値
yes - 例 Bubble 式
App Settings' use_qr_business_actions - 予定: スキャンされたQRの値をCheck QR passが使用できるようにします。スキャンだけでは入場や受取が確認されません。
アクションとその入力 · 5
計画中のワークフローです。現在のベータ版ではまだ利用できません。
Clear session
アクションパラメータなし
Issue QR pass
environmenttext · デフォルト: "development"- 例の値
development - 例 Bubble 式
App Settings' selected_environment - 現在のビジネスレコードの値を使用し、以下の制限と照合して検証してください。
request_idtext · デフォルト: —- 例の値
pickup-123-issue-v1 - 例 Bubble 式
Current Admission's stable_request_id - 現在のビジネスレコードの値を使用し、以下の制限と照合して検証してください。
labeltext · デフォルト: "access"- 例の値
event - 例 Bubble 式
Selected Admission's pass_label - 現在のビジネスレコードの値を使用し、以下の制限と照合して検証してください。
ttl_secondsnumber · デフォルト: 900- 例の値
900 - 例 Bubble 式
Event Settings' pass_ttl_seconds - 現在のビジネスレコードの値を使用し、以下の制限と照合して検証してください。
戻り値
pass_id · textpass_token · textpass_label · textexpires_at · textqr_png_data_uri · textreused · yes/noCheck QR pass
environmenttext · デフォルト: "development"- 例の値
development - 例 Bubble 式
App Settings' selected_environment - 現在のビジネスレコードの値を使用し、以下の制限と照合して検証してください。
pass_tokentext · デフォルト: —- 例の値
<opaque token returned by Issue / camera scan> - 例 Bubble 式
QR Pass Scanner's scanned_pass_token (capture before Check) - 現在のビジネスレコードの値を使用し、以下の制限と照合して検証してください。
戻り値
pass_label · textexpires_at · textConfirm QR redemption
environmenttext · デフォルト: "development"- 例の値
development - 例 Bubble 式
App Settings' selected_environment - 現在のビジネスレコードの値を使用し、以下の制限と照合して検証してください。
pass_tokentext · デフォルト: —- 例の値
<opaque token returned by Issue / camera scan> - 例 Bubble 式
QR Pass Scanner's scanned_pass_token (capture before Check) - 現在のビジネスレコードの値を使用し、以下の制限と照合して検証してください。
request_idtext · デフォルト: —- 例の値
pickup-123-redeem-v1 - 例 Bubble 式
Current Admission's stable_redemption_request_id - 現在のビジネスレコードの値を使用し、以下の制限と照合して検証してください。
confirmyes/no · デフォルト: false- 例の値
yes — explicit confirmation only - 例 Bubble 式
Confirm Checkbox is checked - 現在のビジネスレコードの値を使用し、以下の制限と照合して検証してください。
戻り値
pass_id · textpass_label · textreceipt_id · textredeemed_at · textreused · yes/noRevoke QR pass
environmenttext · デフォルト: "development"- 例の値
development - 例 Bubble 式
App Settings' selected_environment - 現在のビジネスレコードの値を使用し、以下の制限と照合して検証してください。
pass_idtext · デフォルト: —- 例の値
<pass_id returned by Issue> - 例 Bubble 式
Selected Admission's pass_id - 現在のビジネスレコードの値を使用し、以下の制限と照合して検証してください。
戻り値
pass_id · textrevoked · yes/noステートとイベント
計画中のワークフローです。現在のベータ版ではまだ利用できません。
ステート
scanner_status · textこのアクションの現在の結果です。成功を保存する前に、対応する完了イベントを使用してください。idle,requesting_permission,permission_denied,scanning,paused,scanned,validating,available,redeeming,redeemed,unavailable,unknown,error,cancelled,decoding_fixture,fixture_decoded
server_status · textこのアクションの現在の結果です。成功を保存する前に、対応する完了イベントを使用してください。empty,available,redeemed,already_used,expired,revoked
pass_id · textこの項目またはアクションの識別子。対応するアプリレコードと共に保持してください。不確かな結果を再試行する際は同じリクエスト識別子を使用します。
pass_label · text選択された項目の現在の値です。関連イベントの後に読み取ってください。empty,access,event,coupon,membership
receipt_id · textこの項目またはアクションの識別子。対応するアプリレコードと共に保持してください。不確かな結果を再試行する際は同じリクエスト識別子を使用します。
error_code · text直前のアクションのエラー情報です。役立つメッセージを表示し、該当する再試行を提供してください。
is_busy · yes/no作業はまだ進行中です。別の操作を開始する前にお待ちください。
is_scanning · yes/no選択された項目の現在の値です。関連イベントの後に読み取ります。
torch_enabled · yes/no選択された項目の現在の値です。関連イベントの後に読み取ります。
scan_source · text選択された項目の現在の値です。関連イベントの後に読み取ってください。empty,camera,fixture
pending_redemption · yes/no選択された項目の現在の値です。関連イベントの後に読み取ります。
scanned_pass_token · text選択された項目の現在の値です。関連イベントの後に読み取ります。
イベント
scanner_startedこのイベントが発生したとき、同じ要素から関連する状態を読み取ります。
scanner_pausedこのイベントが発生したとき、同じ要素から関連する状態を読み取ります。
scanner_cancelledこのイベントが発生したとき、同じ要素から関連する状態を読み取ります。
permission_deniedこのイベントが発生したとき、同じ要素から関連する状態を読み取ります。
pass_scannedこのイベントが発生したとき、同じ要素から関連する状態を読み取ります。
validation_startedこのイベントが発生したとき、同じ要素から関連する状態を読み取ります。
validation_completedこのイベントが発生したとき、同じ要素から関連する状態を読み取ります。
redemption_startedこのイベントが発生したとき、同じ要素から関連する状態を読み取ります。
pass_redeemedこのイベントが発生したとき、同じ要素から関連する状態を読み取ります。
redemption_rejectedこのイベントが発生したとき、同じ要素から関連する状態を読み取ります。
redemption_pendingこのイベントが発生したとき、同じ要素から関連する状態を読み取ります。
fixture_decodedこのイベントが発生したとき、同じ要素から関連する状態を読み取ります。
qr_errorこのイベントが発生したとき、同じ要素から関連する状態を読み取ります。
開発者が尋ねる質問
この2つの権限設定は何を意味しますか？
従業員がパスを作成または取り消すことを許可する User の yes/no フィールド名。例/デフォルト: qr_pass_issuer。ここにフィールド名を入力してください。yes や no は入力しないでください。権限は認可された管理者のみが変更すべきです。スタッフがチェックおよび使用確認を行える User の yes/no フィールド名。例/デフォルト: qr_staff。チケット保有者はこの権限を必要としません。公開サインアップやプロフィールフォームからは除外してください。
同じ従業員がパスの作成とチェックの両方を行えますか？
はい、認可された管理者がその従業員に両方の権限を付与すれば可能です。別のプロジェクトキーは必要ありません。顧客は通常どちらの権限も必要としません。ユーザーが自分でこれらの権限を割り当てることは許可しないでください。
スキャン後にチェックを使用する理由は何ですか？
スキャンはコードを読み取ります。チェックはパスを使用せずに利用可能かどうかを問い合わせます。スタッフはまず注文を確認できます。別個の Confirm QR redemption アクションのみがパスを一度使用します。
サブスクリプションはどのように機能しますか？
計画価格: Bubble にプラグインをインストールすることは無料です。BestPlugins へのアクセスは各 Bubble アプリプロジェクトの各プラグインごとに別々のサブスクリプションが必要です: 7 日間は無料、その後 US$1.50 /月です。Development と Live は含まれています。操作回数に固定上限はありませんが、ファイルサイズと機能制限は引き続き適用されます。チェックアウトはまだ開いていません。アクティベーション画面に最初の請求日とキャンセル条件が表示されます。
関連ガイド
Marketplaceリリース保留中
フォーラムガイドは未掲載
サポートが必要な場合は、使用しているプラグインとデバイス、試したアクションと結果をお知らせください。個人データを含まない例を使用してください。キーやプライベートファイルを決して共有しないでください。