Unity ClientRpc Metotları: Ağ Senkronizasyonunun Temel Taşı

Çok oyunculu oyunlar geliştirirken, sunucu ile istemciler arasındaki iletişimi doğru bir şekilde yönetmek kritik öneme sahiptir. Unity'nin Netcode for GameObjects kütüphanesi, bu iletişimi kolaylaştırmak için çeşitli mekanizmalar sunar. Bu mekanizmalardan biri de Unity ClientRpc metotlarıdır. Bu makalede, ClientRpc'lerin ne olduğunu, nasıl kullanıldığını, yaygın hataları ve performans ipuçlarını detaylı bir şekilde inceleyeceğiz.

ClientRpc Metotları Nedir?

ClientRpc (Remote Procedure Call) metotları, sunucunun (server) tüm bağlı istemcilere veya belirli istemcilere bir komut göndermesini sağlayan özel fonksiyonlardır. Adından da anlaşılacağı gibi, bu metotlar sunucu tarafından çağrılır ve istemci tarafında yürütülür. Temel olarak, sunucunun bir olayın tüm istemcilerde veya belirli istemcilerde gerçekleşmesini istediği durumlarda kullanılır.

Ne Zaman ClientRpc Kullanmalıyız?

Unity ClientRpc metotları genellikle görsel efektler, ses çalma, UI güncellemeleri, animasyon tetikleyicileri veya anlık, geçici olaylar gibi istemci tarafı etkileşimler için idealdir. Örneğin:

• Bir oyuncu hasar aldığında tüm istemcilerde kan efektini göstermek.


• Bir bomba patladığında patlama sesini ve görsel efektini tüm istemcilerde oynatmak.


• Bir oyuncunun skorunu güncellediğinde, skor tablosunu tüm istemcilerde senkronize etmek.


• Belirli bir oyuncuya özel bir bildirim veya mesaj göndermek.

ClientRpc Nasıl Tanımlanır ve Çağrılır?

Bir metodu ClientRpc olarak tanımlamak için, metot imzasının önüne [ClientRpc] niteliğini (attribute) eklemeniz ve metodu ClientRpc son ekiyle bitirmeniz gerekir. Bu metotlar sadece sunucu tarafından çağrılabilir. Eğer bir istemci bu metodu çağırmaya çalışırsa bir hata alacaktır.

using Unity.Netcode;

using UnityEngine;
public class Oyuncu : NetworkBehaviour

{

    public void HasarAl(int miktar)

    {

        // Sadece sunucuda çalışır

        if (!IsServer) return;
// Hasarı işle...

        Debug.Log("Sunucu: Oyuncu " + OwnerClientId + " " + miktar + " hasar aldı.");
// Hasar efektini tüm istemcilerde tetikle

        HasarEfektiGosterClientRpc(miktar);

    }
[ClientRpc]

    void HasarEfektiGosterClientRpc(int hasarMiktari)

    {

        // Bu metot tüm bağlı istemcilerde çalışır

        Debug.Log("İstemci " + NetworkManager.Singleton.LocalClientId + ": Hasar efekti gösteriliyor! Miktar: " + hasarMiktari);

        // Burada görsel efektleri, sesleri oynatabilirsiniz.

    }

}

Yukarıdaki örnekte, HasarAl metodu sunucu tarafından çağrıldığında, HasarEfektiGosterClientRpc metodunu tetikler. Bu ClientRpc metodu ise tüm bağlı istemcilerde yürütülerek ilgili görsel veya ses efektlerinin oynatılmasını sağlar.

Orta Seviye Detaylar: ClientRpcParams

Bazen bir ClientRpc'nin tüm istemcilerde değil, sadece belirli istemcilerde çalışmasını isteyebilirsiniz. İşte bu noktada ClientRpcParams devreye girer. ClientRpcParams yapısı, ClientRpc'nin hangi istemcilere gönderileceğini belirtmenizi sağlar.

using Unity.Netcode;

using UnityEngine;

using System.Collections.Generic;
public class MesajYonetici : NetworkBehaviour

{

    public void OyuncuyaOzelMesajGonder(ulong hedefClientId, string mesaj)

    {

        if (!IsServer) return;
ClientRpcParams clientRpcParams = new ClientRpcParams

        {

            TargetClientIds = new ulong[] { hedefClientId }

        };
OzelMesajGosterClientRpc(mesaj, clientRpcParams);

    }
[ClientRpc]

    void OzelMesajGosterClientRpc(string mesaj, ClientRpcParams clientRpcParams = default)

