ដោះស្រាយបញ្ហា Keycard Encoder
ពិនិត្យ network និងភ្លើងជាមុន បន្ទាប់មកសាកអ៊ិនកូដ card មួយសន្លឹក។ វាចំណាយប្រហែល 2 នាទី។
មគ្គុទ្ទេសក៍នេះជួយអ្នកដោះស្រាយបញ្ហា keycard encoder ទូទៅ និងស្ថានភាពដែលជួបញឹកញាប់នៅតុមុខសណ្ឋាគារ។
យោងរហ័ស
| អ្វីដែលអ្នកឃើញ | មូលហេតុ | ធ្វើដូចនេះ |
|---|---|---|
| Encoder មិនឆ្លើយតប | បញ្ហាភ្លើង ឬបណ្តាញ | ពិនិត្យការតភ្ជាប់ |
| Cards មិនអ៊ិនកូដ | បញ្ហាប្រភេទ card ឬឧបករណ៍ | ផ្ទៀងផ្ទាត់ card និង device |
| "UserCredentialsNotProvided.NotApplicable" | Saflok credentials បាត់ ឬមិនពេញលេញ | បន្ថែម Saflok credentials |
| Saflok/Ambiance encoding បរាជ័យ ឬអស់ពេល | Windows Agent, Ambiance encoder service, ឬ device offline | Restart Saflok/Ambiance encoder |
| "Please create a new keycard first, then use Duplicate for any extra cards." | Saflok រកមិនឃើញ registration សកម្មដែលមានស្រាប់សម្រាប់ reservation | ជួសជុលការខ្វះ keycard ដំបូង |
| ការផ្លាស់ប្ដូរ encoder type មិននៅជាប់ | ការរក្សាទុកមុនបានបន្សល់ស្ថានភាព encoder ច្របូកច្របល់ | រក្សាទុក encoder type ឡើងវិញ |
| "Test Connection" បរាជ័យ (Be-Tech) | បញ្ហា Base URL ឬ service | ជួសជុលការភ្ជាប់ Be-Tech |
| "Test Connection" បរាជ័យ (GreatLocks) | ព័ត៌មាន GreatLocks server ដែលបានរក្សាទុក បាត់ ឬចាស់ | ជួសជុលការភ្ជាប់ GreatLocks |
| "Service URL is required" (LockSDK) | Direct mode ត្រូវការ Service URL មួយសម្រាប់ encoder នីមួយៗ | បន្ថែម LockSDK service URL |
| LockSDK agent បង្ហាញ Not registered | មិនទាន់មាន agent device សម្រាប់ encoder នីមួយៗ | ចុះបញ្ជី LockSDK agent |
| Heartbeat Monitor បិទបន្ទាប់ពីរក្សាទុក | ការរក្សាទុកមិនបានស្ថិតក្នុងសម័យសណ្ឋាគារបច្ចុប្បន្ន | រក្សាទុក Heartbeat Monitor ឡើងវិញ |
| Heartbeat បង្ហាញ unreachable | agent offline ឬបញ្ហា tunnel | ពិនិត្យស្ថានភាព agent |
| Encoder នៅតែមិនអាចប្រើបាន | បញ្ជី dynamic នៅតែមើលឃើញថា agent ផ្តាច់ | ពិនិត្យស្ថានភាព encoder ជាក់ស្តែង |
| Windows Agent បង្ហាញ Not connected | agent មិនដំណើរការ ឬដំឡើងមិនពេញលេញ | ភ្ជាប់ agent ឡើងវិញ |
Encoder មិនឆ្លើយតប
អ្វីដែលអ្នកឃើញ: Encoder បង្ហាញ offline ឬមិនឆ្លើយតបក្នុង AVA។
វិធីដោះស្រាយ:
- ពិនិត្យភ្លើង និងខ្សែភ្ជាប់របស់ encoder។
- ផ្ទៀងផ្ទាត់ការតភ្ជាប់បណ្តាញរវាង kiosk និង encoder (Direct Connection តែប៉ុណ្ណោះ)។
- បញ្ជាក់ថា server IP និង port ត្រឹមត្រូវ។
- Restart software encoder។
Cards មិនអ៊ិនកូដ
អ្វីដែលអ្នកឃើញ: ការសរសេរ keycard បរាជ័យ ឬបង្កើត card ទទេ។
វិធីដោះស្រាយ:
- បញ្ជាក់ថាប្រភេទ card ត្រូវគ្នានឹង encoder របស់អ្នក។
- ដាក់ card ចូលវិញ ហើយសាកម្តងទៀត។
- សាកជាមួយ blank card ថ្មីមួយ។
- បើ Enable guest selection បិទ សូមបញ្ជាក់ថា kiosk ត្រូវបានបញ្ជូនទៅ encoder ត្រឹមត្រូវ។
- បើ Enable guest selection បើក សូមបញ្ជាក់ថាភ្ញៀវជ្រើស encoder online នៅ kiosk។
Saflok/Ambiance encoding មិនដំណើរការ
អ្វីដែលអ្នកឃើញ: ការអ៊ិនកូដ keycard បរាជ័យ អស់ពេល ឬ kiosk រាយការណ៍ថាមិនមាន response ពី Saflok/Ambiance encoder។
វិធីដោះស្រាយ: ធ្វើត្រួតពិនិត្យ 3 ជំហាននេះតាមលំដាប់។ រាល់ជំហាននឹងដកចេញមូលហេតុទូទៅមួយ មុនអ្នកទៅជំហានបន្ទាប់។
1. ពិនិត្យថា Windows Agent បានភ្ជាប់ក្នុង AVA
-
ទៅកាន់ Settings → Room Access → Keycard Encoding។
-
ស្វែងរក card Windows Agent សម្រាប់ encoder នេះ។
-
បញ្ជាក់ថាស្ថានភាពបង្ហាញ Connected និងពេល Last Seen ថ្មីៗ។

