본문으로 건너뛰기

Android 키오스크 설정

빠른 설정

먼저 디바이스 행을 만드세요. 그런 다음 해당 행에서 Enroll Device를 사용해 QR을 생성합니다. 대부분의 팀은 약 3분이면 완료합니다.

이 가이드는 Mini MDM 디바이스 행을 만들고 Android 키오스크와 브라우저 디바이스를 등록하는 방법을 안내합니다. iPhone 및 iPad 키오스크와 문서 카메라 기본값, 디바이스별 오버라이드도 다룹니다. 디바이스가 카메라 방향을 제공하면 AVA는 선택한 방향을 사용합니다. 로컬 전용 iOS 사용 사례에는 Guided Access를 사용하세요. 감독 대상 iOS 키오스크에는 전용 등록을 사용하세요. Device Routing을 사용해 객실 출입 인코더와 결제 단말을 관리하세요. 키오스크 모드는 Android 디바이스, 유연한 브라우저 디바이스, iOS 디바이스를 지원합니다. mini_mdm:read 권한이 있는 사용자는 키오스크 상태를 볼 수 있습니다. 디바이스 행 생성, 디바이스 등록, 키오스크 작업 실행에는 mini_mdm:manage 권한이 필요합니다. 브라우저 디바이스의 체크인 모드를 변경하려면 settings:write도 필요합니다. Mini MDM Device ID는 각 키오스크 기록의 안정적인 행 ID입니다. 이를 사용해 실제 키오스크를 특정 디바이스 행 하나와 연결하세요. AVA는 Mini MDM Device ID를 기준으로 키오스크 라우팅 행을 저장합니다. 이전 디바이스 ID 매핑이 남아 있어도 저장할 때 AVA가 그대로 유지합니다. 등록은 이제 Create Device에서 시작합니다. 그다음 잠금형 게스트 키오스크, 유연한 브라우저 디바이스, iOS 경로 중 하나를 선택합니다.

이동 경로: Settings → Kiosk

빠른 참고​

설정제어 내용직원 사용 용도
Kiosk access permissions보기 전용 또는 관리 액세스를 제어디바이스 작업을 실행할 사람 결정
Create Device미완료 논리적 키오스크 행 추가등록 전 슬롯 예약
Choose device setup잠금형, 브라우저 또는 iOS 선택기 열기올바른 디바이스 유형 선택
Enroll Device단일 키오스크 행용 일회성 QR 생성알려진 디바이스 슬롯 하나 등록
Create locked-down device관리형 게스트 체크인 태블릿 추가디바이스를 키오스크 모드로 고정
Create flexible browser device브라우저와 페어링할 직원 디바이스 추가일반 브라우저 액세스 유지
Check-in modeCCI 또는 ACI 선택 및 브라우저 링크 재생성의도한 체크인 흐름 열기
iOS Guided AccessAVA Check-in 로컬 설정 튜토리얼 표시MDM 없이 iPhone 또는 iPad 준비
Dedicated Device Enrollment감독 대상 iPhone 또는 iPad 행 추가Apple Business Manager로 iOS 관리
SetupiOS 행에서 ADE 또는 키오스크 설정 시작iPhone/iPad 프로비저닝 완료
Verify and continue잠금 모드 전에 설치된 앱 확인멈춘 앱 설치 복구
Setup statusADE, 앱 및 잠금 진행 상태 표시iOS 프로비저닝 추적
Mini MDM Device ID안정적인 키오스크 행 ID 표시특정 키오스크 슬롯 추적
Scope행 유형 표시Per-device 행 구분
Unlock Code현재 잠금 해제 코드 표시잠긴 디바이스 복구
Devices list모든 페이지의 등록 디바이스 상태 표시상태와 마지막 동기화 확인
Device routing키오스크를 객실 출입 인코더 및 결제 단말에 연결라우팅 최신 상태 유지
Call경고 프롬프트 후 키오스크로 영상 통화 시작도움이 필요할 때 키오스크에 연락
Auto-refreshing…QR 및 작업 후 디바이스 업데이트 조회등록 또는 작업 결과 확인
Device actions재시작, 잠금, 잠금 해제, 등록 해제원격 제어 및 복구
Document camera defaults휴대폰과 태블릿 스캔의 첫 카메라 설정키오스크 유형 간 스캔 일관성 유지
Connected devices유연한 브라우저 디바이스의 활성 브라우저 연결 수 표시중복 브라우저 페어링 확인

