HTTP POST 문자열 함수 설명
http_post_string 함수는 HTTP POST 방법을 사용하여 문자열을 서버에 전송하는 기능을 제공합니다. 컴퓨터에서 POST 요청은 클라이언트가 서버에 데이터를 전송해야 할 때 사용됩니다. 예를 들어, 파일을 업로드하거나 작성된 양식을 제출할 때 사용됩니다. 이 함수는 GameMaker에서도 동일하게 작동합니다.
비동기 콜백
이 이벤트는 "콜백"을 생성하며, 이는 모든 HTTP 이벤트에서 수신됩니다. 이 경우, 특별한 변수 async_load에 저장된 DS 맵(일반적으로 "사전"이라고 불림)을 생성합니다. 이 DS 맵은 반환되는 데이터가 있는지 여부에 따라 다른 값을 포함합니다. 예를 들어, 파일을 요청한 경우, 각 데이터 패킷이 수신될 때마다 이벤트가 여러 번 트리거되어 진행률 표시줄을 보여줄 수 있습니다.
문법
http_post_string(url, string);
인수 설명
| 인수 | 타입 | 설명 |
|---|---|---|
| url | String | 정보를 요청할 서버의 웹 주소입니다. |
| string | String | 지정된 URL로 전송할 문자열입니다. |
반환값
- 비동기 요청 ID (문제가 발생하면 -1)
예제
http_post_string 함수는 모든 이벤트에서 호출할 수 있으며, 비동기 방식이므로 콜백은 거의 즉시 발생할 수도 있고 몇 초가 걸릴 수도 있습니다. 함수를 호출하는 방법은 다음과 같습니다:
var _str = $"name={player_name}&score={player_score}";
request_id = http_post_string("http://www.angusgames.com/game?game_id={global.game_id}", _str);
위 코드는 지정된 URL에 주어진 매개변수와 함께 검색 요청을 전송하며, 변수 _str에 저장된 추가 데이터(플레이어 이름과 점수)를 URL 인코딩 형식으로 전송합니다. 콜백이 수신되면 정의된 모든 비동기 HTTP 이벤트가 트리거되며, 반환된 "id"를 변수 request_id와 비교하여 다양한 http_post_string 함수를 사용한 경우 올바른 코드를 실행할 수 있습니다.
다음은 이를 수행하는 방법을 보여주는 예제 코드입니다:
var _r_str = "null";
if (async_load[? "id"] == request_id) {
if (async_load[? "status"] == 0) {
_r_str = async_load[? "result"];
}
}
위 코드는 먼저 요청의 ID를 확인한 다음 콜백의 상태를 확인합니다. 값이 0(완료 신호)인 경우 콜백의 결과를 변수에 저장하여 향후 사용할 수 있도록 합니다. 그렇지 않으면 변수는 기본값("null")을 유지합니다.
활용 예제
- 사용자 등록: 사용자가 입력한 정보를 서버에 전송하여 등록하는 기능.
gml var _str = $"username={username}&password={password}"; request_id = http_post_string("http://example.com/register", _str); - 게임 점수 제출: 플레이어의 점수를 서버에 제출하는 기능.
gml var _str = $"player_id={player_id}&score={player_score}"; request_id = http_post_string("http://example.com/submit_score", _str); - 설문 조사 응답 전송: 사용자가 설문 조사에 응답한 내용을 서버에 전송하는 기능.
gml var _str = $"question_id={question_id}&answer={selected_answer}"; request_id = http_post_string("http://example.com/submit_survey", _str); - 파일 업로드: 사용자가 선택한 파일을 서버에 업로드하는 기능.
gml var _str = $"file_data={file_data}"; request_id = http_post_string("http://example.com/upload_file", _str); - 채팅 메시지 전송: 사용자가 입력한 채팅 메시지를 서버에 전송하는 기능.
gml var _str = $"user={username}&message={chat_message}"; request_id = http_post_string("http://example.com/send_message", _str);