takePlayerScreenShot

Pede ao cliente do jogador que capture a tela dele e envie a imagem de volta.

Sintaxe

bool takePlayerScreenShot ( element oJogador, number largura, number altura [, string etiqueta = "", number qualidade = 30, number bandaMaxima = 5000, number tamanhoPacote = 500 ] )

Parâmetros

Nome	Tipo	Padrão	Descrição
oJogador	element	—	Jogador (ou elemento acima dele na árvore).
largura	number	—	Largura da captura, de 1 a 65535.
altura	number	—	Altura da captura, de 1 a 65535.
etiqueta	string	""	Texto livre devolvido junto com o resultado — útil para diferenciar várias capturas.
qualidade	number	30	Qualidade da imagem, de 0 a 100. Quanto maior, maior a transferência.
bandaMaxima	number	5000	Limite da transferência, em bytes por segundo. Um valor negativo vale como 0.
tamanhoPacote	number	500	Tamanho de cada pedaço em que a imagem é dividida, de 1 a 65535.

Retorno

true quando o pedido foi enviado a pelo menos um jogador. Devolve false se o primeiro argumento não for um elemento válido ou se não houver jogador nenhum abaixo dele. Um tamanho, uma qualidade ou um tamanho de pacote fora da faixa gera erro e devolve false.

A captura é assíncrona: o true significa apenas que o pedido saiu. A imagem chega depois, no evento onPlayerScreenShot desse jogador:

Posição	Valor
1	Nome do resource que pediu a captura.
2	Situação: "ok" quando a imagem chegou; caso contrário "minimized", "disabled" ou "error".
3	Os dados da imagem, em texto, quando a situação é "ok"; false nos demais casos.
4	Marca de tempo, em milissegundos, do momento em que a captura foi pedida.
5	A etiqueta que você passou.
6	Só aparece quando a situação não é "ok": o motivo informado pelo cliente.

addEventHandler("onPlayerScreenShot", root, function(oResource, situacao, imagem, momento, etiqueta)
    if situacao ~= "ok" then
        outputDebugString("Captura falhou para " .. getPlayerName(source) .. ": " .. situacao)
        return
    end

    local arquivo = fileCreate("capturas/" .. getPlayerName(source) .. ".jpg")
    if arquivo then
        fileWrite(arquivo, imagem)
        fileClose(arquivo)
    end
end)

takePlayerScreenShot(jogador, 640, 480, "denuncia")

Cuidado

Isto captura tudo o que o jogador tem na tela, inclusive o que está fora do jogo. Use apenas quando as regras do seu servidor permitirem, e avise os jogadores de que isso pode acontecer.

Veja também

• kickPlayer — Desconecta um jogador do servidor.
• redirectPlayer — Manda o cliente do jogador se conectar a outro servidor.
• setPlayerName — Troca o nome de um jogador conectado.
• setPlayerMuted — Marca um jogador como silenciado, ou tira o silenciamento.
• isPlayerMuted — Verifica se um jogador está silenciado no momento.
• spawnPlayer — Coloca um jogador no mundo, numa posição definida.
• setPlayerBlurLevel — Ajusta o nível de borrão da tela do jogador.
• getPlayerBlurLevel — Devolve o nível de borrão do jogador.