GameMaker의 비동기 HTTP 함수

이 문서에서는 GameMaker에서 사용할 수 있는 다양한 비동기 HTTP 함수에 대해 설명합니다. HTTP는 월드 와이드 웹에서 통신을 위한 프로토콜로, 웹 브라우저를 통해 인터넷을 탐색하거나 파일을 다운로드하고, 웹사이트에 로그인하며, RESTful API와 상호작용할 때 사용됩니다. HTTPS는 보안이 추가된 변형입니다.

HTTP 요청은 웹 서버에 전송되며, 서버는 응답을 통해 다시 데이터를 보냅니다. 요청은 여러 방법 중 하나를 사용하며, GET과 POST가 가장 일반적입니다. 요청과 응답 모두 헤더(키-값 쌍의 모음)와 요청 본문(전송할 실제 데이터)을 포함할 수 있습니다. 응답에는 상태 코드가 포함되어 있으며, 데이터(예: 파일 내용)를 포함할 수 있습니다.

GameMaker에서는 이 페이지의 함수를 사용하여 HTTP 요청을 생성하고 전송할 수 있습니다. 응답은 모든 인스턴스에서 비동기 HTTP 이벤트로 반환됩니다.

요청 함수

가장 일반적인 함수는 http_request로, 요청 방법, 헤더 및 데이터를 지정할 수 있습니다. 다른 함수들은 더 구체적인 요청에 사용됩니다.

URL

모든 요청 함수는 URL을 필요로 합니다. URL 문자열은 다음을 포함해야 합니다:

요청 만들기

일반 HTTP 요청이 시작부터 끝까지 어떻게 처리되는지 살펴보겠습니다.

// 마우스 왼쪽 클릭 이벤트
var _map_headers = ds_map_create();
request_id = http_request("http://www.google.com", "GET", _map_headers, "");
ds_map_destroy(_map_headers);

// 비동기 - HTTP 이벤트
if (async_load[? "id"] != request_id) exit;
var _status = async_load[? "status"];
if (_status < 0) {
    // 오류 발생
    exit;
}
if (_status == 1) {
    // 다운로드 중
    exit;
}
if (_status == 0) {
    // 요청 완료!
    if (async_load[? "http_status"] == 200) {
        // 요청 성공
    }
}

이 예제에서 Mouse Left Pressed 이벤트는 http_request 함수를 호출합니다. 요청은 "GET" 방법을 사용하여 웹페이지를 가져옵니다. 헤더는 전달되지 않으며 요청 본문은 빈 문자열로 설정됩니다. 이후 비동기 HTTP 이벤트가 여러 번 트리거됩니다.

연결 시간 초과

비동기 HTTP 함수는 서버에 요청을 보내며, 서버가 응답하는 데 시간이 걸릴 수 있습니다. 서버가 너무 오랜 시간 동안 응답하지 않으면 연결이 시간 초과될 수 있습니다. GameMaker에서는 기본적으로 60000ms 후에 발생합니다.

다음 두 함수를 사용하여 이 값을 가져오거나 변경할 수 있습니다.

교차 도메인 문제

위의 http_* 함수는 교차 도메인 보안 문제로 인해 예상대로 작동하지 않을 수 있습니다. 이는 서버에 대한 요청이나 다른 도메인에서 리소스를 로드하려는 시도가 차단되어 빈 결과나 404 오류가 발생할 수 있음을 의미합니다.

이미지 로드 또는 HTTP 요청에서 교차 출처 유형을 결정하거나 설정하는 것이 중요한 경우 다음 함수가 존재합니다.

대부분의 경우 이러한 함수는 필요하지 않지만, 게임이 보안 서버에 저장되어 있을 때 특정 자산에 접근하기 위해 기본 인증이 필요할 수 있으며, 로드할 때 보안 오류가 발생하는 경우 이미지 요청의 교차 출처 유형을 "use-credentials"로 설정해야 할 수 있습니다.

활용 예제

다양한 활용 및 응용 예제를 통해 HTTP 요청을 사용하는 방법을 보여줍니다.

GET 요청 예제

var response_id = http_get("http://api.example.com/data");

파일 다운로드 예제

var file_download_id = http_get_file("http://example.com/file.zip");

POST 요청 예제

var post_data = "key1=value1&key2=value2";
var post_id = http_post_string("http://api.example.com/submit", post_data);

연결 시간 초과 설정 예제

http_set_connect_timeout(30000); // 30초로 설정

교차 출처 요청 설정 예제

http_set_request_crossorigin("use-credentials");

이와 같은 다양한 예제를 통해 GameMaker에서 HTTP 요청을 효과적으로 사용할 수 있습니다.