A HLAPI fornece um sistema para desenvolver jogos multiplayer no Unity, funcionando sobre a LLAPI e tratando tarefas comuns como sincronização de estados entre clientes e servidor. Segue um modelo cliente-servidor autoritário onde um jogo tem um servidor e vários clientes, e o anfitrião faz as vezes de cliente e servidor. Componentes como NetworkIdentity e NetworkTransform sincronizam objetos na rede.

1. Introdução à HLAPI (High Level API)
Prof. Fernando Vieira da Silva, MSc.

2. HLAPI – O que é?
● Sistema para desenvolver capacidade multiplayer em jogos no
Unity
● Funciona SOBRE a LLAPI
● Trata muitas tarefas comuns no desenvolvimento multiplayer

3. Arquitetura
● Segue o modelo Cliente-Servidor, com SERVIDOR
AUTORITÁRIO
● Um participante pode ser cliente e servidor ao mesmo tempo
(não é necessário servidor dedicado)

4. Server e Host
● Jogo tem 1 servidor e muitos clientes
● Quando não há servidor dedicado o Host faz o papel de cliente
e servidor no mesmo processo
● Host usa um cliente LocalClient para ser comunicar com o
servidor, enquanto os demais usam um RemoteClient

5. Jogadores, Jogadores Locais e Autoridades
● Há um objeto associado a cada jogador
● Comandos são enviados aos jogadores (ex: disparar tiro)
● Somente é possível enviar comandos ao seu próprio jogador
(jogador local)

6. Objetos Não-Jogadores
● Autoridade de Objetos Não-Jogadores (como inimigos) fica com
o servidor
● PS: A partir do Unity 5.2é possível um cliente obter autoridade
de um objeto não-jogador, mas é não é um processo trivial...

7. NetworkManager
● É o principal componente que controla as funcionalidades de
rede

8. NetworkManagerHUD
● Interface para escolher abrir o jogo como servidor ou cliente

9. NetworkIdentity
● Identifica o objeto na rede – Faz com que seu objeto seja
conhecido pelo sistema de Networking da HLAPI
● Componente precisa ser adicionado ao GameObject

10. NetworkTransform
● Sincroniza a posição do GameObject (posição, rotação e
escala) com todos os demais clientes e o servidor na rede
● Componente precisa ser adicionado ao GameObject

11. Spawning
● Pode-se controlar os objetos que são feitos spawn diretamente
no NetworkManager através do campos “Player prefab” e
“Spawn Info”.
● Esses objetos serão criados nos clientes e gerenciados pelo
sistema de spawning da HLAPI

12. Sincronização de Estados: SyncVars
class Player : NetworkBehaviour
{
[SyncVar]
int health;
public void TakeDamage(int amount)
{
if (!isServer)
return;
health -= amount;
}
}
● Variáveis que são sincronizadas do servidor para os clientes
● Quando um objeto é spawned ou um novo jogador entra, os
estados mais atualizados das SyncVars são visíveis.

13. Jogadores e Comandos
● Jogador no cliente envia comando para o jogador no servidor
● Servidor chama funções nos clientes via RPC (Remote
Procedure Calls)

14. Exemplo Comando
class Player : NetworkBehaviour
{
public GameObject bulletPrefab;
[Command]
void CmdDoFire(float lifeTime)
{
GameObject bullet = (GameObject)Instantiate(
bulletPrefab,
transform.position + transform.right,
Quaternion.identity);
var bullet2D = bullet.GetComponent<Rigidbody2D>();
bullet2D.velocity = transform.right * bulletSpeed;
Destroy(bullet, lifeTime);
NetworkServer.Spawn(bullet);
}
void Update()
{
if (!isLocalPlayer)
return;
if (Input.GetKeyDown(KeyCode.Space))
{
CmdDoFire(3.0f);
}
}
}

15. Exemplo RPC
class Player : NetworkBehaviour
{
[SyncVar]
int health;
[ClientRpc]
void RpcDamage(int amount)
{
Debug.Log("Took damage:" + amount);
}
public void TakeDamage(int amount)
{
if (!isServer)
return;
health -= amount;
RpcDamage(amount);
}
}

16. Fim!