문서 카메라 기본값 설정​

Document scanner camera를 사용해 AVA가 문서 스캔을 열 때 처음 사용할 카메라를 설정합니다. Phone과 Tablet and larger에 대해 서로 다른 기본값을 선택하세요. 관리형 키오스크는 기본값을 상속하거나 디바이스별로 오버라이드할 수 있습니다.

  1. Settings → Kiosk로 이동합니다.

  2. Document scanner camera에서 Phone default를 선택합니다.

  3. Tablet and larger default를 선택합니다.

  4. Save camera defaults를 클릭합니다.

    ✓ AVA가 문서 스캔용 숙소 기본값을 저장합니다.

키오스크 오버라이드 작동 방식

관리형 키오스크에서 Use device-class default는 숙소 기본값을 유지합니다. 해당 키오스크에 오버라이드를 적용하려면 Back camera 또는 Front camera를 선택하세요. 선호 카메라를 사용할 수 없으면 AVA는 액세스할 수 있는 카메라를 사용합니다. 양쪽 카메라가 있는 휴대폰에서는 AVA가 스캔 시작 시 선택한 방향을 따릅니다.

Android 축소 사용자 에이전트

일부 Android 휴대폰은 Chrome에서 Mobile 토큰을 숨깁니다. AVA는 이런 디바이스에서 화면의 짧은 변을 확인합니다. CSS px 기준 768 미만인 휴대폰은 Phone default를 사용합니다. 더 큰 화면은 Tablet and larger default를 유지합니다.

변경 사항 적용 시점

키오스크는 구성을 새로 고치거나 스캐너를 다시 시작한 후 새 설정을 가져옵니다. 현재 스캔 세션은 계속 실행됩니다.

카메라 선택이 여전히 잘못될 때​

보이는 현상: 저장한 뒤에도 키오스크가 이전 카메라를 엽니다.

해결 방법:

  1. 키오스크 구성을 새로 고칩니다.

  2. 해당 디바이스에서 스캐너를 다시 시작합니다.

  3. 스캔을 다시 시도합니다.

    ✓ 키오스크가 새 기본값 또는 오버라이드를 사용해야 합니다.

키오스크 권한 액세스​

권한할 수 있는 일할 수 없는 일
mini_mdm:readSettings → Kiosk 열기, 디바이스 목록 및 상태 보기디바이스 생성, 등록, 잠금 해제 코드 표시/복사, 재시작, 잠금, 잠금 해제, 등록 해제, 제거, 라우팅 변경 저장
mini_mdm:manage전체 키오스크 관리 액세스N/A

mini_mdm:read만 있으면 페이지는 보기 전용 모드로 유지됩니다. 또한 관리 권한이 필요하다는 배너가 표시됩니다.

등록 흐름 선택​

목표사용할 작업표에 표시되는 범위
알려진 키오스크 슬롯 하나 등록Create Device 후 Locked-down check-in device 선택Per-device
공유 직원 브라우저 설정Create Device 후 Flexible browser device 선택Flexible
감독 대상 iPhone 또는 iPad 설정Create Device 후 iOS → Dedicated Device Enrollment 선택Per-device
iPhone 또는 iPad에서 Guided Access 사용How to enroll → iOS → Guided Access로컬 전용
사용하지 않는 사전 생성 슬롯 제거미완료 행에서 Remove 사용Per-device
등록 흐름

상단 카드는 이제 디바이스 생성만 시작합니다. 행이 생성되기 전에 선택기에서 디바이스 유형을 고릅니다. 잠금형 디바이스가 생성된 후 해당 행에서 QR을 생성합니다.

iOS 등록

Guided Access는 로컬 디바이스에 유지됩니다. 전용 등록은 Apple Business Manager와 Vouch MDM을 사용합니다.

