Temel kavramlar

RTC (Gerçek Zamanlı İletişim), gönderici ile alıcı arasında ses, görüntü ve diğer verilerin neredeyse anında değiş tokuş edilmesine olanak tanıyan gerçek zamanlı iletişim teknolojisini ifade eder.

Agora SDK’ları, çoklu platform ve çoklu cihaz desteğiyle gerçek zamanlı ses ve video etkileşim hizmetleri sağlar. Bunlara yüksek çözünürlüklü görüntülü aramalar, yalnızca sesli aramalar, etkileşimli canlı yayın ve bire bir ve çoklu grup sohbetleri dahildir.

Bu kılavuz, Video SDK’yı kullanmak için bilmeniz gereken temel süreçleri ve kavramları tanıtmaktadır .

Agora, kesintisiz gerçek zamanlı iletişimi sağlamak için aşağıdaki temel kavramlardan yararlanır:

Agora SD-RTN™

Agora’nın temel etkileşim hizmetleri, her zaman, her yerden erişilebilen küresel bir altyapı olan Yazılım Tanımlı Gerçek Zamanlı Ağı (SD-RTN™) tarafından desteklenmektedir. Geleneksel ağların aksine, Agora SD-RTN™ cihazlar, telefon numaraları veya telekom kapsama alanları tarafından kısıtlanmaz. 200’den fazla ülke ve bölgedeki veri merkezleriyle, gerçek zamanlı medya için saniyenin altında gecikme ve yüksek kullanılabilirlik sağlar.

Agora SD-RTN™ gerçek zamanlı iletişim (RTC) aracılığıyla canlı kullanıcı etkileşimini mümkün kılarak şunları sunar:

Eşsiz hizmet kalitesi
Yüksek kullanılabilirlik ve erişilebilirlik
Gerçek ölçeklenebilirlik
Düşük maliyet

Channel concepts

Agora, kullanıcıları bir araya getirmek için kanallar kullanır ve sorunsuz iletişim ve etkileşimi mümkün kılar. Kanallar, ister ses, ister video veya sinyal olsun, gerçek zamanlı verilerin iletilmesinin temelini oluşturur ve kullanıcıları ve hizmetleri birbirine bağlamada önemli bir rol oynar.

Channel

Bir kanal kullanıcıları bir gruba organize eder ve benzersiz bir kanal adıyla tanımlanır. Aynı kanala bağlanan kullanıcılar birbirleriyle iletişim kurabilir. Bir kanal, ilk kullanıcı katıldığında oluşturulur ve son kullanıcı ayrıldığında varlığı sona erer.

Kanallar, gerçek zamanlı verileri iletmek için yöntemleri çağırarak oluşturulur. Agora, farklı veri türlerini iletmek için farklı kanallar kullanır:

Video SDK kanalı ses veya video verilerinin iletilmesi için kullanılır.
Sinyal kanalı , mesajlaşma veya sinyalleme verilerinin iletilmesi için kullanılır.

Bu kanallar birbirinden bağımsızdır.

Agora’nın sunduğu Bulut Kaydı ve Konuşmayı Metne Dönüştürme gibi ek hizmetler, gerçek zamanlı kayıt, aktarım hızlandırma, medya oynatma ve içerik denetimi sağlamak için Video SDK kanalına katılıyor .

Channel profile

Video SDK, seçilen kanal profiline göre farklı optimizasyon yöntemleri uygular. Agora aşağıdaki kanal profillerini destekler:

Kanal profili	Tanım
Communication	Bu profil, kanaldaki tüm kullanıcıların serbestçe konuşabildiği birebir veya grup görüşmeler için uygundur.
Live Broadcasting	Canlı yayın kanalında kullanıcıların iki istemci rolü vardır: sunucu ve izleyici . Sunucu akışları gönderir ve alır, izleyici ise yalnızca gönderme işlevi devre dışı bırakılmış akışları alır.

Stream

Bir akış, medya verileri içeren dijital olarak kodlanmış, tutarlı sinyaller dizisidir. Bir kanaldaki kullanıcılar yerel akışları yayınlar ve diğer kullanıcılardan gelen uzak akışlara abone olur .

