Ajax Video SDK Kullanım Kılavuzu

Ajax Video SDK, Ajax video izleme sistemini üçüncü taraf yazılımlara entegre etmek için tasarlanmış bir araç setidir. Geliştiricilerin Ajax video cihazlarından canlı ve kayıtlı videoyu akış olarak iletmesini ve video akışlarını kendi arayüzlerinde yönetmesini sağlar.

Bu araç seti, Ajax videoyu uygulamalarına gömmesi ve kararlı video akışı sağlaması gereken yazılım geliştiricileri için tasarlanmıştır.

Genel bakış

Ajax Video SDK, geliştiricilerin Ajax video cihazlarından canlı ve kayıtlı videoyu akış olarak iletmesini sağlar. İki katmanlı bir mimari kullanır:

• REST API — kimlik doğrulama yapmak ve kaynakları (space'ler, video cihazları, kanallar ve video token'ları) almak için kullanılır.

• gRPC SDK — REST API'den elde edilen token'larla video akışlarını başlatmak ve kontrol etmek için kullanılır.

Ajax Video SDK, video akışını yöneten yerel bir gRPC servisi başlatır. Uygulama, video akışlarını başlatmak ve kontrol etmek için bu servise bağlanır ve uyumlu bir oynatıcıda video oynatmak için kullanılabilen bir RTSP URI alır.

Başlıca özellikler

Ajax Video SDK aşağıdaki özellikleri sağlar:

1. RTSP üzerinden canlı video akışı.

2. RTSP üzerinden arşiv oynatma.

3. Arşiv kontrolü:

   • zaman aralığı seçme,

   • belirli bir tarih ve saate gitme,

   • arşivde takvim kullanarak gezinme (istemci taraflı gezinme),

   • seçilen aralık için meta verileri alma, zaman çizelgesi ve algılamalar dahil.

4. Akış kalitesi seçimi (MAIN/SUB).

Ajax Video SDK yapısı

Ajax Video SDK arşivi, SDK kütüphanesini, gRPC API'yi tanımlayan .proto dosyalarını ve SDK işlevselliğini test etmek ve kullanımına pratik bir örnek sağlamak için kullanılabilen kaynak kodlu C++ demo uygulamalarını içerir.

Sistem gereklilikleri

Ajax Video SDK, C/C++ ile uygulanmıştır ve doğrudan C++ uygulamalarına entegre edilebilir.

Araç seti, gRPC'yi destekleyen herhangi bir programlama dili ile de kullanılabilir: SDK'yı yerel bir servis olarak çalıştırmak ve gRPC üzerinden bağlanmak gerekir.

Entegrasyon akışı

Ajax Video SDK'ya erişmek için talep formunu doldurun. Ajax ekibi sizinle iletişime geçer ve işletim sisteminiz için SDK dosyalarını içeren bir arşiv sağlar.

Ajax Video SDK'yı kullanmaya başlamak için:

1. Desteklenen yöntemlerden birini kullanarak kimlik doğrulaması yapın.

2. Gerekli space'i bulun.

3. Ajax API üzerinden gerekli edge ve kanal kimliklerini alın. Space içindeki tüm cihazların listesini talep edebilir ve kanalı adına göre belirleyebilirsiniz.

4. Hesabınızın seçilen kanala erişmek için gerekli izinlere sahip olduğundan emin olun. Video akışı yalnızca kullanıcının veya şirketin erişimi olan kanallar için kullanılabilir.

5. Gerekli edge ve kanal kimliklerini kullanarak video oynatıcı erişim token'ı oluşturun.

6. Yerel bir gRPC sunucusu başlatmak için SDK'yı başlatın.

7. Oluşturulan video token'ını kullanarak bir gRPC akışı (LiveStreaming veya ArchiveStreaming) açın.

8. SDK'dan bir RTSP URI alın ve uyumlu bir oynatıcıda video oynatmak için kullanın.

9. Süre dolmadan önce oturumu ve video token'larını yenileyerek oturumu sürdürün.

Kimlik doğrulama yöntemleri

Ajax Video SDK iki kimlik doğrulama yöntemini destekler:

• Kullanıcı kimlik doğrulaması — oturum açmayı gerektirir ve bir oturum token'ı ile bir yenileme token'ı sağlar.

• Şirket token'ı — önceden verilmiş bir token kullanarak oturum açmadan erişime izin verir.

Video akışlarına erişim, kimliği doğrulanmış kullanıcı veya şirket ile ilişkili izinlere bağlıdır. İzinler Ajax Cloud tarafında doğrulanır. Kullanıcı veya şirket belirli bir kanala erişime sahip değilse akış alınamaz.

Kimlik doğrulama yöntemi, API isteklerinin nasıl yetkilendirildiğini ve hangi uç noktaların kullanıldığını tanımlar.

Token yönetimi

Ajax Video SDK'da kullanılan token'ların kullanım süresi sınırlıdır ve yenilenmesi gerekir:

• Oturum token'ı — periyodik olarak (yaklaşık her 30 dakika) yenilenmelidir.

• Video token'ı — aktif bir akış sırasında gRPC bağlantısı üzerinden yenilenmelidir.

Token'ların yenilenmemesi, video akışının kesintiye uğramasına neden olabilir.

Video akış süreci

Video akış süreci aşağıdaki gibidir:

App → REST API → SDK (gRPC) → RTSP → Video oynatıcı.

Ajax Video SDK, Ajax Hizmetleri ile iletişimi yönetir ve yerel bir akış uç noktası sağlar, uygulama ise oynatmadan sorumludur.

Eş zamanlı video akışlarının sayısı sınırlıdır: kullanıcı başına en fazla 16 akış ve kamera başına en fazla 2 akış.