단계별: 잠금형 디바이스 만들기​

  1. Settings → Kiosk로 이동합니다.
  2. 등록 카드에서 Create Device를 클릭합니다.
  3. Choose device setup에서 Locked-down check-in device를 클릭합니다.
  4. 선택 사항: Front Desk 1과 같은 레이블을 입력합니다.
  5. Create locked-down device를 클릭합니다.

✓ Status: Unfulfilled인 새 행이 표시됩니다. ✓ 행에 Mini MDM Device ID가 표시됩니다. ✓ 행에는 Enroll Device와 Remove만 표시됩니다.

단계별: 유연한 브라우저 디바이스 만들기​

  1. Settings → Kiosk로 이동합니다.
  2. 등록 카드에서 Create Device를 클릭합니다.
  3. Choose device setup에서 Flexible browser device를 클릭합니다.
  4. 선택 사항: Front Desk Browser와 같은 디바이스 별칭을 입력합니다.
  5. Create flexible browser device를 클릭합니다.
  6. 확인 링크 모달이 열리면 Self Check-In (CCI) 또는 **Assisted Check-In (ACI)**를 선택합니다.
  7. Generate link를 클릭합니다.

✓ 새 브라우저 디바이스 행이 표시됩니다. ✓ Streamliner가 한 번만 사용할 수 있는 확인 링크를 제공합니다. ✓ 링크에는 저장된 모드가 mode=cci 또는 mode=aci로 포함됩니다. ✓ 링크가 AVA 프런트엔드를 열고 merchant ID를 포함합니다. ✓ 실제 브라우저 디바이스에서 해당 링크를 열어 페어링합니다.

의도한 브라우저 페어링

각 브라우저 키오스크에는 활성 브라우저 디바이스가 하나만 있을 수 있습니다. 이 키오스크를 운영할 브라우저에서 링크를 여세요. 잘못된 브라우저에서 열면 나중에 그 브라우저가 키오스크를 인수할 수 없습니다. 링크를 다시 생성하면 해당 키오스크 행의 이전 브라우저 링크가 무효화됩니다.

merchant 컨텍스트

확인 링크는 이제 레거시 체크인 흐름이 아니라 AVA 프런트엔드를 사용합니다. mid가 포함되어 있어 AVA 셸이 올바른 merchant를 먼저 불러올 수 있습니다. 저장된 키오스크 모드가 링크를 제어합니다. URL 텍스트를 변경해도 브라우저를 CCI와 ACI 사이에서 전환할 수 없습니다. 링크는 사용하거나, 교체하거나, 디바이스 행을 제거할 때까지 유효합니다.

브라우저 소유권 일관성 유지​

AVA는 각 유연한 브라우저 디바이스를 하나의 브라우저 설치에 연결합니다. 이를 통해 다른 컴퓨터가 실수로 같은 키오스크를 운영하는 것을 방지합니다.

상황결과수행할 작업
최초 페어링브라우저가 키오스크 소유자가 됩니다.계속 해당 브라우저를 사용합니다.
같은 브라우저에서 재확인키오스크가 연결된 상태로 유지됩니다.새 링크를 생성해 해당 브라우저에서 엽니다.
다른 브라우저에서 링크 열기AVA가 페어링을 거부합니다.이미 페어링된 브라우저를 사용합니다.
실제 브라우저 교체이전 소유자가 계속 보호됩니다.새 유연한 브라우저 디바이스 행을 만듭니다.

AVA가 레거시 중복 바인딩을 찾으면 가장 최근에 성공한 페어링을 권한 있는 것으로 지정합니다. 이전 중복 바인딩은 삭제되며 더 이상 키오스크로 연결되지 않습니다.

각 유연한 브라우저 디바이스 행에 Connected devices가 표시됩니다. 이 수에는 동일한 브라우저 설치에 대한 활성 확인 브라우저 연결이 포함됩니다. 수가 1보다 크면 해당 브라우저가 여러 브라우저 디바이스 행과 페어링된 것입니다.

