QR szkenner felület. Egyszeri átmeneti műveletek tervezettek.
QR szkenner felület. Egyszeri átmeneti műveletek tervezettek.
← Minden natív útmutató

Xodera Plugins · Bubble Native

Xodera QR Passes Native

Készítsen egyszeri jegyeket, átvételi visszaigazolásokat vagy kuponokat. A személyzet beolvassa a kódot, ellenőrzi az eredményt, megtekinti a megrendelést, és csak készen állva erősíti meg a felhasználást.

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

Egyszeri belépő ugyanazon napra szóló eseményhez

Egy szokásos QR érték képernyőképe egyébként több bejáratnál is felhasználható.

Az alkalmazásod tárol egy Admission rekordot és egy stabil kiadást `request_id`; használjon kurált `label=event` és egy `ttl_seconds` a 1–86400 másodperces szerződésen belül.

Egy jogosult kibocsátó futtatja a Issue QR pass-t és privát módon kézbesíti a visszakapott QR-t. A személyzet beolvas → Check QR pass → megerősít csak ha `ok=yes` és `status=available` → Confirm QR redemption egy tárolt stabil kérésazonosítóval.

Csak a `status=redeemed` és a `receipt_id` jogosítja fel az alkalmazásod admission nyugtáját. Tárold a passz/nyugta hivatkozást az Admissionon; ne tedd hozzáférhetővé a QR tartalmát az elemzések számára.

A `outcome_unknown` esetén állítsd helyre ugyanazt a kérést azonos felhasználóval/környezettel/passzal; soha ne generálj új megerősítő azonosítót. Kezeld a expired, revoked és a már felhasznált állapotokat különálló eredményekként.

Tervezett. A beolvasás és ellenőrzés nem használja a passzt; csak a kifejezett megerősítés használja.

Használd fel egyszer a rövid élettartamú előnyt egy partner pultnál

A partnernek egy megerősített felhasznált/nem felhasznált eredményre van szüksége a QR kép vagy képernyőanimáció helyett.

`label=coupon`; az alkalmazás Benefit rekordja meghatározza a jogosultságot és egy rövid érvényességi időablakot egy jogosult kiadási művelet előtt.

Adj ki egy passzt csak az alkalmazásod jogosultság-ellenőrzése után. A pultnál a Check QR pass mutatja a rendelkezésre állást anélkül, hogy felhasználná. Miután a személyzet megerősíti az előny átadását, futtasd a Confirm QR redemption-t.

A Benefit rekordod tárolhatja a `receipt_id`-t és a megerősített beváltási időt a `status=redeemed` után. A plugin kezeli a passz állapotát; az alkalmazásod kezeli az előnyt és az ügyfélkapcsolatot.

Ha egy előnyt a használat előtt visszavonnak, ugyanaz a jogosult kibocsátó képes Revoke QR pass-t végrehajtani a saját `pass_id`-jével. Ne hirdess visszatérítést vagy sikeres beváltást csak a `ok=yes` alapján.

Tervezett. A beolvasás és ellenőrzés nem használja a passzt; csak a kifejezett megerősítés használja.

Erősítsd meg a napazonos berendezés vagy rendelés átvételét

A személyzet munkafolyamatának meg kell különböztetnie az átvételi hivatkozás beolvasását a tényleges tárgy átadásától.

Az alkalmazásod által birtokolt Collection rekord megőrzi a jogosultságot, a célzott elemet és a különálló stabil kiadás/beváltás kérésazonosítókat; használj egy rövid élettartamú `label=access` passzt.

Miután az alkalmazásod engedélyezi az átvételt, Issue QR pass. A személyzet beolvas és ellenőriz, megvizsgálja a megfelelő Collection-t az alkalmazásodban, majd kifejezetten megerősíti az átadást és a Confirm QR redemption-t.

Csak egy megerősített `redeemed` nyugta után állítsa be a munkafolyamat a Collection-t átadottnak. Tartsd meg a `receipt_id`-t a passz eredményének hivatkozásaként.

Egy ismételt beolvasás visszaadhatja a already_used-t; jelenítsd meg a meglévő alkalmazás rekordot ahelyett, hogy egy másik tárgyat adnál át. Hozd vissza a bizonytalan megerősítést ugyanazzal az azonosítóval és bemenetekkel.

