키카드 인코더 설정

빠른 설정

인코더 유형을 선택하고, 필요한 경우 연결 방식을 선택한 다음 인코더를 추가합니다. 약 15분 정도 걸립니다.

이 안내서는 키오스크 또는 프런트 데스크에서 사용할 인코더 우선 키카드 인코딩을 구성하는 방법을 설명합니다. Be-Tech Windows Agent 설정도 포함합니다. 직접 Base URL을 구성하지 않는 한 Be-Tech은 기본적으로 Windows Agent를 사용합니다. 키오스크 라우팅은 이제 Settings → Kiosk에서 관리합니다. PMS 연동 키카드는 이제 인코더를 추가하기 전에 PMS 공급업체에서 인코더 단말을 검색합니다. Be-Tech Windows Agent 설정은 Windows가 재시작되거나 수동으로 중지된 후 중지된 클라이언트 또는 서비스를 복구할 수 있습니다. 지원되는 공급업체의 경우 AVA는 Room Access Service에서 사용 가능한 필드, 연결 규칙, 라우팅 옵션을 불러옵니다. 따라서 라벨과 필수 필드는 공급업체나 배포 환경에 따라 달라질 수 있습니다.

빠른 참고

작업	기능	클릭 위치
방식 선택	키카드 인코딩 활성화	Room Access → Keycard Encoding
인코더 유형 선택	잠금 시스템 선택	Encoder Type
연결 방식 선택	직접 연결 또는 Windows Agent(Saflok/Be-Tech/GreatLocks)	Advanced options → Enable direct communication
인코더 구성	서버 또는 자격 증명 정보 추가	유형별 필드
인코더 추가	실제 인코더 ID로 물리 장치 등록	Physical Encoder Devices
PMS 인코더 불러오기	PMS에서 사용 가능한 단말 가져오기	Physical Encoder Devices → Load Encoders
PMS 카드 읽기 활성화	Entitlements에서 실제 PMS 키카드를 읽도록 허용	Enable physical keycard reading
키오스크 라우팅 선택	키오스크 전용 라우팅 규칙 제어	Settings → Kiosk → Device Routing
Windows Agent 다운로드	에이전트용 부트스트랩 패키지 다운로드	Windows Agent
에이전트 버전 확인	설치 버전과 최신 버전 상태 표시	Windows Agent
에이전트 업데이트	업데이트 안내 모달 열기	Update
에이전트 카드 관리	설치, 업데이트 또는 재설치 작업 제공	Windows Agent
고급 에이전트 작업	로그 보기, 비밀값 교체 또는 에이전트 삭제	Advanced options
에이전트 설정 동기화	저장된 인코더 할당을 호환되는 에이전트에 적용	Sync Encoder Setup
인코딩 기본값 설정	숙박당 카드 수 및 만료 시간	Encoding Options

찾는 위치

Settings → Room Access → Keycard Encoding

1단계: 키카드 방식 선택

Settings → Room Access로 이동합니다.
객실 접근 방식으로 Keycard Encoding을 선택합니다.
Save를 클릭합니다.

2단계: 인코더 유형 선택

Keycard Encoder Settings까지 스크롤합니다.
Saflok, Be-Tech, LockSDK, GreatLocks, Adem 또는 PMS Integration을 선택합니다.

✓ AVA는 선택한 인코더 유형만 활성화된 상태로 유지합니다.

3단계: 연결 방식 선택

Select Encoder Type에서 Advanced options를 엽니다.
Saflok, GreatLocks 또는 LockSDK의 경우 Windows Agent를 우회하려면 Enable direct communication을 켭니다.
Windows Agent를 사용하려면 이 옵션을 끈 상태로 둡니다(기본값).
이미 직접 Base URL을 구성한 경우가 아니라면 Be-Tech은 Windows Agent를 사용합니다.
PMS Integration은 직접 통신만 사용하므로 이 단계는 건너뜁니다.

4단계: 인코더 시스템 구성

인코더 자격 증명 제목