    {

        // Bu metot sadece hedefClientId'ye sahip istemcide çalışır

        Debug.Log("İstemci " + NetworkManager.Singleton.LocalClientId + ": Özel mesaj aldın: " + mesaj);

        // Burada UI üzerinde özel bir bildirim gösterebilirsiniz.

    }
public void HostHaricHerkesClientRpc(string mesaj)

    {

        if (!IsServer) return;
ClientRpcParams clientRpcParams = new ClientRpcParams

        {

            SendToClientsAndHost = false, // Host'a gönderme

            TargetClientIds = GetOtherClientIds(NetworkManager.Singleton.LocalClientId)

        };

        

        // Veya daha basit bir yol (Netcode'un sunduğu SendToClientsAndHost özelliği ile)

        // ClientRpcParams clientRpcParams = new ClientRpcParams { SendToClientsAndHost = false };

        // HostHaricMesajClientRpc(mesaj, clientRpcParams);
// Bu örnek TargetClientIds ile daha spesifik

        HostHaricMesajClientRpc(mesaj, clientRpcParams);

    }
[ClientRpc]

    void HostHaricMesajClientRpc(string mesaj, ClientRpcParams clientRpcParams = default)

    {

        Debug.Log("İstemci " + NetworkManager.Singleton.LocalClientId + ": Host hariç mesaj aldın: " + mesaj);

    }
private ulong[] GetOtherClientIds(ulong hostId)

    {

        List otherClientIds = new List();

        foreach (var client in NetworkManager.Singleton.ConnectedClientsList)

        {

            if (client.ClientId != hostId)

            {

                otherClientIds.Add(client.ClientId);

            }

        }

        return otherClientIds.ToArray();

    }

}

ClientRpcParams ile TargetClientIds dizisine hedef istemcilerin ID'lerini ekleyerek sadece o istemcilere mesaj gönderebilirsiniz. Ayrıca, SendToClientsAndHost özelliğini false yaparak sunucu (host) dışındaki tüm istemcilere gönderebilirsiniz.

Veri Aktarımı ve Güvenlik

ClientRpc metotlarına parametre olarak temel veri türleri (int, float, string vb.), NetworkVariable'lar veya INetworkSerializable arayüzünü uygulayan özel sınıflar/yapılar gönderebilirsiniz. Büyük miktarda veri göndermekten kaçınmak önemlidir, çünkü bu ağ performansını olumsuz etkileyebilir.

Güvenlik açısından, ClientRpc'lerin sadece sunucu tarafından çağrılabiliyor olması, istemcilerin keyfi olarak diğer istemcilerde olay tetiklemesini engeller. Bu, hileleri önlemeye yardımcı olan önemli bir güvenlik katmanıdır.

Pratik İpuçları

1. UI Güncellemeleri için Kullanım

Oyun içi skor tabloları veya oyuncu adları gibi dinamik UI öğelerini tüm istemcilerde senkronize etmek için Unity ClientRpc kullanmak oldukça etkilidir. Sunucu, bir oyuncunun skoru değiştiğinde bir ClientRpc çağırarak tüm istemcilerin UI'larını güncellemesini sağlayabilir.

[ClientRpc]

void SkorGuncelleClientRpc(string oyuncuAdi, int yeniSkor)

{

    // UI'da oyuncu skorunu güncelle

    Debug.Log(oyuncuAdi + " yeni skoru: " + yeniSkor);

    // UIManager.Instance.UpdateScore(oyuncuAdi, yeniSkor);

}

2. Görsel ve Ses Efektleri Tetikleme

Bir patlama, mermi çarpması veya karakter özel yeteneği gibi anlık görsel ve ses efektlerini tüm istemcilerde aynı anda oynatmak için ClientRpc'ler idealdir. Sunucu olayı doğruladıktan sonra ClientRpc'yi çağırır ve her istemci kendi tarafında efekti oynatır.

[ClientRpc]

void PatlamaEfektiOynatClientRpc(Vector3 pozisyon)

{

    // Belirtilen pozisyonda patlama görsel ve ses efektini oynat

    Instantiate(patlamaPrefab, pozisyon, Quaternion.identity);

    // AudioManager.PlaySound("Patlama");

}

3. Özel İstemci Hedefleme ile Bildirimler

Sadece belirli bir oyuncuya özel bir mesaj veya bildirim göndermek istediğinizde ClientRpcParams kullanarak hedefleme yapabilirsiniz. Örneğin, bir oyuncu bir görev tamamladığında sadece o oyuncuya 'Görevi tamamladın!' mesajı göndermek.