Tervezett. A beolvasás és ellenőrzés nem használja a passzt; csak a kifejezett megerősítés használja.

Mi működik most

Privát béta. A jelenlegi szkenner kamera- és jogosultságvezérléssel rendelkezik. Az egyszeri belépők létrehozása, ellenőrzése és megerősítése tervezett, és még nem áll készen a használatra az alkalmazásában.

A munkafolyamat felépítése

Tervezett

Tervezett munkafolyamat. Jelenleg még nem érhető el az aktuális béta verzióban.

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.

  1. Tervezett: egy jogosult alkalmazott Issue QR pass-t használ belépéshez vagy Order-hez. Példa: label=event, ttl_seconds=900, environment=development. Tartson egy stabil request_id-t az adott kibocsátáshoz, és mentse a pass_id-t a rekordhoz.

  2. Mutassa a visszakapott QR-t a címzettnek. A személyzet beolvassa. A tervezett passz munkafolyamatban használja a workflow_mode=yes-t, és olvassa a scanned_pass_token-t a pass_scanned után. Ezek a passz-munkafolyamat beállítások nem érhetők el a jelenlegi szkennerben.

  3. Futtassa a Check QR pass-t a pass_token = QR Scanner's scanned_pass_token-vel. Ellenőrzés passz használata nélkül. status=available esetén jelenítse meg a megfelelő rendelés vagy bejegyzés részleteit, hogy a személyzet áttekintse őket.

  4. Csak egy külön Megerősítés gomb futtatja a Confirm QR redemption-t ugyanazzal a pass_token-szel, egy stabil request_id-szel és confirm=yes-szel. status=redeemed esetén mentse a receipt_id-t, és jelölje be a rendelést vagy bejegyzést befejezettként.

  5. already_used, expired, revoked vagy invalid azt jelenti, hogy ne engedélyezze a belépést, és ne adja át a rendelést. Egy beolvasás vagy egy sikeres ellenőrzés önmagában soha nem fejezi be a tranzakciót.

Munkafolyamat diagram — nem alkalmazás képernyőkép

Egyszeri beállítás

Hozzon létre vagy válasszon egy Bubble alkalmazásprojektet a BestPlugins → Dashboard → Plugins alatt. Válassza ki a Xodera QR Passes Native-t, másolja a kulcsát, majd nyissa meg a Bubble → Plugins → Xodera QR Passes Native-t, és illessze be a project_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.

A beolvasáshoz kameraengedély szükséges. Egyszeri belépőkártyák esetén határozza meg, ki hozhat létre kártyákat, és ki ellenőrizheti azokat az ajtónál vagy átvételi pontnál. A hétköznapi vásárlóknak nincs szükségük semmilyen személyzeti szerepkörre.

qr_issuer_permission_field

qr_pass_issuer · A felhasználó igen/nem mező neve, amely jelöli a jogosult alkalmazottakat a bérletek létrehozására vagy visszavonására. Példa/alapértelmezett: qr_pass_issuer. Ide a mező nevét írja, nem az igen vagy nem értéket. Csak egy jogosult adminisztrátor módosíthatja ezt a felhasználói jogosultságot.

qr_staff_permission_field

qr_staff · A felhasználó igen/nem mező neve, amely jelöli a személyzetet, akik ellenőrizhetik és megerősíthetik a használatot. Példa/alapértelmezett: qr_staff. A jegytulajdonosnak nincs szüksége erre a jogosultságra. Tartsa távol a nyilvános regisztrációs és profil űrlapoktól.

Egyszeri beállítás
  1. Hozzon létre vagy válasszon egy Bubble alkalmazásprojektet a BestPlugins → Dashboard → Plugins alatt.
  2. Válassza ki ezt a bővítményt, és másolja a projekt kulcsát.
  3. Nyissa meg a Bubble → Plugins → Xodera QR Passes Native-t; illessze be a kulcsot a project_api_key-be, majd mentse.
  4. Adja hozzá az elemet, válassza ki az alkalmazásadatait, és építse fel az alábbi munkafolyamatot.
  5. Jelenleg csak privát béta hozzáférés. A nyilvános telepítés és a fizetős aktiválás még nem elérhető.
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

