Geliştirici Rehberi

Web Uygulamaları İçin
WebRTC Sesli Sohbet
API ve SDK Entegrasyonu

Kendi uygulamanıza ya da oyununuza yüksek kaliteli, düşük gecikmeli sesli görüşme eklemek için Amerika'yı yeniden keşfetmeyin. Gabble'ın WebRTC altyapısını birkaç satır kodla entegre edin.

Node.js SDK

Browser SDK

REST API

WebSocket

WebRTC ile Sesli Görüşme: Temel Kavramlar

WebRTC (Web Real-Time Communication), tarayıcılar arasında plugin veya ek yazılım gerektirmeden peer-to-peer ses, video ve veri iletişimi sağlayan açık standarttır. Google, Mozilla ve Opera tarafından desteklenen bu teknoloji, günümüzde tüm modern tarayıcılarda yerleşik olarak bulunur.

Ancak sıfırdan bir WebRTC ile sesli görüşme altyapısı kurmak; STUN/TURN sunucu yönetimi, sinyal sunucusu geliştirme, codec optimizasyonu ve ölçeklendirme gibi ciddi operasyonel yük getirir. Gabble API, bu karmaşıklığı tek bir entegrasyon katmanının arkasına gizler.

3 Adımda Entegrasyon

Sunucu Tarafı: Token Üretin

Sunucunuzdan güvenli API anahtarıyla kullanıcıya özel oturum tokeni alın. Token asla istemci tarafına gömülmez.

server.js — Node.js

// 1. Adım: Sunucu tarafında Token üretimi (Node.js)
const axios = require('axios');

async function getGabbleToken(userId, roomId) {
  const response = await axios.post('https://api.gabble.tr/v1/tokens', {
    user_id: userId,
    room_id: roomId,
    expires_in: 3600,       // saniye cinsinden
    permissions: ['speak', 'listen']
  }, {
    headers: { 'X-API-Key': process.env.GABBLE_SECRET }
  });
  return response.data.token;
}
                    

İstemci Tarafı: SDK ile Bağlanın

Kullanıcı tarayıcısında Gabble Browser SDK'sı tokeni kullanarak ses kanalına bağlanır.

client.js — Browser

// 2. Adım: Tarayıcı tabanlı sesli sohbet bağlantısı
import { GabbleClient } from '@gabble/browser-sdk';

const client = new GabbleClient();

// Sunucudan alınan tokeni kullan
await client.connect({
  token: sessionToken,       // sunucudan gelen
  audio: { echoCancellation: true, noiseSuppression: true }
});

// Olayları dinle
client.on('participant:joined', (user) => {
  console.log(`${user.name} odaya katıldı`);
});

client.on('speaking', (userId, isSpeaking) => {
  // UI'da konuşma göstergesi güncelle
  updateSpeakingIndicator(userId, isSpeaking);
});
                    

Oda Yönetimi ve Ölçeklendirme

REST API üzerinden oda oluşturma, silme ve katılımcı yönetimi otomatikleştirilebilir.

rooms.js — Oda yönetimi

// 3. Adım: Web tabanlı sesli sohbet hosting — oda oluşturma
const room = await gabble.rooms.create({
  name: 'genel-sesli',
  maxParticipants: 50,
  region: 'tr',               // Türkiye sunucusu
  audioQuality: 'high',       // Opus 48kHz
  recordingEnabled: false
});

console.log(room.id);  // "rm_abc123xyz"
                    

Anlık Sesli Sohbet SDK Özellikleri

Gabble'ın anlık sesli sohbet SDK'sı, geliştiricilere sıfırdan WebRTC sunucu zinciri kurma yükünden kurtarırken tam kontrol sunar:

Adaptif Gürültü Bastırma

AI destekli arka plan gürültüsü filtrelemesi. Oyun sesleri, klavye ve fan gürültüsü otomatik bastırılır.

Otomatik Codec Seçimi

Bağlantı kalitesine göre Opus codec ayarları dinamik olarak değişir. Düşük bant genişliğinde bile ses kesilmez.

Düşük Ping Ses Yayını

Türkiye'deki kullanıcılar için ortalama 40–60ms gecikme. WebRTC ses yayını düşük ping için optimize TURN/STUN altyapısı.

Spatial Audio

3D uzamsal ses. Oyun koordinatlarına göre sağ-sol-uzaklık bilgisi WebAudio API ile işlenir.

REST API Uç Noktaları

Gabble API, RESTful tasarım prensipleriyle inşa edilmiştir. Tüm uç noktalar JSON döner ve Bearer token kimlik doğrulaması kullanır.

Method	Endpoint	Açıklama
POST	`/v1/tokens`	Kullanıcı oturum tokeni oluştur
POST	`/v1/rooms`	Yeni ses odası oluştur
GET	`/v1/rooms/{id}`	Oda bilgilerini getir
GET	`/v1/rooms/{id}/participants`	Aktif katılımcıları listele
DELETE	`/v1/rooms/{id}/participants/{uid}`	Kullanıcıyı odadan at
GET	`/v1/usage`	Kullanım istatistikleri