여러 인코더를 사용하는 경우 섹션 제목이 Encoder Credentials & Devices로 표시됩니다.

Saflok을 사용하는 경우

직접 통신
- PMSI Server URL, Username, Password를 입력합니다.
- PMSI 서버는 인터넷에서 접근할 수 있어야 합니다.
- Test Connection을 클릭합니다.
Windows Agent
- Username과 Password만 입력합니다.
- PMSI URL과 연결 테스트는 에이전트가 처리합니다.
- AVA는 Saflok PMSI 준비 상태를 계속 다시 확인하므로 느린 부팅과 재시작도 대개 자동으로 복구됩니다.
Physical Encoder Devices에서 인코더 장치를 추가합니다(Encoder ID 필요).
선택 사항: 각 인코더에 Location을 설정합니다.
여러 키오스크가 인코더를 공유하면 Settings → Kiosk → Device Routing에서 라우팅을 추가합니다.

Be-Tech을 사용하는 경우

직접 통신
- Be-Tech 서비스의 Base URL을 입력합니다.
- 서비스는 인터넷에서 접근할 수 있어야 합니다.
- Hotel Name, Chain No, Workstation, Reader No를 입력합니다.
- Be-Tech 설정에 필요한 경우 Category와 Card Type을 설정합니다.
- Base URL이 저장되어 있으면 AVA는 Be-Tech을 직접 모드로 유지합니다.
- 인코더가 응답하는지 확인하려면 Test Connection을 클릭합니다.
Windows Agent
- Be-Tech 워크스테이션에 연결된 Windows PC에 에이전트를 설치합니다.
- Hotel Name, Chain No, Workstation, Reader No를 입력합니다.
- 에이전트가 로컬 Be-Tech 어댑터를 처리하고 공급업체 트래픽을 프록시합니다.
- AVA는 5분마다 /check에서 에이전트를 확인합니다.
- Windows가 재시작되거나 수동으로 중지된 후 트레이에서 Be-Tech 클라이언트와 서비스를 자동으로 시작할 수 있습니다.
- 트레이는 복구 후 수동으로 에이전트를 재시작하지 않아도 Be-Tech 준비 상태를 새로 고칩니다.
- Base URL이 저장되어 있지 않으면 AVA는 Windows Agent 흐름으로 돌아갑니다.
Physical Encoder Devices에서 인코더 장치를 추가합니다.
여러 인코더를 사용하는 경우 선택 사항으로 Settings → Kiosk → Device Routing에서 라우팅을 추가합니다.

여러 Be-Tech 설치

에이전트는 일반적인 Be-Tech 설치를 자동으로 검색합니다. 여러 개의 보호된 설치로 인해 모호성이 발생하는 경우에만 배포 관리자에게 BETECH_CLIENT_PATH를 설정해 달라고 요청하세요. 재정의 값은 보호된 Windows Program Files 폴더 안을 가리켜야 합니다.

GreatLocks를 사용하는 경우

직접 통신
- Server Name(선택 사항), XHLSI Server IP Address, TCP Port를 입력합니다.
- 서버는 인터넷에서 접근할 수 있어야 합니다.
- GreatLocks는 서버당 인코더 하나를 지원합니다.
- Test Connection을 클릭합니다.
Windows Agent
- 서버 세부 정보는 에이전트가 처리하므로 IP/포트가 필요하지 않습니다.
- 각 GreatLocks 인코더에 연결된 PC에 Universal Encoder Agent 하나를 설치합니다.

인코더당 GreatLocks 에이전트 하나

각 GreatLocks 인코더에 대해 Physical Encoder Devices에 행을 하나 추가합니다. 각 행에 정확히 하나의 Encoder ID를 입력합니다. front-desk 또는 lobby-pc와 같이 각 행에 고유한 ID를 사용합니다. 저장된 행을 편집할 때 AVA는 기존 ID를 유지합니다. ID가 없는 기존 행에는 AVA가 로드할 때 안정적인 ID를 부여합니다. 그런 다음 일치하는 Windows PC에 Universal Encoder Agent 하나를 설치합니다. 각 에이전트는 연결된 인코더만 제공합니다.

