> For the complete documentation index, see [llms.txt](https://developers-apps-in-toss.toss.im/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers-apps-in-toss.toss.im/documentation/unity/sample-code.md).

# 샘플 코드

앱인토스 Unity SDK에서 제공하는 기능을 한눈에 살펴볼 수 있어요. 각 항목을 클릭하면 상세 가이드와 샘플 코드를 확인할 수 있어요.

\[Unity SDK GitHub 보기 ↗]\(<https://github.com/toss/apps-in-toss-unity-sdk/>)

### 시작 가이드

| 기능                                          | 설명                                      |
| ------------------------------------------- | --------------------------------------- |
| [시작하기](/documentation/unity/integration.md) | SDK를 설치하고 빌드까지 진행할 수 있어요.               |
| API 사용 패턴                                   | 비동기 처리, 에러 대응, 테스트 환경 설정 방법을 확인할 수 있어요. |

### API 레퍼런스

| 기능        | 설명                                                |
| --------- | ------------------------------------------------- |
| 인증        | 사용자가 토스 계정으로 별도 가입 없이 간편하게 로그인할 수 있어요.            |
| 내비게이션     | 화면 상단의 제목·뒤로가기 영역을 설정할 수 있어요.                     |
| Safe Area | 노치·둥근 모서리에 가려지지 않도록 화면 여백 값을 확인해요.                |
| 시스템 정보    | 기기 ID, 플랫폼, 앱 버전, 네트워크 상태 등을 확인할 수 있어요.           |
| 권한 설정     | 카메라, 위치 등 기기 권한을 요청하고 확인할 수 있어요.                  |
| 위치 정보     | 현재 위치를 가져오거나 실시간으로 위치를 추적할 수 있어요.                 |
| 미디어       | 카메라로 촬영하거나 앨범에서 사진을 가져올 수 있어요.                    |
| 클립보드      | 복사한 텍스트를 가져오거나, 텍스트를 복사해 둘 수 있어요.                 |
| 연락처       | 사용자의 연락처 목록을 가져와요.                                |
| 스토리지      | 사용자 정보를 기기에 저장할 수 있어요.                            |
| 게임 리더보드   | 플레이가 끝나면 점수를 등록하고 순위를 보여줘요. 경쟁 요소로 다시 하고 싶게 만들어요. |
| 공유        | 게임 결과나 초대 링크를 공유해, 받은 사람이 토스 앱에서 바로 열 수 있어요.      |
| 기타 API    | 사용자 식별키, 프로모션 리워드, 앱 리뷰 요청 등을 안내해요.               |

### 빌드

| 기능        | 설명                                                    |
| --------- | ----------------------------------------------------- |
| 빌드 프로필    | 개발·테스트·배포 단계별로 최적화된 빌드 설정을 구성할 수 있어요.                 |
| 빌드 프로세스   | 초기화부터 WebGL 빌드, 패키징까지 전체 과정을 확인할 수 있어요.               |
| 빌드 커스터마이징 | index.html, npm 패키지, Vite 플러그인 등으로 빌드를 커스터마이징할 수 있어요. |

### 화면 & 이벤트

| 기능           | 설명                                            |
| ------------ | --------------------------------------------- |
| 로딩 화면 커스터마이징 | 커스텀 HTML과 JavaScript로 로딩 화면을 원하는 대로 꾸밀 수 있어요. |
| 화면 가시성 처리    | 앱이 백그라운드로 전환될 때 오디오와 게임 상태를 처리할 수 있어요.        |

### 분석 & 모니터링

| 기능         | 설명                                                     |
| ---------- | ------------------------------------------------------ |
| SDK 이벤트 로깅 | 사용자가 게임에서 뭘 했는지 기록해요. 데이터 분석, A/B 테스트 등 게임 개선에 꼭 필요해요. |
| Sentry 통합  | Sentry를 연동해 오류를 자동으로 추적하고 모니터링할 수 있어요.                 |

### 수익화

| 기능    | 설명                                    |
| ----- | ------------------------------------- |
| 인앱 광고 | 화면 전체를 덮는 광고나 보면 보상을 주는 광고를 넣을 수 있어요. |
| 인앱 결제 | 아이템처럼 한 번씩 파는 상품으로 수익을 낼 수 있어요.       |

### 문제 해결

| 기능          | 설명                                             |
| ----------- | ---------------------------------------------- |
| 문제 해결       | SDK 사용 중 자주 발생하는 문제와 해결 방법을 확인할 수 있어요.         |
| 디버깅 및 예외 처리 | Unity WebGL 환경에서 디버깅하고 예외를 처리하는 방법을 확인할 수 있어요. |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://developers-apps-in-toss.toss.im/documentation/unity/sample-code.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