중복 연결이 있으면 AVA가 수를 빨간색으로 강조합니다. 페이지에는 각 별칭, 브라우저, 마지막 확인 시간이 포함된 Affected browser devices 경고도 표시됩니다.

중복 브라우저 연결

같은 실제 브라우저에 대한 중복 행을 계속 사용하지 마세요. 새 유연한 브라우저 디바이스를 만들고 의도한 브라우저에서 새 확인 링크를 여세요. 이렇게 하면 추가 바인딩이 제거되고 브라우저에 명확한 키오스크 소유자 하나가 지정됩니다.

안전한 재확인

새 링크를 사용해 이미 페어링된 브라우저를 다시 확인할 수 있습니다. 브라우저에 새 세션이 필요하거나 키오스크 연결을 확인해야 할 때 사용하세요.

브라우저 디바이스의 체크인 모드 변경​

브라우저를 게스트 주도 체크인과 직원 주도 체크인 사이에서 전환해야 할 때 확인 모달을 사용합니다. 모드를 변경하면 키오스크 모드가 저장되고 새 일회성 링크가 생성됩니다.

  1. Settings → Kiosk로 이동합니다.

  2. 유연한 브라우저 디바이스를 찾습니다.

  3. Get verify link를 클릭합니다.

  4. Check-in mode 섹션에서 Self Check-In (CCI) 또는 **Assisted Check-In (ACI)**를 선택합니다.

  5. Generate Self Check-In (CCI) link 또는 Generate Assisted Check-In (ACI) link를 클릭합니다.

    ✓ 교체 링크가 준비되는 동안 이전 링크와 QR이 사라집니다. ✓ 새 링크와 QR이 저장된 체크인 모드와 일치합니다. ✓ 이전 일회성 링크가 취소됩니다.

모드 변경 권한

브라우저 체크인 모드를 변경하려면 mini_mdm:manage와 settings:write가 모두 필요합니다. settings:write가 없으면 모드 선택 항목이 비활성화됩니다.

새 링크가 표시된 후에만 Copy link, Show QR, Download QR을 엽니다. 교체 링크는 대상 브라우저 디바이스와만 공유하세요.

ACI 직원 확인을 위해 다른 화면에 Show QR을 표시합니다. 대상 ACI 브라우저에서 직원이 Verify Device를 선택하고 이 QR을 스캔합니다. 페이지 내 스캐너는 브라우저의 Web Clip, PWA 또는 래퍼 컨텍스트를 활성 상태로 유지합니다.

권한을 인식하는 컨트롤

mini_mdm:read 권한이 있는 사용자는 키오스크 상태를 볼 수 있습니다. 디바이스 생성과 키오스크 행 관리는 mini_mdm:manage 권한이 필요합니다. 등록 작업에는 mini_mdm:enroll 권한이 필요합니다. 브라우저 디바이스의 체크인 모드를 변경하려면 settings:write가 필요합니다. 컨트롤을 비활성화하거나 작업을 거부할 때 AVA는 누락된 권한을 설명합니다.

단계별: 감독 대상 iPhone 또는 iPad 만들기​

먼저 등록

디바이스 행을 만들기 전에 Vouch 지원팀에 문의하세요. iPhone 또는 iPad는 먼저 Apple Business Manager에 등록되어 있어야 합니다.

  1. Settings → Kiosk로 이동합니다.
  2. 등록 카드에서 Create Device를 클릭합니다.
  3. Choose device setup에서 iOS를 클릭합니다.
  4. Dedicated Device Enrollment를 클릭합니다.
  5. 선택 사항인 레이블과 iPhone 또는 iPad 일련번호를 입력합니다.
  6. Create and assign를 클릭합니다.

✓ Streamliner가 논리적 디바이스 행을 만듭니다. ✓ iOS 설정 모달이 열리고 ADE 설정을 시작합니다. ✓ ADE Connected, ADE Synced, ADE Profile Assigned, Ready to Erase iPhone/iPad가 표시됩니다.

단계별: Guided Access 사용하기​

로컬 전용