-
បើ agent ជា Not connected សូមអនុវត្ត Windows Agent not connected មុនបន្ត។
2. ពិនិត្យថា encoder online ក្នុង Ambiance
បើ agent បានភ្ជាប់ហើយ ប៉ុន្តែការអ៊ិនកូដនៅតែបរាជ័យ សូមចូលទៅ server Ambiance ហើយពិនិត្យ device encoder។
-
បើក Ambiance ហើយទៅកាន់ Device Management → Encoders។
-
ស្វែងរក encoder សម្រាប់ kiosk នេះ (ឧទាហរណ៍ encoder Vouch)។
-
បញ្ជាក់ថា Status បង្ហាញ Online។

-
បើ encoder បង្ហាញ Offline សូមបន្តទៅជំហាន 3 ដើម្បី restart service encoder។
3. Restart Ambiance Encoder Service
បើ encoder offline ក្នុង Ambiance សូម restart service encoder នៅកុំព្យូទ័រដែលដំឡើង Ambiance server។
-
លើកុំព្យូទ័រដែលរត់ Ambiance server ចុច Windows key ឬចុច Start menu។
-
វាយ
services managerហើយបើក Ambiance Services Manager ពីលទ្ធផល។ -
ក្នុងបញ្ជី services ជ្រើស Ambiance Encoder Service។