참고: AVA는 Room Access에 저장한 GreatLocks 서버 레코드를 사용합니다. 이전 설정을 업데이트한 경우 Test Connection 전에 Save를 클릭합니다. 인벤토리 동기화가 활성화되어 있으면 AVA는 활성 에이전트 터널을 통해 건물, 층, 객실 데이터를 읽습니다. 객실 목록을 최신 상태로 유지하려면 에이전트를 온라인 상태로 유지합니다. GreatLocks 설정이 리프트 접근을 지원하면 Enable lift access를 켭니다. 그런 다음 공급업체가 지원하는 모드를 선택합니다.

Room floor mapping은 객실 매핑의 건물 및 층 값을 사용합니다.
Access code groups는 공유 문 또는 리프트 그룹에 Common access codes를 사용합니다.

AVA는 카드당 하나의 리프트 옵션 유형만 전송합니다. 접근 코드 그룹을 사용할 때 AVA는 한 자리 숫자를 두 자리 코드로 저장합니다. 1,2,3 또는 01,02,03처럼 입력할 수 있습니다. 코드는 공급업체가 지원하는 범위 안에 두세요.

LockSDK를 사용하는 경우

직접 통신
- 각 LockSDK 인코더를 Physical Encoder Devices에 추가합니다.
- 각 인코더에 Encoder ID와 Service URL을 입력합니다.
- 인코더 항목을 추가한 후 Test Connection을 클릭합니다.
Windows Agent
- 각 LockSDK 인코더를 Physical Encoder Devices에 추가합니다.
- LockSDK 인코더마다 Windows Agent 하나를 등록합니다.
- 에이전트 카드에 일치하는 인코더와 실시간 상태가 표시됩니다.
선택 사항: 여러 인코더를 사용하는 경우 Settings → Kiosk → Device Routing에서 라우팅을 추가합니다.
결합 객실의 경우 LockSDK는 최대 4개 객실을 지원하며 RF50/Mifare lock type 5가 필요합니다.

Adem을 사용하는 경우

Adem 인코더 설정

Adem은 32비트 SDK를 로드하기 위해 Windows Universal Encoder Agent를 사용합니다. 에이전트 패키지는 Adem 잠금 시스템 서버, 리더 드라이버 또는 인코더를 설치하지 않습니다. AVA는 Room Access Service에서 Adem 필드, 인코더 입력 규칙, 연결 모드, 에이전트 등록 옵션을 받습니다. 이 예시와 다른 경우 화면에 표시된 필드를 따릅니다.

Encoder Type에서 Adem을 선택합니다.
배포 환경에 표시된 연결 방식을 선택합니다. 인코더 PC에서는 Windows Agent 모드가 일반적인 선택입니다.
1에서 6 사이의 Lock Software를 입력합니다.
8 또는 9인 Version을 입력합니다.
Adem Server 이름과 Log User를 입력합니다.
연결을 테스트하기 전에 Save를 클릭합니다.

✓ AVA는 저장하기 전에 필요한 Adem 설정을 검증합니다.
Physical Encoder Devices를 열고 Add Encoder를 클릭합니다.
고유한 Encoder ID와 선택 사항인 Name 및 Location을 입력합니다.
인코더 Port를 입력합니다.

Port	의미
`0`	기본 USB 리더
`1`	`COM1`
`2`	`COM2`
`3`	`COM3`

직렬 리더에는 실제 Windows COM 번호를 사용합니다.
직접 모드에서는 각 인코더에 대해 AVA가 표시한 서비스 URL을 입력합니다. 이 필드는 선택한 연결 모드에서 요구하는 경우에만 필요합니다.
Save를 클릭한 다음 Test Connection을 클릭합니다.

✓ AVA는 저장된 구성을 테스트하기 전에 현재 Adem 설정을 저장합니다. ✓ 공급업체, SDK 설정, 인코더 항목 또는 라우팅을 변경하면 이전 테스트 결과가 무효화됩니다.