Példa belépés vagy átvétel: mentse a kapcsolódó rendelést/eseményt, pass_id, expires_at és issue_request_id. A megerősített használat után adja hozzá a receipt_id, redeemed_at és a megerősítést végző alkalmazottat. Ne jelölje a rekordot befejezettként, ha a kód csak beolvasásra vagy ellenőrzésre került. A QR kód nem igazolja a személyazonosságot.

Hiba, megszakítás és helyreállítás

Ha outcome_unknown=yes, tartsa meg ugyanazt a passes, request_id és a bemeneteket az eredmény újbóli ellenőrzésekor. Ne hozzon létre új megerősítést. already_used, expired és revoked végleges üzleti eredmények. Ha a jogosultság megtagadva, kérjen egy jogosult rendszergazdát, hogy ellenőrizze az alkalmazott szerepkörét. Clear session visszaállítja a szkennert; nem tudja visszavonni a befejezett használatot.

Képességek és korlátok

A tervezett passzok egyszeri használatúak, élettartamuk 1–86400 másodperc; alapértelmezett 900. Passz típusok: access, event, coupon és membership. Az ellenőrzés nem foglal le passzt. Internetkapcsolat szükséges a passz használatához. Nincs fizetési feldolgozás, személyazonosság-ellenőrzés vagy újrahasználható hosszú távú tagsági kártya. Egy általános QR érték olvasása különálló a passz ellenőrzésétől.

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

disabled · yes/nois_active · yes/noui_text_json · textlanguage · text

Állapotok

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

Események

scanner_startedscanner_pausedscanner_cancelledpermission_deniedpass_scannedvalidation_startedvalidation_completedredemption_startedpass_redeemedredemption_rejectedredemption_pendingfixture_decodedqr_error

Műveletek és azok bemenetei

Clear session
Elem beállítások · 5

Tervezett munkafolyamat. Jelenleg még nem érhető el az aktuális béta verzióban.

disabledyes/no · Alapértelmezett: false
Példaértékno
Példa Bubble kifejezésGuideHost'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.
is_activeyes/no · Alapértelmezett: true
Példaértékyes
Példa Bubble kifejezésGuideHost'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.
ui_text_jsontext · Alapértelmezett: "{}"
Példaérték{}
Példa Bubble kifejezésApp 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ékuk
Példa Bubble kifejezésCurrent 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.
workflow_modeyes/no · Alapértelmezett: false
Példaértékyes
Példa Bubble kifejezésApp Settings' use_qr_business_actions
Tervezett: engedélyezni, hogy a beolvasott QR értéket a Check QR pass használja. A beolvasás önmagában nem erősíti meg a belépést vagy átvételt.
Műveletek és azok bemenetei · 5

Tervezett munkafolyamat. Jelenleg még nem érhető el az aktuális béta verzióban.

Clear session

Nincsenek műveletparaméterek

Issue QR pass
environmenttext · Alapértelmezett: "development"
Példaértékdevelopment
Példa Bubble kifejezésApp Settings' selected_environment
Használja az aktuális üzleti rekord értékét; ellenőrizze a lenti határok szerint.
request_idtext · Alapértelmezett: —
Példaértékpickup-123-issue-v1
Példa Bubble kifejezésCurrent Admission's stable_request_id
Használja az aktuális üzleti rekord értékét; ellenőrizze a lenti határok szerint.
labeltext · Alapértelmezett: "access"
Példaértékevent
Példa Bubble kifejezésSelected Admission's pass_label
Használja az aktuális üzleti rekord értékét; ellenőrizze a lenti határok szerint.
ttl_secondsnumber · Alapértelmezett: 900
Példaérték900
Példa Bubble kifejezésEvent Settings' pass_ttl_seconds
Használja az aktuális üzleti rekord értékét; ellenőrizze a lenti határok szerint.

Visszatérések