-
ចុចប៊ូតុង Stop (square ពណ៌ក្រហម)។
-
រង់ចាំពីរបីវិនាទីឱ្យស្ថានភាពប្តូរទៅ Stopped។
-
ចុចប៊ូតុង Start (play ពណ៌ក្រហម)។
-
បញ្ជាក់ថា State ត្រឡប់ទៅ Running។
-
ត្រឡប់ទៅ Ambiance Device Management → Encoders ហើយបញ្ជាក់ថា encoder ជា Online។
-
សាកអ៊ិនកូដ test card ពី kiosk។
encoder service អាចបាត់ការតភ្ជាប់ទៅ physical encoder បន្ទាប់ពី network blips ឬ idle periods យូរ។ ការបិទ និងបើក service វិញ បង្ខំឱ្យវាស្ថាបនាតំណឡើងវិញ។
Saflok duplicate keycard ត្រូវការទីមួយ keycard
អ្វីដែលអ្នកឃើញ: AVA បង្ហាញ "Please create a new keycard first, then use Duplicate for any extra cards."
មូលហេតុ: Saflok រកមិនឃើញ active registration ឬ keycard record សម្រាប់ reservation នោះទេ។ Duplicate cards ត្រូវការទីមួយ keycard ដែលបង្កើតបានជោគជ័យ មុន AVA អាចបន្ថែម card ផ្សេងទៀត។
វិធីដោះស្រាយ:
- បង្កើត keycard ដំបូងសម្រាប់ reservation នោះ។
- រង់ចាំឱ្យការអ៊ិនកូដដំបូងបញ្ចប់ដោយជោគជ័យ។
- ជ្រើស Duplicate តែបន្ទាប់ពី keycard ដំបូងមានរួច។
- បើកំហុសបង្ហាញឡើងវិញ សូមបញ្ជាក់ថា reservation នៅតែមាន active registration ក្នុង Ambiance។
- សាកសំណើ duplicate ម្តងទៀត។
អ្នកមិនគួរឃើញ ReservationNotFound ឬ SOAP fault details ដើមៗនៅក្នុងសារ។
Saflok credentials មិនបានផ្តល់
អ្វីដែលអ្នកឃើញ: "UserCredentialsNotProvided.NotApplicable" បង្ហាញពេលអ៊ិនកូដ keycard។
វិធីដោះស្រាយ:
- ទៅកាន់ Settings → Room Access → Keycard Encoding។
- កំណត់ Encoder Type ជា Saflok។
- បញ្ចូល Username និង Password ក្នុង Encoder Credentials។
- បើ direct communication បើក សូមបញ្ចូល PMSI Server URL។
- ចុច Save។
- ចុច Test Connection បន្ទាប់មកអ៊ិនកូដ test card មួយ។
ការផ្លាស់ប្ដូរ encoder type មិននៅជាប់
អ្វីដែលអ្នកឃើញ: អ្នកជ្រើស encoder type មួយ ប៉ុន្តែ encoder ផ្សេងនៅតែសកម្ម។
វិធីដោះស្រាយ:
- ទៅកាន់ Settings → Room Access → Keycard Encoding។
- ក្នុង Keycard Encoder Settings ជ្រើស encoder type ដែលអ្នកចង់បាន។
- ចុច Save ម្តង ហើយរង់ចាំសារជោគជ័យ។
- Refresh ទំព័រ ហើយបញ្ជាក់ថាមាន encoder type តែមួយគត់ដែលសកម្ម។
- បើបញ្ហាកើតឡើងវិញ សូមប្ដូរប្រភេទ រក្សាទុក បន្ទាប់មកប្ដូរត្រឡប់វិញ ហើយរក្សាទុកម្ដងទៀត។
Be-Tech test connection បរាជ័យ
អ្វីដែលអ្នកឃើញ: "Test Connection" បង្ហាញបរាជ័យ ឬប៊ូតុងនៅតែបិទ។
វិធីដោះស្រាយ:
- បញ្ជាក់ថា Base URL ចាប់ផ្តើមដោយ
http://ឬhttps://។ - ផ្ទៀងផ្ទាត់ថា Be-Tech service កំពុងរត់លើ encoder workstation។
- ពិនិត្យថា workstation និង kiosk នៅលើបណ្តាញដូចគ្នា។
- បញ្ចូល Hotel Name, Chain No, Workstation, និង Reader No ឡើងវិញ។
- ចុច Test Connection ម្តងទៀត។
GreatLocks test connection បរាជ័យ
អ្វីដែលអ្នកឃើញ: Test Connection បរាជ័យ បន្ទាប់ពីអ្នកកែ GreatLocks server details។
វិធីដោះស្រាយ:
- ទៅកាន់ Settings → Room Access → Keycard Encoding។
- បញ្ជាក់ថា GreatLocks server មាន XHLSI Server IP Address និង TCP Port។
- ចុច Save ម្តងទៀត។
- បើអ្នកអាប់ដេត setup ចាស់ សូមរក្សា server record ដែលមានស្រាប់។
- ចុច Test Connection ម្តងទៀត។
LockSDK service URL ត្រូវការ
អ្វីដែលអ្នកឃើញ: Save ត្រូវបានរារាំង ឬ form encoder បង្ហាញ "Service URL is required."
វិធីដោះស្រាយ:
- ទៅកាន់ Settings → Room Access → Keycard Encoding។
- ជ្រើស LockSDK។
- បើក Physical Encoder Devices ហើយកែ encoder នោះ។
- បញ្ចូល Service URL ត្រឹមត្រូវ ដូចជា
http://127.0.0.1:8092។ - ចុច Save, បន្ទាប់មករត់ Test Connection។
LockSDK agent មិនបានចុះបញ្ជី
អ្វីដែលអ្នកឃើញ: កាត LockSDK encoder បង្ហាញ Not registered ក្នុង Windows Agent។
វិធីដោះស្រាយ:
- បញ្ជាក់ថា LockSDK encoder មានក្នុង Physical Encoder Devices។
- ទៅកាន់ Windows Agent ហើយស្វែងរកកាត encoder នោះ។
- ចុច Download Windows Agent បើ card ថ្មី ឬ Reinstall បើមានរួចហើយ។
- ស្រាយ package ហើយរត់
.batfile លើ Windows PC ដែលភ្ជាប់។ - Refresh ស្ថានភាព ហើយបញ្ជាក់ថា card ប្ដូរពី Not registered ទៅ Connected ឬ Not connected។
- ប្រើ Advanced options តែសម្រាប់ View Logs, Rotate Secret, ឬ Delete ប៉ុណ្ណោះ។
Heartbeat Monitor បិទបន្ទាប់ពីរក្សាទុក
អ្វីដែលអ្នកឃើញ: អ្នកបើក Heartbeat Monitor, ចុច Save, ហើយវាបិទវិញ។
វិធីដោះស្រាយ:
- ទៅកាន់ Settings → Room Access → Keycard Encoding។
- បើក Encoding Options → Advanced options។
- បើក Heartbeat Monitor។
- ចុច Save ម្តង ហើយរង់ចាំសារជោគជ័យ។
- Refresh ទំព័រ ហើយបញ្ជាក់ថា Heartbeat Monitor នៅតែបើក។
- បើវានៅតែបិទ សូមអនុវត្ត Settings Not Saving After Switching Hotels។
បរាជ័យ Heartbeat
អ្វីដែលអ្នកឃើញ: Heartbeat Monitor បង្ហាញ unreachable។
វិធីដោះស្រាយ:
- បញ្ជាក់ថា agent កំពុងរត់លើ kiosk/PC។
- ពិនិត្យ Registered Agents សម្រាប់ស្ថានភាព online និងការចូលដល់ tunnel។
- ពិនិត្យ agent logs សម្រាប់កំហុស។
- ដំឡើង agent ឡើងវិញ បើចាំបាច់។
ស្ថានភាព live encoder មិនត្រូវគ្នា
អ្វីដែលអ្នកឃើញ: Encoder មើលទៅបានកំណត់រួចហើយ ប៉ុន្តែ AVA នៅតែសម្គាល់វាមិនអាចប្រើបានក្នុង modal ការកក់។
មូលហេតុ: AVA បង្ហាញ online តែពេល agent connected និង tunnel reachable ប៉ុណ្ណោះ។ ស្ថានភាពដូចគ្នានេះឥឡូវជាគន្លឹះសម្រាប់ការជ្រើស encoder dynamic។
វិធីដោះស្រាយ:
- ពិនិត្យ Registered Agents សម្រាប់ card encoder។
- បញ្ជាក់ថាឧបករណ៍ connected និង tunnel reachable។
- ជួសជុលបញ្ហា agent ឬ network ជាមុន។
- Refresh Settings → Room Access។
- សាកអ៊ិនកូដម្តងទៀត។
- ពិនិត្យឡើងវិញជួរ Status: លើទំព័រ settings។
Windows Agent មិនបានភ្ជាប់
អ្វីដែលអ្នកឃើញ: ស្ថានភាពបង្ហាញ Not connected ឬ "Never online."
វិធីដោះស្រាយ:
- បើក zip ដែលបានទាញយក ហើយរត់
download-installer.bat។ - អនុញ្ញាតឱ្យវាទាញយក installer
.exeបន្ទាប់មករត់ file នោះ។ - បញ្ជាក់ថា Windows PC មានអ៊ីនធឺណិត។
- ចុច Reinstall លើ card agent ក្នុង Windows Agent បើចាំបាច់។
- Refresh ស្ថានភាព Registered Agents។
- ត្រឡប់ទៅ Settings → Room Access ហើយបញ្ជាក់ថា Status: ប្ដូរទៅ online។
ពេល agent connected និង tunnel reachable បញ្ជី encoder dynamic គួរតែបង្ហាញ Online។ បើ card encoder កម្រិតខាងក្នុងនៅតែមើលទៅ offline សូម refresh ទំព័រ ហើយពិនិត្យ agent ជាមុន។
ច្បាប់ routing របស់ kiosk មិនបង្ហាញ
អ្វីដែលអ្នកឃើញ: អ្នកមិនអាចរក routing rules នៅក្រោម Kiosk to Encoder Routing។
វិធីដោះស្រាយ:
- ពិនិត្យថា Enable guest selection បានបើកឬអត់។
- បិទវា ដើម្បីបង្ហាញ manual routing rules។
- បន្ថែម device យ៉ាងហោចណាស់មួយក្នុង Physical Encoder Devices។
នៅតែជាប់?
ទាក់ទង success@vouch-technologies.com ប្រសិនបើ៖
- ❌ encoder នៅតែ offline បន្ទាប់ពីពិនិត្យភ្លើង និងបណ្តាញ
- ❌ ការអ៊ិនកូដ card បរាជ័យលើ kiosks ច្រើន
- ❌ Heartbeat នៅតែអាក្រក់លើស 30 នាទី
អ្វីដែលមានប្រយោជន៍ក្នុងការផ្ញើបន្ថែម:
- ប្រភេទ និងម៉ូឌែល encoder
- រូបថតអេក្រង់ Registered Agents និង Heartbeat Monitor
- ពេលវេលាដែលបញ្ហាចាប់ផ្តើម