공유 Adem 에이전트 규칙

Windows Agent 하나가 여러 직렬 인코더를 제공할 수 있습니다. 각 인코더는 0보다 큰 서로 다른 COM 포트를 사용해야 합니다. 하나의 에이전트에서 여러 기본 USB 리더를 사용하는 것은 지원되지 않습니다. 정적 연결의 경우 하나의 에이전트 URL을 공유하는 항목에도 같은 규칙이 적용됩니다. 별도의 인코더 PC에서는 번호가 각 PC에 로컬이므로 같은 COM 번호를 재사용할 수 있습니다.

생성된 Windows Agent 패키지를 인코더 PC에 다운로드하고 설치합니다.
Windows Agent 섹션에서 에이전트를 등록합니다.
AVA가 표시하는 라우팅 선택 항목을 사용하여 사용 가능한 Adem 인코더와 키오스크를 할당합니다. Room Access Service에서 공유 등록을 활성화하면 하나의 공유 에이전트가 여러 Adem 인코더를 제공할 수 있습니다.
AVA가 안내하는 경우 Settings → Kiosk → Device Routing에서 키오스크를 등록합니다.
PMS 객실 이름이 Adem 객실 번호와 다른 경우 Keycard Room Mapping에서 매핑합니다.

인코딩 전 Adem 리더 확인

Windows 인코더 PC에서 근거를 확인해야 할 때는 함께 제공되는 진단 도우미를 사용합니다. 이 도우미는 카드를 인코딩하거나 삭제하지 않습니다.

인코더 PC에서 32-bit Windows PowerShell을 엽니다.

C:\Windows\SysWOW64\WindowsPowerShell\v1.0\powershell.exe -NoProfile

AVA에서 할당하기 전에 로컬 COM 포트를 확인합니다.
```
.\scripts\test-adem-encoder.ps1 -Json
```
직원이 사용하지 않는 리더를 한 번에 하나씩 연결할 때만 -Watch를 사용합니다. 드라이버 이름은 Windows 장치를 식별할 뿐, 확인된 Adem 리더를 의미하지는 않습니다.
확인된 COM 번호를 각 AVA Port 필드에 저장합니다. COM 번호는 논리적 Encoder ID가 아니라 해당 Windows PC에 속합니다.
선택적으로 카드 없이 선택한 포트를 읽어 봅니다. 호텔에서 실제로 사용하는 Adem 소프트웨어, 버전, SQL 서버 값을 사용합니다.
```
.\scripts\test-adem-encoder.ps1 -Read -Port 3,4 `
  -AppRoot 'C:\Vouch\Universal Encoder Agent' `
  -LockSoftware 2 -Version 9 -Server 'LOCK-PC' -EncoderIdle -Json
```
도우미는 선택한 포트를 순서대로 읽으며 명시적인 -EncoderIdle 확인이 필요합니다. 이 프로브 중에는 카드를 인코딩하거나 공급업체 리더를 사용하지 마세요.
SessionSucceeded, 각 포트의 Code 및 Status, CleanupError를 검토합니다. 일시 중지했다면 UEA를 복원한 다음 직원이 PC를 사용하기 전에 해당 터널을 확인합니다.

결과	의미
`0x00000000` / `card_read`	선택한 리더가 카드를 읽었습니다. 객실 및 카드 상태가 반환됩니다.
`0x8010000C` / `no_card`	SDK가 카드 없음을 보고합니다. 이는 리더가 응답한다는 것을 확인할 뿐, 카드 읽기 결과를 확인하는 것은 아닙니다.
`port_open_error`	포트가 사용 중이거나 없거나 사용할 수 없을 수 있습니다. 불량 인코더라는 뜻은 아닙니다.
`communication_error`	리더 통신에 실패했습니다. 리더와 드라이버를 확인합니다.
SQL, 세션 또는 알 수 없는 오류	실제 연결 상태를 판단하기 전에 보고된 사전 조건을 해결합니다.