Guided Access는 디바이스를 로컬에만 유지합니다. Streamliner는 원격으로 설치, 잠금, 잠금 해제, 재시작 또는 삭제를 수행할 수 없습니다.

  1. Settings → Kiosk로 이동합니다.
  2. How to enroll를 클릭합니다.
  3. iOS를 클릭합니다.
  4. Guided Access를 클릭합니다.
  5. Home Screen, Guided Access, AVA Check-in 튜토리얼 카드를 따릅니다.

✓ 로컬 단일 앱 설정에서 AVA Check-in을 사용할 수 있습니다. ✓ 디바이스는 감독 대상 MDM 관리 밖에 유지됩니다.

단계별: 등록된 디바이스에서 iOS 설정 마치기​

  1. iOS 디바이스 행을 찾습니다.
  2. Setup을 클릭합니다.
  3. Start kiosk setup 또는 Start setup ADE를 클릭합니다.
  4. 상태 카드가 진행될 때까지 기다립니다.
  5. 앱 설치가 멈추면 Verify and continue를 클릭합니다.

✓ 모달에 라이선스, 설치 및 잠금 모드 진행 상태가 표시됩니다. ✓ 키오스크 설정이 끝나면 행의 상태가 Ready가 됩니다.

단계별: 디바이스 등록​

공장 초기화 필요

등록하려면 공장 초기화된 디바이스가 필요합니다. 디바이스의 모든 데이터가 삭제됩니다.

  1. 디바이스를 공장 초기화합니다.
  2. 디바이스를 켠 다음 화면을 6번 탭하여 QR 스캐너를 엽니다.
  3. 일치하는 행에서 Enroll Device를 클릭합니다.
  4. Enroll Device QR Code 모달의 QR을 스캔합니다.
  5. 디바이스 설정 단계를 완료합니다.
  6. Settings → Kiosk로 돌아가 Refresh를 클릭합니다.

✓ 행의 상태가 Status: Enrolled로 바뀝니다. ✓ 이제 행에 Restart, Lock, Unlock, Un-enroll이 표시됩니다. ✓ QR은 1회용이며 3시간 동안 유효합니다.

단계별: 잠금 해제 코드 보기​

  1. Unlock Code 카드를 찾습니다.
  2. Show를 클릭해 코드를 표시합니다.
  3. Copy code를 클릭해 저장합니다.

✓ “Unlock code copied”가 표시됩니다.

단계별: 디바이스 관리​

목록 새로 고침​

  1. Devices 헤더에서 Refresh를 클릭합니다.

✓ “Refreshed (synced X, removed Y)”가 표시됩니다. ✓ 숙소에 디바이스가 많으면 목록이 모든 페이지를 자동으로 로드합니다.

재시작, 잠금 또는 잠금 해제​

  1. 디바이스 행을 찾습니다.
  2. Restart, Lock 또는 Unlock을 클릭합니다.

✓ “Action completed”가 표시됩니다. ✓ 새 디바이스 상태를 확인하기 위해 페이지가 잠시 Auto-refreshing… 상태가 됩니다.

키오스크 디바이스로 통화 시작​

확인하기 전에

통화 모달에 이제 황색 경고 상자가 표시됩니다. 이 경고는 통화가 해당 키오스크의 게스트 활동을 중단할 수 있음을 알립니다.

  1. 등록된 디바이스 행을 찾습니다.

  2. Call을 클릭합니다.

  3. 모달에서 경고를 확인합니다.

  4. Start call을 클릭합니다.

    ✓ Streamliner가 해당 키오스크 디바이스로 영상 통화를 시작합니다. ✓ 백오피스에서 키오스크에 연락해야 할 때 사용합니다. ✓ 경고는 진행 중인 게스트 활동을 중단할 수 있음을 알려 줍니다.

디바이스 등록 해제​

등록 해제 시 디바이스 초기화

등록을 해제하면 디바이스가 공장 초기화될 수 있습니다.

  1. Un-enroll을 클릭합니다.
  2. 경고를 확인합니다.

✓ 새로 고친 후 목록에서 디바이스가 사라집니다.

디바이스 라우팅​

