PixelPAD 2D - Multijogador

init_multiplayer() -> None

Exemplo
Descrição
Precisa ser chamada para ter um projeto multijogador. Observe que isso NÃO conecta você a um servidor, apenas inicializa as outras funcionalidades de multijogador.
Parâmetros
None
Sem parâmetros.

Retorno
Sem valor de retorno.

create_server(size: int) -> None

Exemplo
Descrição
Cria um servidor multijogador. Se ninguém entrar no servidor em 5 segundos, ele será excluído.
Parâmetros
size
O número máximo de jogadores que podem estar conectados ao servidor ao mesmo tempo. Deve ser entre 2 e 20, inclusive.

Retorno
Sem valor de retorno. Por causa do atraso, o resultado da função pode ser obtido com get_server_event(), onde o tipo do evento será "type": "server_created".

join_server(server_id: str) -> None

Exemplo
Descrição
Tenta conectar ao servidor com o id de servidor especificado. Se o usuário já estiver conectado a um servidor, ele será desconectado, pois só é possível estar conectado a um servidor por vez.
Parâmetros
server_id
O ID do servidor em que o usuário deve tentar entrar.

Retorno
Sem valor de retorno. Por causa do atraso, o resultado da função pode ser obtido com get_server_event(), onde o tipo do evento será "type": "self_joined".

inspect_server(server_id: str) -> None

Exemplo
Descrição
Obtém informações sobre um servidor específico sem entrar nele
Parâmetros
server_id
O ID do servidor sobre o qual obter informações.

Retorno
Sem valor de retorno. Por causa do atraso, o resultado da função pode ser obtido com get_server_event(), onde o tipo do evento será "type": "server_info".

get_server_event() -> dict

Exemplo
Descrição
Verifica respostas assíncronas (atrasadas) de create_server(), join_server() e inspect_server() no quadro atual.
Parâmetros
None
Sem parâmetros.

Retorno
Um dicionário com o tipo de evento recebido no quadro, ou None se não houver evento. Se o tipo do evento não for None, o dict também conterá o campo booleano "status", indicando se a solicitação teve sucesso ou não, além do campo "message", contendo uma string com a mensagem do evento, como o id do servidor em um evento "server_created".

send_message(data: str) -> None

Exemplo
Descrição
Envia dados para todos os outros usuários conectados ao mesmo servidor.
Parâmetros
data
A string a enviar. Deve ter no máximo 256 caracteres.

Retorno
Sem valor de retorno.

get_messages() -> list

Exemplo
Descrição
Obtém todas as mensagens recebidas do servidor atual desde a última chamada de get_messages().
Parâmetros
None
Sem parâmetros.

Retorno
Uma lista de mensagens em string que foram recebidas, em ordem da mais antiga para a mais recente. Retorna uma lista vazia se nenhuma mensagem foi recebida.

get_player_count() -> int

Exemplo
Descrição
Verifica quantas pessoas estão no servidor conectado no momento.
Parâmetros
None
Sem parâmetros.

Retorno
O número de pessoas conectadas ao servidor atual, 0 se não houver conexão.

leave_server() -> None

Exemplo
Descrição
Desconecta o usuário atual de qualquer servidor em que ele esteja.
Parâmetros
None
Sem parâmetros.

Retorno
Sem valor de retorno.

get_servers() -> list

Exemplo
Descrição
Obtém uma lista dos servidores existentes para o projeto atual
Parâmetros
None
Sem parâmetros.

Retorno
Uma lista com todos os IDs de servidores ativos do mesmo projeto, ou uma lista vazia se não houver nenhum.

Multijogador e servidores

Projetos multijogador são projetos que você pode jogar junto com outras pessoas. Às vezes isso é feito com várias pessoas usando o mesmo teclado, mas também pode ser feito pela internet, para que as pessoas usem seus próprios computadores e joguem juntas mesmo estando em lugares diferentes. O Pixelpad permite criar esses projetos usando servidores.

Um servidor é um computador feito para processar e responder a solicitações de outros computadores, geralmente chamados de clientes. Os servidores são usados para uma enorme variedade de finalidades, incluindo este site, mas também são usados para fazer projetos multijogador. O Pixelpad tem funções para criar e entrar em servidores, para inspecionar e ver todos os servidores de um projeto e para enviar e receber mensagens nos servidores.