읽기 전용 진단의 제한

이 프로브는 세션 시작, 카드 읽기, 세션 종료 SDK 함수만 호출합니다. 재시도하지 않고, 다른 포트를 검색하지 않으며, 쓰기 또는 삭제 작업을 노출하지 않습니다. UEA 또는 공급업체 앱이 실행 중이라는 사실만으로 현재 해당 리더를 점유하고 있다고 볼 수는 없습니다.

공유 에이전트 키오스크 선택

AVA는 Room Access Service가 Adem 설정에 대한 공유 에이전트 지원을 알리는 경우에만 여러 키오스크 선택 항목을 표시합니다. 키오스크가 하나만 표시되면 해당 키오스크를 등록하고 배포 팀에 RAS 기능 메타데이터를 확인해 달라고 요청하세요.

✓ 테스트 카드는 매핑된 객실 하나에 대해 인코딩되어야 합니다.

Adem 카드 동작

AVA는 카드당 객실 하나를 인코딩합니다. 첫 번째 카드는 NEW를 사용하며 이전 게스트 카드가 무효화될 수 있습니다. 추가 카드는 DUPLICATE를 사용하고 이전 카드를 활성 상태로 유지합니다.

PMS Integration을 사용하는 경우

활성 PMS 연동(Cloudbeds 또는 Opera)이 있는지 확인합니다.
인코더를 불러오기 전에 숙박 시설에 맞게 PMS vendor를 설정합니다.
Enable PMS Encoder Integration을 켭니다.
Physical Encoder Devices에서 다음 중 하나를 수행합니다.
- Load Encoders와 Add Selected를 클릭하거나
- Add Encoder를 클릭하고 Encoder ID와 PMS Encoder ID를 입력합니다.
이제 불러온 장치는 공급업체 인코더 ID를 직접 유지합니다.
다시 검색하면 PMS 카드 읽기에 필요한 워크스테이션, 인코더, 인터페이스 및 아웃바운드 코드 세부 정보가 저장됩니다.
Opera 읽기는 이러한 세부 정보가 정확히 하나의 Door Lock 경로를 식별하는 경우에만 작동합니다.
사용하지 않을 인코더는 Active를 사용하여 비활성화합니다.
PMS 읽기 API가 검증된 후에만 Enable physical keycard reading을 켭니다.
읽기 설정을 변경한 후 Save를 클릭합니다.
목록이 비어 있으면 먼저 PMS 공급업체 설정을 확인합니다.
그래도 인코더가 보이지 않으면 PMS 인코더 검색 결과 없음을 참고하세요.

PMS 카드 읽기는 인코딩과 별개입니다

실제 카드 읽기가 꺼져 있어도 PMS 인코딩은 계속할 수 있습니다. PMS 및 Room Access 기능에서 읽기를 허용할 때까지 Entitlements는 스캔 컨트롤을 숨깁니다. PMS 공급업체가 해당 숙박 시설에서 읽기 API가 작동한다고 확인할 때까지 읽기 기능을 꺼 두세요.

PMS 카드 읽기 지원

PMS 공급업체	실제 카드 읽기	수행할 작업
Opera Cloud (OHIP)	어댑터가 기능을 알리는 경우 지원됨	읽기를 활성화하기 전에 하드웨어 승인을 완료합니다
기타 PMS 공급업체	공급업체가 지원을 알리는 경우가 아니면 사용할 수 없음	객실 또는 확인 번호를 수동으로 조회합니다

PMS가 실제 카드 읽기를 알리지 않으면 AVA는 안전을 위해 읽기를 비활성화합니다. 기존 키카드 인코딩 워크플로는 계속 사용할 수 있습니다.

PMS 카드 읽기 활성화

PMS 카드 읽기는 PMS 전송을 직접 사용합니다. Universal Encoder Agent 세션이 필요하지 않습니다. AVA는 가맹점 설정과 PMS 기능이 모두 허용할 때만 스캔을 활성화합니다.

