PixelPAD 2D - 멀티플레이어

init_multiplayer() -> None

예시
설명
멀티플레이어 프로젝트를 만들려면 반드시 호출해야 합니다. 이 함수는 서버에 연결하지 않고, 다른 멀티플레이어 기능만 초기화한다는 점에 유의하세요.
매개변수
None
매개변수가 없습니다.

반환값
반환값이 없습니다.

create_server(size: int) -> None

예시
설명
멀티플레이어 서버를 만듭니다. 5초 안에 아무도 서버에 참가하지 않으면 서버가 삭제됩니다.
매개변수
size
서버에 동시에 연결할 수 있는 최대 플레이어 수입니다. 2 이상 20 이하여야 합니다.

반환값
반환값이 없습니다. 지연이 있기 때문에 함수의 결과는 get_server_event()로 확인할 수 있으며, 이벤트 유형은 "type": "server_created"입니다.

join_server(server_id: str) -> None

예시
설명
지정한 서버 id의 서버에 연결을 시도합니다. 한 번에 하나의 서버에만 연결할 수 있으므로, 사용자가 이미 서버에 연결되어 있으면 연결이 끊어집니다.
매개변수
server_id
사용자가 참가를 시도할 서버의 ID입니다.

반환값
반환값이 없습니다. 지연이 있기 때문에 함수의 결과는 get_server_event()로 확인할 수 있으며, 이벤트 유형은 "type": "self_joined"입니다.

inspect_server(server_id: str) -> None

예시
설명
서버에 참가하지 않고 특정 서버의 정보를 가져옵니다
매개변수
server_id
정보를 가져올 서버의 ID입니다.

반환값
반환값이 없습니다. 지연이 있기 때문에 함수의 결과는 get_server_event()로 확인할 수 있으며, 이벤트 유형은 "type": "server_info"입니다.

get_server_event() -> dict

예시
설명
현재 프레임에서 create_server(), join_server(), inspect_server()의 비동기(지연된) 응답을 확인합니다.
매개변수
None
매개변수가 없습니다.

반환값
해당 프레임에 수신된 이벤트의 유형을 담은 딕셔너리이며, 이벤트가 없으면 None입니다. 이벤트 유형이 None이 아니면 딕셔너리에는 요청 성공 여부를 나타내는 불리언 필드 "status"와, "server_created" 이벤트의 서버 id처럼 이벤트 메시지 문자열을 담은 "message" 필드도 포함됩니다.

send_message(data: str) -> None

예시
설명
같은 서버에 연결된 다른 모든 사용자에게 데이터를 보냅니다.
매개변수
data
보낼 문자열입니다. 길이가 256자 이하여야 합니다.

반환값
반환값이 없습니다.

get_messages() -> list

예시
설명
get_messages()를 마지막으로 호출한 이후 현재 서버에서 수신한 모든 메시지를 가져옵니다.
매개변수
None
매개변수가 없습니다.

반환값
수신한 문자열 메시지의 목록으로, 가장 오래된 것부터 가장 최근 것 순서입니다. 수신한 메시지가 없으면 빈 목록을 반환합니다.

get_player_count() -> int

예시
설명
현재 연결된 서버에 몇 명이 있는지 확인합니다.
매개변수
None
매개변수가 없습니다.

반환값
현재 서버에 연결된 사람 수이며, 연결이 없으면 0입니다.

leave_server() -> None

예시
설명
현재 사용자를 참가 중인 모든 서버에서 연결 해제합니다.
매개변수
None
매개변수가 없습니다.

반환값
반환값이 없습니다.

get_servers() -> list

예시
설명
현재 프로젝트의 기존 서버 목록을 가져옵니다
매개변수
None
매개변수가 없습니다.

반환값
같은 프로젝트의 활성 서버 ID를 모두 담은 목록이며, 없으면 빈 목록입니다.

멀티플레이어와 서버

멀티플레이어 프로젝트는 다른 사람과 함께 플레이할 수 있는 프로젝트입니다. 여러 사람이 같은 키보드를 사용하는 방식도 있지만, 인터넷을 통해서도 가능해서 각자 자기 컴퓨터를 사용해 서로 다른 장소에 있어도 함께 프로젝트를 플레이할 수 있습니다. Pixelpad에서는 서버를 사용해 이런 프로젝트를 만들 수 있습니다.

서버는 다른 컴퓨터, 흔히 클라이언트라고 부르는 컴퓨터의 요청을 처리하고 응답하도록 설계된 컴퓨터입니다. 서버는 이 웹사이트를 포함해 매우 다양한 용도로 사용되며, 멀티플레이어 프로젝트를 만드는 데에도 사용됩니다. Pixelpad에는 서버를 만들고 참가하고, 프로젝트의 모든 서버를 조회하고 확인하고, 서버에서 메시지를 주고받는 함수가 있습니다.