public void GorevTamamlandiBildir(ulong hedefClientId)

{

    if (!IsServer) return;
ClientRpcParams clientRpcParams = new ClientRpcParams

    {

        TargetClientIds = new ulong[] { hedefClientId }

    };
GorevBildirimiGosterClientRpc("Görevi başarıyla tamamladın!", clientRpcParams);

}
[ClientRpc]

void GorevBildirimiGosterClientRpc(string mesaj, ClientRpcParams clientRpcParams = default)

{

    Debug.Log("Bildirim: " + mesaj);

    // UI'da bildirim penceresini aç

}

Yaygın Hatalar ve Çözümleri

1. İstemci Tarafından ClientRpc Çağırmaya Çalışmak

Hata: Bir ClientRpc metodunu istemci tarafında (IsClient veya IsOwner true iken) çağırmaya çalışmak. Unity Netcode, bu tür bir çağrıyı engelleyecektir çünkü ClientRpc'ler sadece sunucu tarafından tetiklenmelidir.

Çözüm: ClientRpc çağırmadan önce her zaman if (IsServer) kontrolü yapın. Eğer bir istemcinin sunucuya bir şey bildirmesi gerekiyorsa, bunun için ServerRpc metotlarını kullanmalısınız.

2. Desteklenmeyen Parametre Türleri Kullanmak

Hata: ClientRpc metotlarına Netcode tarafından serileştirilemeyen karmaşık veya özel sınıf/yapı türlerini parametre olarak geçmek.

Çözüm: Parametre olarak sadece temel türler, NetworkVariable'lar veya INetworkSerializable arayüzünü uygulayan özel türler kullanın. Eğer özel bir sınıf/yapı göndermeniz gerekiyorsa, onu INetworkSerializable yapısını uygulayacak şekilde tasarlayın.

3. ClientRpc'yi Yanlış Kapsamda Çağırmak

Hata: Bir NetworkObject'a ait ClientRpc'yi, o NetworkObject'un ağ yetkisine (network authority) sahip olmayan bir yerden çağırmaya çalışmak. Her ne kadar ClientRpc'ler sunucu tarafından çağrılsa da, çağrılan metodun ait olduğu NetworkObject'un sunucu tarafından yetkilendirilmiş olması gerekir.

Çözüm: ClientRpc'leri, ilgili NetworkObject'un sunucu tarafındaki örneğinden çağırın. Genellikle bu, NetworkBehaviour'dan türeyen bir script içinde gerçekleşir.

Performans ve Optimizasyon Notları

• Sık Çağrılan ClientRpc'lerden Kaçının: Her ClientRpc çağrısı bir ağ paketi gönderimi anlamına gelir. Saniyede birden fazla kez çağrılması gereken sürekli durum güncellemeleri için NetworkVariable'ları tercih edin. ClientRpc'ler anlık, tek seferlik olaylar için daha uygundur.


• Veri Boyutunu Minimize Edin: ClientRpc'ler aracılığıyla gönderilen parametrelerin boyutunu mümkün olduğunca küçük tutun. Büyük diziler, karmaşık nesneler veya gereksiz veriler ağ trafiğini artırarak gecikmeye neden olabilir.


• Hedeflemeyi Akıllıca Kullanın: Eğer bir olay tüm istemcilerde değil, sadece belirli istemcilerde gerçekleşmesi gerekiyorsa, ClientRpcParams kullanarak hedefleme yapın. Bu, gereksiz ağ trafiğini ve istemci işlem yükünü azaltır.


• Gecikme (Latency) Faktörünü Göz Önünde Bulundurun: ClientRpc çağrıları anında gerçekleşmez. Ağ gecikmesi nedeniyle istemcilerde bir miktar gecikme ile yürütülürler. Hassas zamanlamalar gerektiren olaylarda bu gecikmeyi hesaba katın veya tahminsel (predictive) yaklaşımlar kullanın.

Sonuç

Unity ClientRpc metotları, Unity Netcode for GameObjects ile çok oyunculu oyunlar geliştirirken sunucudan istemcilere doğru ve verimli bir şekilde olayları bildirmek için güçlü bir araçtır. Doğru kullanıldığında, oyununuzdaki görsel ve işitsel senkronizasyonu büyük ölçüde geliştirir. Bu makaledeki ipuçlarını ve yaygın hata çözümlerini uygulayarak daha sağlam ve performanslı çok oyunculu deneyimler yaratabilirsiniz.