Encoder Type에서 PMS Integration을 선택합니다.
Enable PMS Encoder Integration이 켜져 있는지 확인합니다.
검색된 인코더 중 하나 이상이 Active인지 확인합니다.
Enable physical keycard reading을 켭니다.
Save를 클릭합니다.
Entitlements를 열고 페이지를 새로 고칩니다.

✓ PMS가 실제 카드 읽기 지원을 보고하면 Start scanning이 표시됩니다. ✓ 스캔을 사용할 수 없어도 객실 및 확인 번호 수동 조회는 계속 사용할 수 있습니다.

PMS 키오스크 매핑

PMS Integration의 경우 AVA는 먼저 키오스크의 Device Model 매핑을 활성 PMS 인코더 장치와 대조하여 확인합니다. 해당 매핑을 사용할 수 없거나 일치하지 않으면 AVA는 기존 키오스크 매핑을 사용합니다. 대상 인코더를 Active로 유지하고 Device Routing에서 현재 PMS 인코더 이름을 사용합니다.

Opera 경로 일치는 정확해야 합니다

Opera 카드 읽기에는 일치하는 워크스테이션, 인코더 ID, 인터페이스 및 Door Lock 아웃바운드 코드가 하나 필요합니다. Opera가 중복되거나 불완전한 경로를 반환하면 AVA는 추측하지 않고 읽기를 비활성화합니다. Opera 관리자에게 인코더 카탈로그 수정을 요청한 후 Load Encoders를 다시 클릭합니다.

Saflok 인터페이스 값

Opera에는 SL01과 같은 인코더 인터페이스 값이 표시될 수 있습니다. AVA는 해당 값을 사용하여 일치하는 Door Lock 경로를 선택합니다. 읽기 요청에서는 대신 검색된 숫자 아웃바운드 코드를 사용합니다. 값을 수동으로 변경할 필요는 없습니다.

라우팅 위치 변경

AVA는 이제 Settings → Kiosk → Device Routing에서 키오스크 라우팅을 관리합니다. Room Access 페이지에는 인코더 설정이 유지되며 라우팅을 위해 이 위치로 안내합니다.

5단계: 키오스크 라우팅 설정(선택 사항)

키오스크별 라우팅 동작에만 이 섹션을 사용합니다.

Settings → Kiosk로 이동합니다.
Device Routing을 엽니다.
게스트가 키오스크에서 인코더를 선택하도록 하려면 Enable guest selection을 켭니다.
각 키오스크의 라우팅 규칙을 추가하려면 이 옵션을 끈 상태로 둡니다.
AVA는 해당 키오스크 규칙을 Mini MDM Device ID에 연결하여 저장합니다.
저장하면 이전 장치 ID 매핑이 자동으로 업데이트됩니다.

✓ 게스트 선택이 켜져 있으면 AVA는 수동 라우팅 규칙을 숨깁니다. ⚠️ 그래도 Physical Encoder Devices에 인코더 장치를 하나 이상 추가해야 합니다. ✓ AVA는 키오스크 매핑 없이 encoderId를 사용하여 인코딩 요청을 보낼 수 있습니다.

운영 중 인코더 선택 동작

온라인 인코더가 정확히 하나이면 AVA가 자동으로 선택합니다.
온라인 인코더가 여러 개이면 일반적으로 직원이 하나를 명시적으로 선택합니다.
여러 물리적 인코더가 하나의 Windows Agent를 공유하면 각 선택 항목에 인코더 이름이 표시됩니다. 여러 공유 에이전트 그룹을 구분해야 하는 경우 AVA는 더 작은 글씨로 에이전트 이름도 표시합니다.
이름이 지정되지 않은 공유 인코더는 계속 식별할 수 있도록 인코더 ID를 사용합니다.
2개 장치를 사용하는 ACI에서는 선택한 Guest Tablet에 저장된 활성 기본값을 AVA가 미리 선택할 수 있습니다.
해당 기본값이 없거나 비활성 상태이면 직원이 활성 인코더를 수동으로 선택할 수 있습니다.
GreatLocks의 경우 동적 상태 또는 구성 작업에 일치하는 행을 사용합니다.
여러 GreatLocks 서버 또는 에이전트를 사용할 수 있을 때 AVA는 대상을 추론할 수 없습니다.