Device Routing 카드를 사용해 등록된 각 키오스크를 올바른 객실 출입 인코더와 결제 단말에 연결합니다. 키오스크 라우팅은 이제 Room Access 페이지가 아닌 이곳에 있습니다. 키오스크에 MDM, 유연한 브라우저 또는 kiosk-device-model 기록이 없을 때만 레거시 행이 표시됩니다. AVA는 이전 행을 업데이트할 때 기존 별칭, 메모, 인코더 링크, 단말 링크를 유지합니다.

  1. Device Routing으로 스크롤합니다.
  2. 등록된 키오스크 디바이스가 하나 이상 있는지 확인합니다.
  3. 디바이스 행을 펼칩니다.
  4. 연결할 Room Access Encoder와 Payment Terminals를 선택합니다.
  5. Save mappings를 클릭합니다.

✓ 디바이스 행에 연결된 인코더와 단말 수가 표시됩니다. ✓ 아직 등록된 디바이스가 없으면 카드에 라우팅 행 대신 빈 상태가 표시됩니다. ✓ 읽기 전용 사용자는 라우팅 데이터를 볼 수 있지만 편집하거나 저장할 수 없습니다.

이전 디바이스 ID가 계속 표시될 때​

보이는 현상: 저장한 후에도 행이 이전 Android 디바이스 ID를 사용하거나 Legacy kiosk 필을 표시합니다.

해결 방법:

  1. Refresh를 클릭합니다.
  2. 같은 디바이스 행을 다시 엽니다.
  3. Save mappings를 한 번 더 클릭합니다.
  4. 이제 행에 Mini MDM Device ID가 표시되는지 확인합니다.
  5. 계속 레거시 행이 표시되면 같은 키오스크 기록을 계속 사용합니다.

문제 해결​

QR 코드가 생성되지 않음​

보이는 현상: Enroll Device를 클릭한 후 빨간 오류 메시지가 표시됩니다.

해결 방법:

  1. 페이지를 새로 고칩니다.
  2. 같은 행에서 Enroll Device를 다시 엽니다.
  3. 계속 실패하면 지원팀에 문의합니다.

디바이스 목록이 비어 있음​

보이는 현상: 등록 후 “No devices enrolled yet.”가 표시됩니다.

해결 방법:

  1. Refresh를 클릭합니다.
  2. 자동 새로 고침 주기가 한 번 이상 끝날 때까지 페이지를 열어 둡니다.
  3. 디바이스 설정이 완료되었는지 확인합니다.
  4. 계속 비어 있으면 한 번 더 새로 고칩니다.

디바이스 라우팅에 아직 디바이스가 표시되지 않음​

보이는 현상: Device Routing 카드에 “No enrolled devices yet.”가 표시됩니다.

해결 방법:

  1. 먼저 키오스크 디바이스를 하나 이상 등록합니다.
  2. Devices 섹션에서 Refresh를 클릭합니다.
  3. Device Routing으로 돌아가 새 디바이스 행을 펼칩니다.

작업 실패​

보이는 현상: Restart, Lock 또는 Unlock 후 “Action failed”가 표시됩니다.

해결 방법:

  1. 디바이스가 온라인인지 확인합니다.
  2. 작업을 다시 시도합니다.
  3. 목록을 새로 고치고 상태를 확인합니다.

통화를 사용할 수 없음​

보이는 현상: Call 버튼이 없거나 비활성화되어 있습니다.

해결 방법:

  1. 행이 등록되었는지 확인합니다.
  2. mini_mdm:manage 권한이 있는지 확인합니다.
  3. 페이지를 새로 고친 후 다시 시도합니다.

행에 Enroll Device와 Remove만 표시됨​

보이는 현상: 행에 Enroll Device와 Remove만 표시됩니다.

해결 방법:

  1. 해당 행의 Status를 확인합니다.
  2. 상태가 Unfulfilled라면 정상입니다.
  3. Enroll Device를 클릭하고 설정을 완료합니다.
  4. Refresh를 클릭해 상태가 Enrolled가 되었는지 확인합니다.

키오스크 버튼이 비활성화됨​