User role

Kullanıcı rolü, bir kanaldaki kullanıcının akışları yayınlama iznine sahip olup olmadığını tanımlar. İki kullanıcı rolü vardır:

Host : Bir kanala yayın yapabilen kullanıcı.
Audience : Yalnızca uzak medya akışlarına abone olabilen bir Kullanıcı. Bu role sahip bir kullanıcı akışları yayınlayamaz.

Publish

Yayınlama, bir kullanıcının ses veya video verilerini kanala gönderme eylemidir. Genellikle, yayınlanan akış bir mikrofondan örneklenen ses verileri veya bir kamera tarafından yakalanan video verileri tarafından oluşturulur. Ayrıca, çevrimiçi bir müzik dosyası veya kullanıcının ekranı gibi diğer kaynaklardan da medya akışları yayınlayabilirsiniz.

Bir akışı başarıyla yayınladıktan sonra SDK bunu kanaldaki diğer kullanıcılara medya verileri göndermek için kullanır. Kullanıcılar yerel akışları yayınlayarak ve uzak akışlara abone olarak gerçek zamanlı olarak birbirleriyle iletişim kurar.

Abonelik, uzak kullanıcılar tarafından kanala yayınlanan medya akışlarını alma eylemidir. Bir kullanıcı, diğer kullanıcıların akışlarından birine veya daha fazlasına abone olarak onlardan ses ve video verileri alır. Abone olunan akışları doğrudan oynatırsınız veya gelen verileri kayıt veya ekran görüntüsü yakalama gibi diğer amaçlar için işlersiniz.

User ID

Video Arama’da UID , bir kullanıcıyı bir kanal bağlamında benzersiz şekilde tanımlayan bir tam sayı değeridir. Bir kanala katılırken, kullanıcıya belirli bir UID atama veya 0veya seçeneğini kullanma nullve Agora’nın kullanıcıya otomatik olarak bir UID oluşturmasına ve atamasına izin verme seçeneğiniz vardır. İki kullanıcı aynı UID ile aynı kanala katılmaya çalışırsa, bu beklenmedik davranışlara yol açabilir.

UID, Agora’nın hizmetleri ve bileşenleri tarafından bir kanal içindeki kullanıcıları tanımlamak ve yönetmek için kullanılır. Çakışmaları önlemek için UID’lerin düzgün bir şekilde atandığından emin olun.

RTC connection

SDK ile kanal arasındaki bağlantı. Birden fazla kanalda birden fazla akışı yayınlarken veya abone olurken, hedef kanalı belirtmek için bir bağlantı kullanılır.

Kimlik Bilgileri

Güvenilir erişim ve güvenli iletişimi garantilemek için Agora, uygulamaları tanımlamak, isteklerini doğrulamak ve platformuna erişimlerini yetkilendirmek için Uygulama Kimliği, Uygulama Sertifikası ve belirteçler gibi kimlik bilgilerini kullanır.

App ID

Uygulama Kimliği, Agora tarafından her projeyi tanımlamak ve faturalama ve diğer istatistiksel veri hizmetleri sağlamak için oluşturulan benzersiz bir anahtardır. Uygulama Kimliği, uygulamanızdaki kullanıcıları birbirine bağlamak için kritik öneme sahiptir. Uygulamanızdaki Agora Motorunu başlatmak ve güvenli iletişim için kimlik doğrulama belirteçleri oluşturmak için gereken anahtarlardan biri olarak kullanılır. Agora Konsolu’nu kullanarak projenizin Uygulama Kimliğini alın .

Uygulama Kimlikleri ön uç istemcide saklanır ve erişim kontrolü sağlamaz. Yalnızca bir Uygulama Kimliği kullanan projeler, Uygulama Kimliğine sahip tüm kullanıcıların katılmasına izin verir. Erişim kontrolü için, özellikle üretim ortamlarında, yeni bir proje oluştururken kullanıcı kimlik doğrulaması için Uygulama Kimliği + Belirteç mekanizmasını seçin. Kimlik doğrulama belirteçleri olmadan, ortamınız Uygulama Kimliğinize erişimi olan herkese açıktır.