pass_id · textpass_token · textpass_label · textexpires_at · textqr_png_data_uri · textreused · yes/no
Check QR pass
environmenttext · Alapértelmezett: "development"
Példaértékdevelopment
Példa Bubble kifejezésApp Settings' selected_environment
Használja az aktuális üzleti rekord értékét; ellenőrizze a lenti határok szerint.
pass_tokentext · Alapértelmezett: —
Példaérték<opaque token returned by Issue / camera scan>
Példa Bubble kifejezésQR Pass Scanner's scanned_pass_token (capture before Check)
Használja az aktuális üzleti rekord értékét; ellenőrizze a lenti határok szerint.

Visszatérések

pass_label · textexpires_at · text
Confirm QR redemption
environmenttext · Alapértelmezett: "development"
Példaértékdevelopment
Példa Bubble kifejezésApp Settings' selected_environment
Használja az aktuális üzleti rekord értékét; ellenőrizze a lenti határok szerint.
pass_tokentext · Alapértelmezett: —
Példaérték<opaque token returned by Issue / camera scan>
Példa Bubble kifejezésQR Pass Scanner's scanned_pass_token (capture before Check)
Használja az aktuális üzleti rekord értékét; ellenőrizze a lenti határok szerint.
request_idtext · Alapértelmezett: —
Példaértékpickup-123-redeem-v1
Példa Bubble kifejezésCurrent Admission's stable_redemption_request_id
Használja az aktuális üzleti rekord értékét; ellenőrizze a lenti határok szerint.
confirmyes/no · Alapértelmezett: false
Példaértékyes — explicit confirmation only
Példa Bubble kifejezésConfirm Checkbox is checked
Használja az aktuális üzleti rekord értékét; ellenőrizze a lenti határok szerint.

Visszatérések

pass_id · textpass_label · textreceipt_id · textredeemed_at · textreused · yes/no
Revoke QR pass
environmenttext · Alapértelmezett: "development"
Példaértékdevelopment
Példa Bubble kifejezésApp Settings' selected_environment
Használja az aktuális üzleti rekord értékét; ellenőrizze a lenti határok szerint.
pass_idtext · Alapértelmezett: —
Példaérték<pass_id returned by Issue>
Példa Bubble kifejezésSelected Admission's pass_id
Használja az aktuális üzleti rekord értékét; ellenőrizze a lenti határok szerint.

Visszatérések

pass_id · textrevoked · yes/no
Állapotok és események

Tervezett munkafolyamat. Jelenleg még nem érhető el az aktuális béta verzióban.

Állapotok

scanner_status · text

Az akció jelenlegi eredménye. Használd a megfelelő befejezési eseményt a siker mentése előtt. idle,requesting_permission,permission_denied,scanning,paused,scanned,validating,available,redeeming,redeemed,unavailable,unknown,error,cancelled,decoding_fixture,fixture_decoded

server_status · text

Az akció jelenlegi eredménye. Használd a megfelelő befejezési eseményt a siker mentése előtt. empty,available,redeemed,already_used,expired,revoked

pass_id · text

Az elem vagy művelet azonosítója. Tartsa meg a megfelelő alkalmazásrekorddal. Használja ugyanazt a kérésazonosítót bizonytalan eredmény újrapróbálásakor.

pass_label · text

A kiválasztott elem jelenlegi értéke. Olvassa el a kapcsolódó esemény után. empty,access,event,coupon,membership

receipt_id · text

Az elem vagy művelet azonosítója. Tartsa meg a megfelelő alkalmazásrekorddal. Használja ugyanazt a kérésazonosítót bizonytalan eredmény újrapróbálásakor.

error_code · text

Hibainformáció az utolsó műveletről. Mutasson hasznos üzenetet és kínálja a megfelelő újrapróbálást.

is_busy · yes/no

A munka még folyamatban van. Várjon, mielőtt újabb műveletet indítana.

is_scanning · yes/no

A kiválasztott elem jelenlegi értéke. Olvassa el a kapcsolódó esemény után.

torch_enabled · yes/no

A kiválasztott elem jelenlegi értéke. Olvassa el a kapcsolódó esemény után.

scan_source · text

A kiválasztott elem jelenlegi értéke. Olvassa el a kapcsolódó esemény után. empty,camera,fixture

pending_redemption · yes/no

A kiválasztott elem jelenlegi értéke. Olvassa el a kapcsolódó esemény után.

