HTTP GET 요청 함수 설명
http_get 함수는 지정된 URL에 GET 요청을 보내 정보를 가져오는 기능을 제공합니다. 이 함수는 비동기적이기 때문에, GameMaker는 응답을 기다리는 동안 멈추지 않고 계속 실행됩니다. 응답이 도착하면 콜백 정보가 제공됩니다. 이 정보는 문자열 형태로 제공되며, 해당 객체 이벤트에 정의된 Async HTTP Event를 트리거합니다.
비동기 콜백
이 함수는 여러 개의 "콜백"을 생성하며, 이는 모든 HTTP Events에서 수신됩니다. 이러한 콜백은 이 이벤트에 독점적인 DS Map(일반적으로 "사전"이라고 불림)을 생성하며, 이 맵은 특별한 변수인 async_load에 저장됩니다. 이 DS 맵은 반환되는 데이터가 있는지에 따라 다른 값을 포함합니다. 예를 들어, 파일을 요청한 경우, 각 데이터 패킷이 수신될 때마다 이벤트가 여러 번 트리거되어 진행률 표시줄을 보여줄 수 있습니다.
문법
http_get(url);
인수 설명
| 인수 | 유형 | 설명 |
|---|---|---|
| url | String | 정보를 가져오고자 하는 서버의 웹 주소입니다. |
반환값
- 비동기 요청 ID (문제가 발생하면 -1)
예제
http_get 함수는 어떤 이벤트에서든 호출할 수 있으며, 비동기적이기 때문에 콜백은 거의 즉시 발생할 수도 있고 몇 초가 걸릴 수도 있습니다. 함수를 호출하는 것은 간단하며 다음과 같은 형태입니다:
request_id = http_get($"http://www.MacSweeneyGames.com/logon?username={name}");
위 코드는 변수 name에 저장된 문자열을 지정된 서버에 전달하고, 해당 URL에서 데이터를 가져옵니다. 이 과정에서 async_load DS 맵을 포함하는 Async Event가 트리거됩니다. async_load 맵의 인덱스는 변수 request_id에 저장되어 올바른 콜백을 확인할 수 있습니다. 트리거된 Async Event는 HTTP 하위 이벤트가 되며, 이 이벤트에서 다음과 같은 코드를 사용할 수 있습니다:
if (async_load[? "id"] == request_id) {
var _status = async_load[? "status"];
var _r_str = (_status == 0) ? async_load[? "result"] : "null";
}
위 코드는 먼저 비동기 요청의 ID를 확인한 후, 콜백의 "상태"에 따라 _r_str 변수에 값을 할당합니다. 값이 0(요청 완료를 나타냄)인 경우, 콜백의 결과가 변수에 저장되고, 그렇지 않으면 변수는 기본값(이 경우 "null")으로 설정됩니다.
활용 예제
- 기본 GET 요청
gml request_id = http_get("http://example.com/api/data"); - 사용자 이름을 포함한 GET 요청
gml request_id = http_get($"http://example.com/api/user?name={username}"); - JSON 데이터 요청 및 처리
gml if (async_load[? "id"] == request_id) { var json_data = async_load[? "result"]; var data_map = json_decode(json_data); } - 오류 처리
gml if (async_load[? "status"] != 0) { show_error("요청 실패: " + string(async_load[? "status"]), true); } - 진행률 표시
gml var progress = async_load[? "progress"]; draw_progress_bar(progress);
이와 같은 방식으로 http_get 함수를 활용하여 다양한 웹 API와 상호작용할 수 있습니다.