App Certificate

Uygulama Sertifikası, Agora Konsolu tarafından projeleri belirteç kimlik doğrulaması yoluyla güvence altına almak için oluşturulan benzersiz bir anahtardır . Uygulama Kimliğiyle birlikte, sistemleriniz ve Agora’nın ağı arasında yetkilendirmeyi kanıtlayan bir belirteç oluşturmak için gereklidir . Uygulama Sertifikaları, Görüntülü Arama kimlik doğrulama belirteçleri oluşturmak için kullanılır .

Uygulama Sertifikasını arka uç sistemlerinizde güvenli bir şekilde saklayın. Uygulama Sertifikanız tehlikeye girerse veya güvenlik uyumluluk gereksinimlerini karşılamak için Agora Konsolu aracılığıyla sertifikaları geçersiz kılabilir ve yenilerini oluşturabilirsiniz .

Tokens

Bir belirteç, Uygulama Kimliği, Uygulama Sertifikası, kullanıcı kimliği ve son kullanma tarihi zaman damgası kullanılarak oluşturulan dinamik bir anahtardır. Belirteçler, Agora’nın hizmetlerine erişimi doğrular ve güvence altına alır, yalnızca yetkili kullanıcıların bir kanala katılabilmesini ve gerçek zamanlı iletişime katılabilmesini sağlar.

Jetonlar sunucunuzda üretilir ve Görüntülü Aramada kullanılmak üzere istemciye iletilir . Jeton oluşturma süreci, Uygulama Kimliği, Uygulama Sertifikası, kullanıcı kimliği ve son kullanma tarihi zaman damgasının belirli bir algoritma kullanılarak dijital olarak imzalanmasını içerir ve bu da kurcalamayı veya sahteciliği önler.

Geliştirme ve test sırasında geçici belirteçler oluşturmak için Agora Konsolu’nu kullanın . Üretim ortamları için kanallarınıza erişimi kontrol etmek üzere güvenlik altyapınızın bir parçası olarak bir belirteç sunucusu uygulayın.

Token oluşturmak ve yönetmek için bir token sunucusunun kurulumu hakkında bilgi için Tokenlarla güvenli kimlik doğrulama kılavuzuna bakın .

Agora Konsolu

Agora Konsolu , Agora projelerinizi ve hizmetlerinizi yönettiğiniz ana panodur . Agora’nın SDK’larını kullanabilmeniz için öncelikle Agora Konsolu’nda bir proje oluşturmanız gerekir . Ayrıntılar için Agora hesap yönetimine bakın .

Agora Konsolu, geliştiricilerin Agora hesaplarını sorgulamaları ve yönetmeleri için sezgisel bir arayüz sağlar . Bir Agora hesabı kaydettikten sonra, Agora Konsolunu kullanarak aşağıdaki görevleri gerçekleştirebilirsiniz:

Hesabınızı yönetin
Agora projelerini ve hizmetlerini oluşturun ve yapılandırın
Bir Uygulama Kimliği ve Uygulama sertifikası alın
Geliştirme ve test için geçici token’lar oluşturun
Üyeleri ve rolleri yönetin
Çağrı kalitesini ve kullanımını kontrol edin
Faturaları kontrol edin ve ödeme yapın
Ürün kaynaklarına erişin

Agora hesabınızın tüm yönlerini nasıl yöneteceğinize ilişkin ayrıntılar için Agora hesap yönetimine bakın .

Agora ayrıca proje oluşturma ve kullanım numaralarını programlı olarak alma gibi özellikleri uygulamak için kullanabileceğiniz RESTful API’ler de sağlar.

Ön işleme: Gönderici izinde sanal arka plan, güzelleştirme, yankı giderme ve gürültü azaltma gibi ses/video filtreleri.
Son işleme: Alıcı parçadaki süper çözünürlük ve mekansal ses efektleri gibi ses/video filtreleri.

Çıktı

Parçanın sonunda bulunan kodlayıcı veya görüntüleyici gibi bir araçtır.

What are You Looking For?

Temel kavramlar

Agora SD-RTN™