Node.js Sesli Sohbet Sistemi: Ölçeklendirme Rehberi

Bir Node.js sesli sohbet sistemi inşa ederken en kritik karar, ses trafiğini kendi sunucunuzdan mı geçireceğiniz yoksa bir SFU/MCU altyapısına mı devredeceğinizdir. Gabble bu kararı sizin yerinize alır:

Küçük odalar (2–10 kişi) için peer-to-peer mesh topolojisi tercih edilir; sunucu yükü minimaldır. Büyük odalar (10+ kişi) için Gabble'ın SFU (Selective Forwarding Unit) altyapısı devreye girerek her katılımcının yalnızca ihtiyaç duyduğu ses akışlarını almasını sağlar. Bu sayede web tabanlı sesli sohbet hosting maliyetleri düşer, performans artar.

Sık Sorulan Sorular

WebRTC ses yayınında düşük ping nasıl sağlanır?

Gecikme; STUN/TURN sunucu lokasyonu, codec seçimi ve ağ kalitesine bağlıdır. Gabble, Türkiye'ye yakın bölgelerde TURN sunucuları çalıştırır. SDK, ağ koşullarını sürekli ölçer ve en düşük gecikmeli yolu otomatik seçer. Ortalama 40–60ms elde edilir.

Tarayıcı tabanlı sesli mesajlaşma scripti mobilde çalışır mı?

Evet. WebRTC, Android Chrome 60+ ve Safari iOS 11+ sürümlerinden itibaren desteklenir. Gabble SDK, mobil tarayıcı kısıtlamalarını (ses bağlamı unlock, arka plan kısıtlamaları) otomatik yönetir.

Kullandıkça öde modeli nasıl çalışır?

Faturalandırma saniye bazındadır. Oda içinde aktif ses iletimi yapılan süre hesaplanır. Boştaki bağlantılar için ücret alınmaz. Aylık ücretsiz kota aşıldığında otomatik faturalandırma başlar.

Web üzerinden sesli görüşme entegrasyonu için hangi portlar açılmalı?

WebRTC DTLS/SRTP üzerinden çalışır, UDP 3478 (STUN) ve TCP 443 (TURN over TLS) gereklidir. Gabble ayrıca güvenlik duvarı kısıtlamalı ortamlar için port 443 üzerinden tam TURN desteği sunar.

API Anahtarı Al

Ücretsiz geliştirici hesabıyla dakikalar içinde entegrasyona başlayın.

Hesap Oluştur

Dokümantasyon

Tüm SDK referansları, webhook rehberleri ve örnek projeler.

API Dokümanına Git →

npm Paketi

npm install @gabble/browser-sdk

İlgili Sayfalar

→ FiveM Ses Sistemi → Ücretsiz Sesli Sohbet Odası → Gecikme Sorunları ve Çözümleri

Rehberler & Kaynaklar

FiveM

Web Uygulamaları İçin
WebRTC Sesli Sohbet
API ve SDK Entegrasyonu

WebRTC ile Sesli Görüşme: Temel Kavramlar

3 Adımda Entegrasyon

Sunucu Tarafı: Token Üretin

İstemci Tarafı: SDK ile Bağlanın

Oda Yönetimi ve Ölçeklendirme

Anlık Sesli Sohbet SDK Özellikleri

Adaptif Gürültü Bastırma

Otomatik Codec Seçimi

Düşük Ping Ses Yayını

Spatial Audio

REST API Uç Noktaları

Node.js Sesli Sohbet Sistemi: Ölçeklendirme Rehberi

Sık Sorulan Sorular

API Anahtarı Al

Dokümantasyon

npm Paketi

Uygulamanıza Ses Ekleyin

FiveM Ses Sistemi Kurulumu

WebRTC API & SDK Rehberi

Üyeliksiz Sesli Sohbet Odası

Web Uygulamaları İçinWebRTC Sesli SohbetAPI ve SDK Entegrasyonu

WebRTC ile Sesli Görüşme: Temel Kavramlar

3 Adımda Entegrasyon

Sunucu Tarafı: Token Üretin

İstemci Tarafı: SDK ile Bağlanın

Oda Yönetimi ve Ölçeklendirme

Anlık Sesli Sohbet SDK Özellikleri

Adaptif Gürültü Bastırma

Otomatik Codec Seçimi

Düşük Ping Ses Yayını

Spatial Audio

REST API Uç Noktaları

Node.js Sesli Sohbet Sistemi: Ölçeklendirme Rehberi

Sık Sorulan Sorular

API Anahtarı Al

Dokümantasyon

npm Paketi

Uygulamanıza Ses Ekleyin

FiveM Ses Sistemi Kurulumu

WebRTC API & SDK Rehberi

Üyeliksiz Sesli Sohbet Odası

Web Uygulamaları İçin
WebRTC Sesli Sohbet
API ve SDK Entegrasyonu