scanned_pass_token · text

A kiválasztott elem jelenlegi értéke. Olvassa el a kapcsolódó esemény után.

Események

scanner_started

Amikor ez az esemény bekövetkezik, olvassa ki a kapcsolódó állapotokat ugyanabból az elemből.

scanner_paused

Amikor ez az esemény bekövetkezik, olvassa ki a kapcsolódó állapotokat ugyanabból az elemből.

scanner_cancelled

Amikor ez az esemény bekövetkezik, olvassa ki a kapcsolódó állapotokat ugyanabból az elemből.

permission_denied

Amikor ez az esemény bekövetkezik, olvassa ki a kapcsolódó állapotokat ugyanabból az elemből.

pass_scanned

Amikor ez az esemény bekövetkezik, olvassa ki a kapcsolódó állapotokat ugyanabból az elemből.

validation_started

Amikor ez az esemény bekövetkezik, olvassa ki a kapcsolódó állapotokat ugyanabból az elemből.

validation_completed

Amikor ez az esemény bekövetkezik, olvassa ki a kapcsolódó állapotokat ugyanabból az elemből.

redemption_started

Amikor ez az esemény bekövetkezik, olvassa ki a kapcsolódó állapotokat ugyanabból az elemből.

pass_redeemed

Amikor ez az esemény bekövetkezik, olvassa ki a kapcsolódó állapotokat ugyanabból az elemből.

redemption_rejected

Amikor ez az esemény bekövetkezik, olvassa ki a kapcsolódó állapotokat ugyanabból az elemből.

redemption_pending

Amikor ez az esemény bekövetkezik, olvassa ki a kapcsolódó állapotokat ugyanabból az elemből.

fixture_decoded

Amikor ez az esemény bekövetkezik, olvassa ki a kapcsolódó állapotokat ugyanabból az elemből.

qr_error

Amikor ez az esemény bekövetkezik, olvassa ki a kapcsolódó állapotokat ugyanabból az elemből.

Fejlesztők által feltett kérdések

Mit jelentenek a két jogosultsági beállítás?

A felhasználó igen/nem mező neve, amely jelöli azokat az alkalmazottakat, akik jogosultak passzokat létrehozni vagy visszavonni. Példa/alapértelmezett: qr_pass_issuer. Ide a mező nevét írja, nem az igen vagy nem értéket. Csak egy jogosult rendszergazda módosíthatja ezt a jogosultságot egy felhasználón. A felhasználó igen/nem mező neve, amely jelöli a személyzetet, akik jogosultak a használat ellenőrzésére és megerősítésére. Példa/alapértelmezett: qr_staff. A jegytulajdonosnak nincs szüksége erre a jogosultságra. Tartsa távol a nyilvános regisztrációs és profil űrlapoktól.

Ugyanaz az alkalmazott létrehozhatja és ellenőrizheti a belépőket?

Igen, ha egy jogosult adminisztrátor mindkét jogosultságot megadja az alkalmazottnak. Ehhez nem szükséges másik projektkulcs. Az ügyfelek általában egyik jogosultságra sem van szükségük. Ne engedje, hogy a felhasználók maguknak adjanak ilyen jogosultságokat.

Miért használja az Ellenőrzést a Szkennelés után?

A Szkennelés beolvassa a kódot. Az Ellenőrzés megkérdezi, hogy a belépő elérhető-e anélkül, hogy felhasználná. A személyzet először áttekintheti a rendelést. Csak a különálló Confirm QR redemption művelet használja fel a belépőt egyszer.

Hogyan működik az előfizetés?

Tervezett árazás: a plugin telepítése a Bubble-ben ingyenes. A BestPlugins hozzáférés külön előfizetés minden pluginra minden Bubble alkalmazásprojektben: 7 nap ingyenes, majd US$1.50 havonta. A Development és Live benne van. Nincs fix korlát a műveletek számában; a fájlméret- és funkciókorlátok továbbra is érvényesek. A fizetés még nem nyitott. Az aktiválási képernyő megjeleníti az első számlázási dátumot és a lemondási feltételeket.

Kapcsolódó útmutatók

Marketplace kiadás függőben

Fórum útmutató nincs közzétéve

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.