실시간 온라인 상태

Online은 AVA가 인코더와 해당 에이전트 터널을 확인했다는 의미입니다. Unknown은 AVA가 인코더 상태를 확인하지 못했다는 의미입니다. Unknown이라고 해서 인코더가 오프라인이라는 뜻은 아닙니다. 연결이 활성화된 후에만 Status: 줄에 online이 표시됩니다. 인코더가 오프라인이 되면 먼저 에이전트 또는 터널을 해결합니다.

6단계: Windows Agent 설정(Windows Agent만 해당)

Direct communication을 활성화하지 않았다면 Windows Agent를 설치합니다.

Windows Agent로 이동합니다.
새 카드에서는 Download Windows Agent를 클릭하고, 기존 카드에서는 Reinstall을 클릭합니다.
인코더에 연결된 Windows PC에 에이전트를 설치합니다.
카드에 Not connected 또는 Never online이 표시되면 다운로드한 zip의 압축을 풀고 download-installer.bat을 실행합니다.
다운로드가 완료되면 저장된 설치 프로그램 .exe를 실행합니다.

✓ 에이전트가 상태 세부 정보와 함께 Registered Agents 아래에 표시됩니다. ✓ AVA는 인코더 사용 가능 여부를 결정할 때 이 실시간 상태를 사용합니다. ✓ 각 카드에는 Installed version과 가능한 경우 Latest version이 표시됩니다. ✓ 에이전트가 최신이면 Latest version installed가 표시됩니다. ✓ 에이전트가 오래된 경우 Reinstall 전에 Update를 클릭합니다.

Be-Tech, Saflok, GreatLocks 및 LockSDK는 모두 Windows Agent를 사용할 수 있습니다. GreatLocks의 경우 구성된 각 인코더와 연결된 PC에 대해 에이전트 설정을 반복합니다. 각 에이전트가 일치하는 Encoder ID를 사용하는지 확인합니다. 에이전트가 오래되면 기본 카드에 Reinstall보다 먼저 Update가 표시됩니다. View Logs, Rotate Secret 또는 Delete를 사용하려면 Advanced options를 엽니다. 이제 Rotate Secret을 선택하면 AVA가 현재 에이전트의 연결을 끊기 전에 확인 대화 상자가 열립니다.

서비스 제어

Be-Tech 복구는 일반적으로 중지된 클라이언트 또는 서비스를 자동으로 시작합니다. 서비스를 수동으로 제어해야 할 때는 Windows Agent 트레이에서 Start, Stop 또는 Restart를 사용합니다. Windows에서 권한을 요청하면 UAC 프롬프트를 승인하여 계속합니다. 프롬프트를 취소한 경우 작업을 반복하고 승인합니다.

버전이 오래된 경우 표시되는 내용

표시 내용: 카드에 Outdated가 표시되거나, 설치된 버전이 하트비트로 보고되지 않았다는 메시지가 표시됩니다.

해결 방법:

Update를 클릭합니다.
업데이트 모달을 읽습니다.
Windows Agent 앱을 엽니다.
Check for Update를 클릭합니다.
제공된 업데이트를 설치합니다.
Settings → Room Access를 새로 고치고 버전 상태가 최신인지 확인합니다.

LockSDK 에이전트 카드에도 동일한 버전 상태가 표시됩니다.

에이전트의 인코더 또는 키오스크 변경 적용

원격 설정 동기화를 지원한다고 알리는 기본 Windows UEA 버전의 경우:

AVA에서 에이전트의 인코더 및 키오스크 할당을 저장합니다.
Adem 할당을 변경하면 저장 후 자동으로 동기화를 시도합니다. 지원되는 다른 공급업체는 계속 수동 작업만 지원합니다.
수동으로 다시 시도하려면 에이전트 카드에서 Sync Encoder Setup을 사용합니다.
Advanced options → Registered Agents에서도 사용할 수 있습니다.
동기화한 후 AVA에서 에이전트 상태를 새로 고칩니다.

✓ 에이전트가 저장된 할당을 보고하면 Pending encoder setup sync가 지워집니다. ✓ AVA는 가능한 경우 최근 설정 동기화 시간을 표시합니다.

자동 동기화를 확인할 수 없어도 저장은 성공합니다. 연결을 확인한 다음 수동으로 다시 시도합니다. 오프라인 저장은 나중에 적용되도록 자동으로 대기열에 들어가지 않습니다.

일반적인 상태 새로 고침은 할당 변경을 적용하지 않습니다. 동기화는 USB 장치를 검색하거나 로컬 공급업체 설정을 변경하지 않습니다. 또한 UEA를 재시작하거나 진행 중인 카드 작업을 중단하지 않습니다.

자동 동기화가 실행되는 경우

자동 동기화는 Adem 인코더 또는 키오스크 할당 집합이 변경될 때만 실행됩니다. 이름 변경, 순서 변경, 객실 매핑, 상태 새로 고침 및 기타 공급업체 변경은 동기화를 트리거하지 않습니다.

수동 작업을 수행하려면 온라인 에이전트 또는 터널이 필요합니다. 사용할 수 없으면 UEA를 업데이트하거나 새 패키지로 Reinstall을 사용합니다. 재시작만으로는 새 할당을 가져오지 않습니다. 레거시 Node 에이전트는 여전히 로컬 .env 설정을 사용합니다.

7단계: 인코딩 기본값 설정

Number of Cards to Encode를 설정합니다(일반적으로 1~2장).
Keycard Expiration Time을 설정합니다(기본값: 오전 11:00). 이 시간은 수동 키카드 인코딩 중 Valid Until을 미리 채웁니다.

당일 이용 예약

예약이 명시적으로 day use이고 당일 이용이 활성화되어 있으면 AVA는 확인된 체크아웃 시간을 대신 사용합니다. 숙박 예약에는 계속 Keycard Expiration Time이 사용됩니다.

선택 사항: Advanced options를 펼쳐 Heartbeat Monitor를 활성화합니다.

선택 사항: PMS 객실을 인코더 이름에 매핑

인코더에서 PMS와 다른 객실 이름을 사용하는 경우:

Keycard Room Mapping을 사용합니다.

문제 해결

인코더가 응답하지 않거나 카드 인코딩에 실패하면 전체 체크리스트를 사용합니다.

Keycard Encoder Troubleshooting

여전히 해결되지 않나요?

다음과 같은 경우 success@vouch-technologies.com으로 문의하세요.

❌ 인코더 설정은 저장되지만 장치가 계속 오프라인 상태임
❌ 어떤 객실에도 카드를 인코딩할 수 없음
❌ Registered Agents에서 에이전트가 온라인으로 표시되지 않음

함께 보내면 유용한 정보:

인코더 유형 및 모델
Keycard Encoder Settings의 스크린샷
문제가 시작된 시간

빠른 참고​

찾는 위치​

1단계: 키카드 방식 선택​

2단계: 인코더 유형 선택​

3단계: 연결 방식 선택​

4단계: 인코더 시스템 구성​

Adem 인코더 설정​

인코딩 전 Adem 리더 확인​

PMS 카드 읽기 지원​

PMS 카드 읽기 활성화​

5단계: 키오스크 라우팅 설정(선택 사항)​

운영 중 인코더 선택 동작​

6단계: Windows Agent 설정(Windows Agent만 해당)​

버전이 오래된 경우 표시되는 내용​

에이전트의 인코더 또는 키오스크 변경 적용​

7단계: 인코딩 기본값 설정​

선택 사항: PMS 객실을 인코더 이름에 매핑​

문제 해결​

여전히 해결되지 않나요?​

관련 안내서​