Ideias e funcionalidades do jogo

A tua próxima funcionalidade

Estatísticas de jogador

Regista rondas, eliminações e recordes num lote de sessão, com soma, máximo, mínimo ou último valor.

SDK: developRequer uma sessão de jogador
Godot
Ilustração de Estatísticas de jogador
O resultado visível

O jogo envia uma sessão completa num lote e mostra os contadores e períodos atuais.

Vídeo em breve

Este passo ainda não tem vídeo. O guia e o pedido MCP já podem ser usados.

Estatísticas de jogador

Preparar o mesmo projeto

  1. Seleciona no painel o mesmo projeto que na configuração do teu jogo.

    Estatísticas de jogador →
  2. Criem ou reutilizem estas entradas de teste no formulário do painel. São valores de exemplo, não dados atuais.

    Definições estatísticas
    kills: mode=sum, reset=none; best_score: mode=max, reset=none

    Soma adiciona cada envio. Máximo e mínimo guardam o valor extremo; último substitui-o. Máximo, mínimo e último começam no primeiro envio. Os valores são inteiros com sinal no intervalo seguro.

  3. Guardem, recarreguem e verifiquem as entradas antes do exemplo. Preservem as restantes definições.

Integra esta funcionalidade

Podes consultar o guia. Para o executar, precisas de uma chave de projeto ativa. Preparar o projeto

SDK instalado, configuração do projeto importada e jogador com sessão iniciada.

Este exemplo do SDK usa develop. Verifica se as API necessárias existem no SDK instalado.

Concluam a ligação do início rápido com o jogador escolhido. Chamem run_reviewed_action() através de um botão ou ação explícita da cena. Abrir o ficheiro não envia pedidos.

GDScript
res://scripts/statistics.gd
Chamada ao horizOn
1extends Node
2​
3# Existing configured SDK and authenticated player session required.
4# Invoke run_reviewed_action explicitly after reviewing this example.
5# This explicit action reports the shown persisted batch.
6func run_reviewed_action() -> void:
7 if not Horizon.auth.isSignedIn():
8 return
9 var snapshot: Dictionary = await Horizon.statistics.getStatistics()
10 if snapshot.is_empty():
11 push_error(Horizon.statistics.getLastErrorCode())
12 return
13 var pending_path: String = "user://statistics_" + snapshot.userId + ".dat"
14 var pending: Dictionary
15 if FileAccess.file_exists(pending_path):
16 var file := FileAccess.open(pending_path, FileAccess.READ)
17 if file == null:
18 return
19 var saved: Variant = file.get_var()
20 file.close()
21 if not saved is Dictionary:
22 return
23 pending = saved
24 else:
25 pending = {"operationId": Horizon.statistics.createOperationId(),
26 "updates": [{"key": "kills", "value": 3}, {"key": "best_score", "value": 250}]}
27 var file := FileAccess.open(pending_path, FileAccess.WRITE)
28 if file == null:
29 return
30 file.store_var(pending, false) # Variant storage preserves int64 values.
31 file.flush()
32 var saved_ok: bool = file.get_error() == OK
33 file.close()
34 if not saved_ok:
35 return
36 var original_bytes: PackedByteArray = FileAccess.get_file_as_bytes(pending_path)
37 if original_bytes.is_empty():
38 return
39 var result: Dictionary = await Horizon.statistics.updateStatistics(pending.updates, pending.operationId)
40 if result.is_empty():
41 # Keep the file and original ID, including after timeout or OPERATION_EXPIRED.
42 push_error(Horizon.statistics.getLastErrorCode())
43 return
44 # A delayed O1 success cannot remove another action's O2 original.
45 if FileAccess.get_file_as_bytes(pending_path) == original_bytes:
46 DirAccess.remove_absolute(ProjectSettings.globalize_path(pending_path))
47 print(result.values)
Abrir o exemplo SDK completo ↗

Testa a tua nova funcionalidade.

O jogo envia uma sessão completa num lote e mostra os contadores e períodos atuais.

Seleciona no painel o mesmo projeto que na configuração do teu jogo.

Endpoints da API
  • GET/statistics
  • GET/statistics/definitions
  • POST/statistics
Todos os endpoints na referência da API
Ilustração de Tabelas de classificação
A nossa sugestão para o próximo passo

Dá uma pontuação máxima a cada partida.

Guarda a pontuação depois de uma partida e mostra quem está à frente. Continua a usar a ligação e a sessão do jogador.