# 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 코드를 스캔할 수 있도록 **필터를 설정**할 수 있습니다.
* 자세한 필터 설정 방법은 [**필터 시스템**](https://ssobig-corp.gitbook.io/ssobig-tool-guide/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 코드](https://ssobig-corp.gitbook.io/ssobig-tool-guide/undefined-4/undefined-1/broken-reference) 페이지에서 확인하세요.

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

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

### **스캔 목록**

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

### **스캔 순위**

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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://ssobig-corp.gitbook.io/ssobig-tool-guide/undefined-4/undefined-1/qr.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.