보이는 현상: Create Device, Show, Copy code 또는 디바이스 작업 버튼이 비활성화되어 있습니다.

해결 방법:

  1. 역할에 mini_mdm:manage가 포함되어 있는지 확인합니다.
  2. mini_mdm:read만 있다면 관리자에게 역할 권한을 변경해 달라고 요청합니다.
  3. 권한 변경 후 페이지를 새로 고칩니다.

키오스크 액세스 또는 권한을 사용할 수 없음​

보이는 현상: AVA가 키오스크 관리를 사용할 수 없다고 표시하거나 작업에서 권한 오류를 반환합니다.

해결 방법:

  1. 올바른 호텔 컨텍스트를 선택했는지 확인합니다.

  2. 키오스크 디바이스를 보려면 역할에 mini_mdm:read가 포함되어 있는지 확인합니다.

  3. 디바이스 관리에는 역할에 mini_mdm:manage가 포함되어 있는지 확인합니다.

  4. 등록 작업에는 역할에 mini_mdm:enroll이 포함되어 있는지 확인합니다.

  5. 브라우저 체크인 모드를 변경하려면 역할에 settings:write가 포함되어 있는지 확인합니다.

  6. 관리자에게 호텔 요금제에 키오스크 기능이 포함되어 있는지 확인해 달라고 요청합니다.

  7. Settings → Kiosk를 새로 고치고 작업을 다시 시도합니다.

    ✓ 페이지에 현재 액세스 권한으로 허용된 컨트롤이 표시됩니다.

자동 새로 고침이 해제되지 않음​

보이는 현상: **Auto-refreshing…**이 예상보다 오래 표시됩니다.

해결 방법:

  1. 폴링 창이 끝날 때까지 45초 기다립니다.
  2. Refresh를 한 번 클릭합니다.
  3. 반복되면 키오스크 디바이스의 네트워크 안정성을 확인합니다.

미완료 행이 등록되지 않음​

보이는 현상: QR을 스캔한 후에도 행이 Unfulfilled 상태로 남습니다.

해결 방법:

  1. Refresh를 클릭합니다.
  2. 같은 행에서 Enroll Device를 다시 엽니다.
  3. 올바른 디바이스 행을 사용했는지 확인합니다.
  4. 계속 실패하면 지원팀에 문의합니다.

보이는 현상: 브라우저 디바이스가 잘못된 흐름을 열거나 merchant 오류를 표시합니다.

해결 방법:

  1. 브라우저 확인 링크 모달을 엽니다.
  2. Self Check-In (CCI) 또는 **Assisted Check-In (ACI)**를 선택합니다.
  3. Generate link를 클릭합니다.
  4. 링크에 mode=cci 또는 mode=aci가 포함되는지 확인합니다.
  5. 링크에 mid=<merchantId>가 포함되는지 확인합니다.
  6. 실제 브라우저 디바이스에서 새 링크를 엽니다.
  7. Streamliner가 모드가 저장되었지만 링크 생성에 실패했다고 표시하면 Get verify link를 클릭합니다.
  8. 기존 링크가 잘못된 흐름을 열면 지원팀에 문의합니다.

모드 변경으로 확인 모달이 닫힘​

보이는 현상: 모드는 저장되지만 새 링크가 표시되기 전에 모달이 닫힙니다.

해결 방법:

  1. Settings → Kiosk로 돌아갑니다.

  2. 같은 브라우저 디바이스에서 Get verify link를 클릭합니다.

  3. 선택한 모드를 확인합니다.

  4. Generate Self Check-In (CCI) link 또는 Generate Assisted Check-In (ACI) link를 클릭합니다.

  5. 대상 브라우저 디바이스와 새 링크 또는 QR을 공유합니다.

    ✓ 교체 링크가 저장된 모드를 사용합니다.

보이는 현상: 링크를 한 번 연 후 브라우저 디바이스에 확인 오류가 표시됩니다.

