UnityWebRequest 는 유니티에서 HTTP 통신을 수행하기 위한 클래스로, 웹 서버와 데이터를 주고 받을 때 사용한다.
이에 대한 개념을 한번 짚고 넘어가보자.
UnityEngine.Networking 네임스페이스 안에 있는 클래스로,
HTTP 통신(GET, POST, PUT, DELETE 등)을 수행하여
웹 서버와 데이터를 주고 받을 수 있게 한다.
보통 유니티에서 엑셀 데이터를 가져올 떄나, 서버에서 텍스트, 이미지 등을 받아올 때 쓰이거나
서버에 데이터를 POST 할 때도 유용하게 쓰인다.
HyperText Transfer Protocol의 줄임말로, 클라이언트와 서버간 데이터를 주고 받기 위한 통신 방식이다.
아래는 주요 HTTP 메서드와 서버 응답코드를 정리하였다.
| 메서드 | 설명 | 용도 |
|---|---|---|
| GET | 서버로부터 데이터 가져오기 | 파일 다운로드, 정보 조회 |
| POST | 서버에 새로운 데이터 전송 | 회원가입, 로그인, 업로드 등 |
| PUT | 기존 데이터를 수정 | 데이터 전체 갱신 |
| DELETE | 데이터를 삭제 | 특정 데이터 제거 |
| PATCH | 일부 데이터 부분 수정 | 한 필드만 수정 등 |
| 상태코드 | 의미 | 설명 |
|---|---|---|
| 200 OK | 성공 | 요청 정상 처리 |
| 201 Created | 생성됨 | POST로 리소스 생성 성공 |
| 400 Bad Request | 잘못된 요청 | 요청 형식 오류 |
| 401 Unauthorized | 인증 실패 | 토큰 누락 등 |
| 403 Forbidden | 권한 없음 | 접근 금지 |
| 404 Not Found | 못 찾음 | URL 오류 |
| 500 Internal Server Error | 서버 오류 | 예외 발생 등 |
| 항목 | 설명 | 용도 |
|---|---|---|
Get |
서버에서 데이터 받기 | 랭킹, 설정파일 다운로드 등 |
Post |
서버에 데이터 보내기 | 로그인, 폼 제출 등 |
Put |
서버 데이터 전체 수정 | 프로필 수정 등 |
Delete |
데이터 삭제 요청 | 친구 삭제 등 |
SendWebRequest() |
요청 전송 | Coroutine에서 비동기로 실행 |
DownloadHandlerBuffer |
텍스트/JSON 받기 | CSV, 로그 등 |
DownloadHandlerTexture |
이미지 받기 | 캐릭터 사진 등 |
UploadHandlerRaw |
JSON 등 바이트 업로드 | API 호출, 저장 요청 |
중요한 메서드 몇 개만 정리해보자.