# QR코드

> **SSOBIG TOOL QR 코드란?**
>
> **QR 코드 모듈**은 플레이어가 **QR 코드를 스캔하거나, 자신의 QR 코드를 통해 특정 동작을 수행**할 수 있도록 하는 기능입니다. 이를 통해 **출석 체크, 구역 이동, 자원 지급, 미션 수행** 등 다양한 상호작용을 구현할 수 있습니다.
>
> QR 코드는 **개별 생성되며**, 플레이어가 **웹 내 카메라를 이용해 스캔**하여 사용합니다.

## **핵심 기능**

* **QR 코드 생성 및 스캔 기능**
  * 플레이어가 개별 QR 코드를 생성하고, 플레이어가 이를 스캔하여 동작 수행
* **다양한 QR 코드 활용 방식**
  * **구역 이동, 팀 배정, 자원 지급, 미션 수행 등 다양한 동작을 실행**
* **스캔 데이터 추적 및 관리 가능**
  * **스캔한 플레이어 목록 및 사용 내역**을 확인하고, 필요 시 초기화 가능

***

### **QR 코드 모드**

* QR 코드에는 세 가지 모드가 있습니다.
  * **표시만**: 플레이어는 **자신의 QR 코드만 확인**할 수 있으며, 다른 QR 코드를 스캔할 수 없습니다.
  * **스캔만**: **QR 코드 스캔만 가능**하며, 자신의 QR 코드를 표시할 수 없습니다.
  * **모두**: **자신의 QR 코드를 표시하면서 동시에 다른 QR 코드도 스캔 가능**합니다.



<figure><img src="https://4230051927-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA1Th6acONmnueqSbJMqe%2Fuploads%2Fj6czfVSCPKt3Opr9rNLC%2FQR%20%EC%BD%94%EB%93%9C%201.png?alt=media&#x26;token=87dd0a34-22f2-45da-bff2-0dfd6c9119aa" alt=""><figcaption></figcaption></figure>

### **스캔 가능 횟수**

* QR 코드가 **최대 몇 번까지 스캔될 수 있는지** 설정할 수 있습니다.
* 최소 1회부터 최대 99회까지 지정 가능하며, 설정된 횟수에 도달하면 스캔이 제한됩니다.



<figure><img src="https://4230051927-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA1Th6acONmnueqSbJMqe%2Fuploads%2FOr1vC1N3zReHVEmbVlno%2FQR%20%EC%BD%94%EB%93%9C%202.png?alt=media&#x26;token=3634282e-0875-4de4-9438-db28e1ed6d01" alt=""><figcaption></figcaption></figure>

### **스캔 가능한 플레이어 필터**

* 특정 플레이어만 QR 코드를 스캔할 수 있도록 **필터를 설정**할 수 있습니다.
* 자세한 필터 설정 방법은 [**필터 시스템**](../../undefined-2/undefined-4) 페이지에서 확인하세요.
* 예: 특정 역할(예: 리더) 또는 특정 구역에 속한 플레이어만 스캔 가능하도록 설정 가능
  * 필터 조건을 만족하지 않는 플레이어가 QR 코드를 스캔하면 오류 메시지가 표시됩니다.
  * 단, **구역, 팀, 자원 QR 코드는 필터와 관계없이 스캔 가능합니다.**

<figure><img src="https://4230051927-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA1Th6acONmnueqSbJMqe%2Fuploads%2FffcF9LuVQchtg49Pbj9N%2FQR%20%EC%BD%94%EB%93%9C%203.png?alt=media&#x26;token=adf790b0-aae6-4428-965f-f54432be413b" alt=""><figcaption></figcaption></figure>



### **재스캔 가능 여부**

* 동일한 플레이어가 같은 QR 코드를 **여러 번 스캔할 수 있도록 허용할지 여부**를 설정할 수 있습니다.
* 필요 시 1회 스캔 후 **추가 스캔 불가** 설정 가능.

### **보여준 것도 횟수 차감 여부**

* **다른 플레이어가 내 QR 코드를 스캔할 때, 해당 QR 코드의 사용 횟수를 차감할지 여부**를 설정할 수 있습니다.

### **방향 중요 여부**

* QR 코드 스캔이 **일방향인지, 양방향인지 설정**하는 기능입니다.
* 재 스캔 가능 여부를 활성화  하지 않은 상태에서는 **한 번 스캔된 플레이어 간 재스캔이 불가**합니다. (예: A → B 스캔 시, B → A 스캔 불가)
* **방향 중요 여부를 활성화하면**, 같은 플레이어끼리 **서로 스캔이 가능**해집니다.

### **구역 스캔 시 효과**

* 플레이어가 특정 **구역의 QR 코드를 스캔하면 해당 구역으로 자동 이동**됩니다.
* 예: "A구역" QR 코드 스캔 시, 플레이어가 A구역으로 자동 배치됨.

### **팀 스캔 시 효과**

* 특정 **팀의 QR 코드를 스캔하면 플레이어가 해당 팀으로 배정**됩니다.
* 예: "1팀" QR 코드 스캔 시, 플레이어가 자동으로 1팀으로 배치됨.

### **아이템 스캔 시 효과**

* 특정 **아이템(자원, 포인트 등)의 QR 코드를 스캔하면 해당 아이템이 지급**됩니다.
* 예: "점수 5점" QR 코드 스캔 시, 플레이어에게 5점이 추가됨.

> 구역, 팀, 아이템 QR 코드 생성에 대한 자세한 설명은 [구역, 팀, 아이템 QR 코드](broken-reference) 페이지에서 확인하세요.

### **제출한 스캔 초기화**

* QR 코드의 스캔 내역을 **초기화하여 다시 사용할 수 있도록 설정**할 수 있습니다.
* 예: 모든 플레이어의 스캔 기록을 초기화하여 다시 참여할 수 있도록 설정 가능.

### **스캔 목록**

* 현재까지 **QR 코드를 스캔한 플레이어 목록을 확인**할 수 있습니다.
* **언제, 어떤 QR 코드를 스캔했는지 기록**이 남아 추적이 가능합니다.

### **스캔 순위**

* **QR 코드를 가장 많이 스캔한 플레이어 또는 가장 많이 스캔당한 플레이어를 확인**할 수 있습니다.