해결 방법:

  1. Settings → Kiosk에서 새 브라우저 디바이스 링크를 생성합니다.
  2. Show QR를 선택하고 다른 화면에 표시합니다.
  3. 대상 ACI 브라우저에서 Verify Device를 선택하고 새 QR을 스캔합니다.
  4. 테스트한 이전 링크를 재사용하지 마세요.
  5. 새 QR도 실패하면 지원팀에 문의합니다.

키오스크가 다른 디바이스에 연결됨​

보이는 현상: "This kiosk is already connected to a different device."

해결 방법:

  1. Settings → Kiosk로 돌아갑니다.

  2. 키오스크의 Get verify link를 엽니다.

  3. 해당 키오스크와 이미 페어링된 브라우저에서 새 링크를 엽니다.

  4. 해당 브라우저를 사용할 수 없으면 새 Flexible browser device 행을 만듭니다.

  5. 새 링크를 사용해 교체 브라우저를 페어링합니다.

    ✓ AVA가 예기치 않은 인수로부터 기존 키오스크를 보호합니다.

브라우저가 여러 키오스크에 연결됨​

보이는 현상: Connected devices 수가 1보다 크거나 Affected browser devices 경고가 표시됩니다.

해결 방법:

  1. Settings → Kiosk에서 새 Flexible browser device 행을 만듭니다.

  2. 필요한 체크인 모드를 선택합니다.

  3. 새 확인 링크를 생성합니다.

  4. 의도한 브라우저에서 링크를 엽니다.

  5. Refresh를 클릭해 중복 경고가 사라졌는지 확인합니다.

    ✓ 새 브라우저 행에 명확한 키오스크 소유자 하나가 지정됩니다.

경고에 표시되는 브라우저 세부 정보

경고에는 영향을 받는 별칭, 감지된 브라우저, 마지막 확인 시간이 표시됩니다. 이 정보를 사용해 계속 서비스에 사용할 브라우저를 식별하세요.

키오스크에 새 브라우저 디바이스가 필요함​

보이는 현상: "This kiosk needs a new browser device in Streamliner before it can be connected again."

해결 방법:

  1. Settings → Kiosk에서 새 Flexible browser device 행을 만듭니다.

  2. Self Check-In (CCI) 또는 **Assisted Check-In (ACI)**를 선택합니다.

  3. 확인 링크를 생성합니다.

  4. 교체 브라우저에서 링크를 엽니다.

    ✓ 교체 브라우저에 새 보호 키오스크 바인딩이 지정됩니다.

iOS 설정 실패​

보이는 현상: iOS 설정 모달에 Setup failed 또는 Apple 라이선스 오류가 표시됩니다.

해결 방법:

  1. Apple Business Manager가 연결되어 있는지 확인합니다.
  2. Vouch MDM 할당이 활성 상태인지 확인합니다.
  3. Apple Apps and Books에 무료 라이선스가 있는지 확인합니다.
  4. 문제를 해결한 후 Retry setup을 클릭합니다.

앱이 계속 설치 중임​

보이는 현상: iOS 모달이 Installing app 상태에 머뭅니다.

해결 방법:

  1. iPhone 또는 iPad를 직접 확인합니다.
  2. ava.kiosk가 이미 설치되어 있거나 설치 가능한지 확인합니다.
  3. Verify and continue를 클릭합니다.
  4. Starting lock mode를 기다립니다.

설정 버튼이 없음​

보이는 현상: iOS 행에 Setup required가 표시되고 Setup 버튼이 없습니다.

해결 방법:

  1. Refresh를 클릭하고 Apple 등록이 완료될 때까지 기다립니다.
  2. 일련번호가 정확한지 확인합니다.
  3. 디바이스가 Apple Business Manager에 등록되어 있는지 확인합니다.
  4. 잘못된 디바이스를 추가했다면 행을 제거합니다.

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

다음 상황에서는 success@vouch-technologies.com으로 문의하세요.

  • ❌ 여러 번 시도해도 QR 생성 실패
  • ❌ 등록 후에도 디바이스가 나타나지 않음
  • ❌ 10분 넘게 작업 실패

함께 보내면 좋은 정보:

  • 디바이스 모델과 일련번호
  • 오류 메시지 스크린샷
  • 문제가 시작된 시간