ECV Video Görüşme iOS SDK [TR]

Zeynep Baysun tarafından oluşturuldu, 12 Haziran 2025

ECV Video Call iOS SDK

İçindekiler

• ECV Video Call iOS SDK
  • Giriş
  • Temel Özellikler
  • Başlarken
    • Ön Koşullar
    • 1. Gerekli Framework'leri Ekleyin
    • 2. Demo Uygulamasını Keşfedin
    • 3. Temel SDK Başlatma (Kavramsal)
  • Temel Kavramlar
  • Demo Uygulama Akışı
  • Sonraki Adımlar
• Kullanım Kılavuzu
  • SDK Başlatma
    • Temel Başlatma
    • Yapılandırma Seçenekleri
    • Ekstra Ayarlar
  • Görüşme Oluşturma ve Yönetme
    • Görüşme Oluşturma
    • VideoCall Olayları
    • VideoCall Parametreleri
    • VideoCall'u Başlatma
    • Bir Temsilcinin Bağlanmasını Bekleme (Kuyrukta)
      • ECV 1.75'te
        • Bir temsilcinin bağlanmasını beklemenin iki basit yolu vardır
      • ECV 1.5'te
        • Temsilciyi bekleme işlemi manuel olarak yönetilmelidir
    • VideoCall'u Bağlama
  • Görüntülü Görüşme Arayüzü
    • Video Görünümlerini Ayarlama
    • Görüşme Kontrolleri
  • Görüntülü Görüşme Olay Yönetimi
  • Hata Yönetimi
  • İzin Yönetimi
  • En İyi Uygulamalar
• Yapılandırma Kılavuzu
  • SDK Yapılandırması
    • Temel Yapılandırma
    • Gerekli Parametreler
    • Opsiyonel Parametreler
  • Görüşme Yapılandırması
    • Temel Görüşme Yapılandırması
    • Opsiyonel DialCallParameters Parametreleri
  • WebRTC Bağlantı Parametreleri
    • DataChannelConfig
    • Özellikler
    • Başlatıcı
• Demo Uygulama Kılavuzu
  • Genel Bakış
  • Uygulama Mimarisi
    • Temel Bileşenler
    • Temel Özellikler
  • Başlarken
    • Ön Koşullar
    • Kurulum Süreci
  • Uygulama Akışı
  • Kod Yapısı
    • Temel Dosyalar
  • En İyi Uygulamalar
  • Sorun Giderme
  • SDK Entegrasyonu ve Teknik Detaylar
    • Temel Yapılandırma ve Derleme Sistemi
    • Ekran Bazında SDK Entegrasyonu
    • SDK Sürüm Uyumluluğu
    • Olay Yönetim Sistemi
    • SDK Entegrasyonu için En İyi Uygulamalar
  • Sonuç
• Olaylar ve Durum Yönetimi
  • Giriş
  • Olaylara Abone Olma
  • Olay Yapısı (VideoCallEvent)
  • Olay Tipi Referansı (VideoCallEventType)
    • Aşama 1: Başlatma & Arama
    • Aşama 2: Kuyruk & Temsilci Bağlantısı
    • Aşama 3: WebRTC Bağlantı Kurulumu
    • Aşama 4: Aktif Görüşme & Medya
    • Aşama 5: Görüşme Sonlandırma
  • Durum Özellikleri
• Özelleştirme Kılavuzu
  • Giriş
  • 1. Arayüz Uygulaması
  • 2. Yapılandırma (ECVSdkConfiguration)
  • 3. Görüşme Verisi (DialCallParameters)
  • 4. Olay Yönetim Mantığı
  • 5. Gelişmiş Özelleştirme (Opsiyonel)
  • 6. İzinler
• Sorun Giderme Kılavuzu
  • Yaygın Sorunlar & Çözümler
    • Derleme & Bağımlılık Hataları
    • Çalışma Zamanı Çöküşleri
    • Medya Kalite Sorunları
    • Belirli Özellik Sorunları
  • Genel Hata Ayıklama Adımları
  • Destek ile İletişime Geçme

Giriş

ECV Video Call iOS SDK'ye hoş geldiniz! Bu SDK, iOS uygulamalarınıza gerçek zamanlı görüntülü görüşme işlevselliğini sorunsuz bir şekilde entegre etmenizi sağlar. Sinyalleşme, WebRTC eş bağlantıları, medya akışları ve görüşme durumu yönetimi gibi karmaşıklıkları sizin yerinize yönetir, böylece siz uygulamanızın kullanıcı arayüzüne ve iş mantığına odaklanabilirsiniz.

Bu depo şunları içerir:

1. SDK: Önceden derlenmiş bir iOS Framework'ü (.framework dosyası) olarak sunulur. Bunu projenize bağımlılık olarak ekleyeceksiniz.
2. Demo Uygulaması: SDK özelliklerinin nasıl kullanılacağını gösteren bir demo uygulamasının (ECV175_iOS_DEMO) tam kaynak kodu. Bu demo, referans ve örnek amaçlıdır, üretim için hazır bir arayüz kodu değildir.

Temel Özellikler

• ECV arka uç servislerine (v1.5 ve v1.75+) bağlantı kurar
• WebRTC kurulumunu ve eşler arası bağlantıyı yönetir
• Yerel ve uzaktaki video/ses akışlarını yönetir
• Sesi ve videoyu sessize alma/açma kontrolleri sağlar
• Kamera değiştirmeyi destekler
• Görüşme yaşam döngüsü olaylarını yönetir (arama, kuyruk, bağlı, bekletme, sonlandırma)
• Yapılandırılabilir ortamlar ve görüşme parametreleri sunar

Başlarken

Ön Koşullar

• Xcode (En Son Kararlı Sürüm Önerilir)
• Temel iOS geliştirme bilgisi (Swift)
• Minimum iOS Sürümü: 13.0
• Hedef iOS Sürümü: 17.0

1. Gerekli Framework'leri Ekleyin

Uygulamanızın ECV SDK framework'ünü ve gerekli bağımlılıklarını (WebRTC) içermesi gerekir. Bunları .framework dosyaları olarak alacaksınız.

1. Gerekli Framework Dosyaları:

   • ECV SDK: (ör. ECV175_iOS_SDK.xcframework)
   • WebRTC: WebRTC.xcframework

2. Framework'leri projenize ekleyin:

   • Framework dosyalarını Xcode projenize sürükleyip bırakın
   • "Gerekirse öğeleri kopyala" seçeneğinin işaretli olduğundan emin olun
   • Hedefinizin "Frameworks, Libraries, and Embedded Content" bölümüne ekleyin
   • Her framework için "Embed & Sign" ayarını yapın

3. Proje Derleme Ayarlarında:

   • "Enable Bitcode" seçeneğini Hayır olarak ayarlayın
   • Framework arama yollarına framework'leri ekleyin
   • "Build Active Architecture Only" ayarını ihtiyacınıza göre yapılandırın

2. Demo Uygulamasını Keşfedin

Dahil edilen demo uygulaması (ECV175_iOS_DEMO), SDK entegrasyonunun pratik bir örneğini sunar.

1. ECV175_iOS_DEMO.xcodeproj dosyasını Xcode'da açın
2. Demo uygulamasını bir simülatörde veya gerçek cihazda derleyip çalıştırın
3. Özellikle UI dizinindeki dosyaları ve AppState.swift dosyasını inceleyerek SDK bileşenlerinin nasıl başlatıldığını ve kullanıldığını anlayın

3. Temel SDK Başlatma (Kavramsal)

// AppDelegate'inizde veya merkezi bir yönetim nesnesinde bir yerde
import ECV175_iOS_SDK

// 1. SDK Yapılandırmasını Tanımlayın (Detaylar için Yapılandırma bölümüne bakın) let sdkConfig = ECVSdkConfiguration( name: "Ortam_Adi", // Uygulamanıza veya arka ucunuza referans veren herhangi bir ad serviceUrl: "SERVIS_URLINIZ", // Gerçek servis URL'niz ile değiştirin useQueueSocket: true // veya false, arka uç sürümünüze göre ayarlayın (1.75+ için true, 1.5 için false) // İsteğe bağlı olarak webrtcUrl, signalingUrl vb. geçersiz kılınabilir )

// 2. SDK Örneğini Başlatın // Tek bir örneğin merkezi olarak yönetilmesi önerilir let ecvSdk = ECVSdk(config: sdkConfig)

// Bu örneği uygulamanız genelinde erişim için saklayın (ör. AppDelegate, DI, Singleton) // Örnek: MyApp.sdkInstance = ecvSdk

Temel Kavramlar

• ECVSdk: SDK ile etkileşimde bulunmak için ana giriş noktasıdır. Görüşme oluşturmak ve genel ayarlara/modüllere erişmek için kullanılır.
• ECVSdkConfiguration: SDK için arka uç URL'lerini ve bağlantı parametrelerini tanımlar.
• VideoCall: Tek bir görüntülü görüşme oturumunu temsil eder. Görüşme durumunu, olaylarını ve bağlantı detaylarını yönetir.
• WebRtcConnection: Temel WebRTC eş bağlantısını, medya akışlarını ve render işlemlerini yönetir. VideoCall.connect() ile erişilir.
• Olaylar: SDK, uygulamanıza görüşme durumu değişiklikleri, hatalar ve medya olayları hakkında bildirimde bulunmak için bir delege sistemi kullanır (VideoCallEvent).
• Renderers (RTCMTLVideoView): Yerel ve uzaktaki videoyu göstermek için kullanılan standart WebRTC görünümleridir. Yaşam döngülerini yönetmeli ve WebRtcConnection ile ilişkilendirmelisiniz.

Demo Uygulama Akışı

Demo uygulaması şu temel akışı izler:

1. EnvironmentsScreen: Arka uç bağlantı yapılandırmalarının (Servis URL'si vb.) seçilmesini veya tanımlanmasını sağlar. Bu ekran gösterim amaçlıdır; uygulamanızda genellikle sabit bir yapılandırma olur veya dinamik olarak alınır.
2. MainScreen: Gerekli görüşme bilgilerini toplar (ör. arayan adı, özellikler), izinleri ister (Kamera, Mikrofon) ve sdk.createCall() ile görüşmeyi başlatır.
3. QueueScreen: Bir temsilciye bağlanana kadar bekleme durumunu gösterir. AgentConnected veya Error/Hangup olaylarını dinler.
4. CallScreen: Ana görüntülü görüşme arayüzüdür. Yerel ve uzaktaki video için RTCMTLVideoView'ları yönetir, görüşme kontrollerini (sessize alma, kamera değiştirme, kapatma) gösterir ve SDK olaylarına göre arayüzü günceller.

Sonraki Adımlar

• Başlarken bölümündeki adımları izleyerek SDK ve demo uygulamasını kurun.
• SDK'nın temel bileşenlerini ayrıntılı olarak anlamak için Kullanım Kılavuzu'nu okuyun.
• Demo uygulamasının kaynak kodunu incelerken Demo Uygulama Kılavuzu'na başvurun.

Kullanım Kılavuzu

Bu belge, ECV Video Call iOS SDK'sını uygulamanızda kullanmaya dair ayrıntılı bilgiler sunar.

SDK Başlatma

Temel Başlatma

import ECV175_iOS_SDK

// SDK yapılandırmasını oluşturun let config = ECVSdkConfiguration( name: "Ortam_Adi", // Uygulamanıza veya arka ucunuza referans veren herhangi bir ad serviceUrl: "SERVIS_URLINIZ", useQueueSocket: true // veya arka uç sürümünüze göre false (false: 1.5, true veya false: 1.75) )

// SDK örneğini başlatın letnlet sdk = ECVSdk(config: config)

Yapılandırma Seçenekleri

ECVSdkConfiguration sınıfı çeşitli yapılandırma seçeneklerini destekler:

let config = ECVSdkConfiguration(
    name: "Ortam_Adi",
    serviceUrl: "SERVIS_URLINIZ",
    useQueueSocket: true,
    webrtcUrl: "WEBRTC_URLINIZ", // Opsiyonel, varsayılan: serviceUrl
    signalingUrl: "SIGNALING_URLINIZ", // Opsiyonel, varsayılan: serviceUrl
    waitForRoomIntervalDelay: Int, // Opsiyonel (Sadece 1.5 için), varsayılan: 3000
    waitForRoomIntervalEndpoint: String // Opsiyonel (Sadece 1.5 için), varsayılan: "serviceUrl + API.waitForRoomInterval + \"?rtcId=\""
)

Ekstra Ayarlar

Logger.setLevel(logLevel: .debug) // .debug: SDK'daki tüm logları görmek için (.debug, .info, .warn, .error) // varsayılan: .info

Görüşme Oluşturma ve Yönetme

Görüşme Oluşturma

// Görüntülü görüşmeyi oluştur ve başlat
let call = await sdk.createVideoCall()

Eğer zaten bir rtcId'niz varsa, bunu createVideoCall fonksiyonuna verebilirsiniz, aksi takdirde otomatik olarak backend tarafından oluşturulur (varsayılan)

let call = await sdk.createVideoCall(rtcId: "rtcId'niz")

VideoCall Olayları

Görüşmeyi başlatmadan önce olaya dinleyici ekleyebilirsiniz

sdk.modules.onCallEvent.append { (videoCall: VideoCall, newEvent: VideoCallEvent, lastEvent: VideoCallEvent) in
    if(videoCall.rtcId != call.rtcId){
        return // Sadece mevcut görüşmeye ait olayları yakalamak için. // Tüm görüşmelerin olaylarını yakalamak için bu satırı yoruma alın
    }

if(newEvent.type == .AgentConnected) {
    Logger.info("sdk.modules.onCallEvent'ten: \(newEvent.type)")
}
else if(newEvent.type == .Error){
    Logger.error("sdk.modules.onCallEvent'ten: \(newEvent.detail ?? "")")
}
else {
    Logger.info("sdk.modules.onCallEvent'ten: \(newEvent)")
}

}

VideoCall Parametreleri

Görüşmeyi başlatmak için bir DialCallParameters nesnesi hazırlamamız gerekir

let dialCallParameters = DialCallParameters(
    callerName: "Arayan_Adi",      // Opsiyonel ama verilmesi önerilir, verilmezse rastgele bir ad oluşturulur
    attributes: [String: String],   // Opsiyonel, görüşmeye veri ekleyin
    queue: String?,                 // Opsiyonel, kuyruk adı, verilmezse sistemin varsayılan kuyruğu kullanılır
    // Gelişmiş Opsiyonel Parametreler
    acdAttributes: [String: String],
    customPayload: [String: String],
    additionalHeaders: [String: String],
)

Örnek:

let dialCallParameters = DialCallParameters(
    callerName: "John Doe",
    attributes: [
        "department": "destek",
        "priority": "yüksek"
    ],
    queue: "TeknikDestek",
)

VideoCall'u Başlatma

Bir VideoCall başlatmak için call.start kullanılır

await call.start(dialCallParameters: dialCallParameters)

Bir Temsilcinin Bağlanmasını Bekleme (Kuyrukta)

Bir temsilcinin bağlanmasını beklemenin iki basit yolu vardır

1- (1.5 ve 1.75+) Daha önce uyguladığımız VideoCall olaylarını kullanmak if(newEvent.type == .AgentConnected)

2- (Sadece 1.75+) Awaited, promise tabanlı görev kullanmak:

let isAgentConnected = await call.agentConnected?.value
Logger.info("isAgentConnected: \(String(describing: isAgentConnected))")

if(isAgentConnected == true) { // Geliştirme için görüşmeyi ayrı bir web tarayıcısında açmak için ifinif let urlString = call.getUrl(), let url = URL(string: urlString) { UIApplication.shared.open(url, options: [:], completionHandler: nil) } else { Logger.error("URL açılamadı: geçersiz URL string") } } else { Logger.warn("Temsilci bağlanmadı!")}

VideoCall'u Bağlama

1- videoCall.connect() kullanarak

CallScreen.swift dosyanızda

func setup() {
  Task {
      guard let rtcId = self.rtcId else {
          self.callError = "RtcId başlatılmadı"
          Logger.error("Kurulum başarısız: RtcId nil")
          return
      }

  if let videoCall = appState.sdk?.getVideoCall(rtcId: rtcId){
      self.videoCall = videoCall
  }
  else {
      self.videoCall = await appState.sdk?.createVideoCall(rtcId: rtcId)
  }
  
  // Olayları yönet
  let ECVModules = appState.sdk?.modules
  ECVModules?.onCallEvent.append { (videoCall: VideoCall, newEvent: VideoCallEvent, lastEvent: VideoCallEvent) in
      if(self.videoCall?.rtcId != videoCall.rtcId){
          return // Sadece mevcut görüşmeye ait olayları yakalamak için. // Tüm görüşmelerin olaylarını yakalamak için bu satırı yoruma alın
      }
      
      if(newEvent.type == .CallEnded){
          ECVModules?.onCallEvent = [] // Olayları sıfırla, taşmayı önle
          path.append(NavigationRoute.mainScreen)
      }
  }

  guard let webRtcConnection = self.videoCall?.connect() else {
      self.callError = "WebRtcConnection bağlantı kurulamadı"
      Logger.error("Kurulum başarısız: WebRtcConnection nil")
      return
  }
  self.webRtcConnection = webRtcConnection

  Logger.debug("Renderer'lar başlatılıyor ve atanıyor...")
  let local = Renderer()
  let remote = Renderer()

  webRtcConnection.localVideoRenderer = local
  webRtcConnection.remoteVideoRenderer = remote

  self.localRenderer = local
  self.remoteRenderer = remote

  Logger.info("WebRTC odası başlatılıyor...")
  await webRtcConnection.startRoom()
  Logger.info("Görüşme kurulumu tamamlandı.")

}}

2- Ya da çağrıcı, görüntülü görüşmeye web tarayıcısı ile katılabilir (önerilmez / geliştirme için faydalı)

if let urlString = call.getUrl(), let url = URL(string: urlString) {
    UIApplication.shared.open(url, options: [:], completionHandler: nil)
}
else {
    Logger.error("URL açılamadı: geçersiz URL string")
}

Görüntülü Görüşme Arayüzü

Video Görünümlerini Ayarlama

import Foundation
import SwiftUI
import Combine
import ECV175_iOS_SDK
import WebRTC

struct CallScreen: View { let rtcId: String? @EnvironmentObject var appState: AppState

@Binding var path: NavigationPath

@State private var videoCall: VideoCall?
@State private var webRtcConnection: WebRtcConnection?

@State private var localRenderer: Renderer?
@State private var remoteRenderer: Renderer?

let localStreamWidth: CGFloat = 80
let localStreamHeight: CGFloat = 120
let margin: CGFloat = 10
let pipBottomPadding: CGFloat = 70

var body: some View {
    ZStack {
        Color.black.ignoresSafeArea()

        WebRtcVideoView(renderer: remoteRenderer).ignoresSafeArea()

        WebRtcVideoView(renderer: localRenderer)
            .frame(width: localStreamWidth, height: localStreamHeight)
            .cornerRadius(8)
            .overlay(
                RoundedRectangle(cornerRadius: 8)
                    .stroke(Color.white.opacity(0.5), lineWidth: 1)
            )
            .padding(.trailing, margin)
            .padding(.bottom, margin + pipBottomPadding)

        // ... Görüşme Butonları
    }
    .navigationBarHidden(true)
    .statusBar(hidden: true)
    .onAppear(perform: setup)
    .onDisappear {
        hangup(by: "onDisappear")
    }
}

// MARK: - Video Renderer SwiftUI Wrapper

struct WebRtcVideoView: UIViewRepresentable {
    let renderer: (any RTCVideoRenderer)?

    func makeUIView(context: Context) ->> UIView {
        if let renderer = renderer as? Renderer {
            return renderer.view
        } else if let renderer = renderer as? Renderer {
            return renderer.view
        } else {
            return UIView()
        }
    }

    func updateUIView(_ uiView: UIView, context: Context) {}
}

// MARK: - Özel Renderer Sınıfları

class Renderer: NSObject, RTCVideoRenderer {
    let view: RTCMTLVideoView

    override init() {
        self.view = RTCMTLVideoView()
        self.view.videoContentMode = .scaleAspectFill
        super.init()
        Logger.debug("Renderer oluşturuldu")
    }

    deinit { Logger.debug("Renderer yok edildi") }

    func setSize(_ size: CGSize) {
        view.setSize(size)
    }

    func renderFrame(_ frame: RTCVideoFrame?) {
        view.renderFrame(frame)
    }
}

func hangup(by: String = "HangUpButton") {
    Logger.debug("Kapatma isteği: \(by)")

    videoCall?.hangup()

    videoCall = nil
    webRtcConnection = nil
    localRenderer = nil
    remoteRenderer = nil
}

// func setup(){
// ... buraya yapıştırın
//}

}

Görüşme Kontrolleri

// Sesi Sessize Al / Aç
webRtcConnection.setAudioEnabled(state: false) // Sessize al
webRtcConnection.setAudioEnabled(state: true)  // Sesi aç

// Videoyu Aç / Kapat webRtcConnection.setVideoEnabled(state: false) // Videoyu kapat webRtcConnection.setVideoEnabled(state: true) // Videoyu aç

// Kamera Değiştir try await webRtcConnection.switchCamera()

// Feneri Aç / Kapat webRtcConnection.setFlashlightEnabled(state: true) webRtcConnection.setFlashlightEnabled(state: false)

// Görüşmeyi Sonlandır videoCall.rvideoCall.hangup()

Görüntülü Görüşme Olay Yönetimi

Bir olay sdk.modules.onCallEvent içinde tetiklendiğinde, newEvent bir VideoCallEvent'tir ve newEvent.type bir VideoCallEventType'dır.

sdk.modules.onCallEvent.append { (videoCall: VideoCall, newEvent: VideoCallEvent, lastEvent: VideoCallEvent) in
    if(videoCall.rtcId != call.rtcId){
        return // Sadece mevcut görüşmeye ait olayları yakalamak için. // Tüm görüşmelerin olaylarını yakalamak için bu satırı yoruma alın
    }

if(newEvent.type == .DialSuccess){
    Logger.debug("sdk.modules.onCallEvent'ten: \(newEvent.detail ?? "")")
}
else if(newEvent.type == .CallEnded){
    // burada işle
}
//else if(){

//}

}

Her tip kendi içinde açıklayıcıdır:

public enum VideoCallEventType {
    case None
    case Init
    case GotRtcId
    case DialSuccess
    case Error
    case OnQueue
    case AgentConnected
    case CallEnded
    case SignalingConnected

case GotLocalStream
case GotRemoteStream

case JoinedRoom
case SignalingRegistered
case RtcPeerConnectionCreated

case GotOffer
case SentOffer
case GotAnswer
case SentAnswer

case AudioMuted
case AudioUnmuted
case VideoMuted
case VideoUnmuted

case RemoteAudioMuted
case RemoteAudioUnmuted
case RemoteVideoMuted
case RemoteVideoUnmuted

case StartHold
case EndHold

case TakePhotoOn
case TakePhotoOff

case WebRtcOnDataChannel
case TextChannelConnected
case TextChannelMessage
case ConnectionTimeoutStart
case ConnectionTimeoutEnd
case WebRtcConnected
case WebRtcRenegotiationNeeded

case WebRtcDisconnected
case WebRtcFailed
case Hangup

case FlashOn
case FlashOff

case TransferPending
case TransferCancelled
case TransferCompleted

}

Hata Yönetimi

Hataları daha hassas şekilde yönetmek için, bir hata oluştuğunda .onCallEvent altında videoCall.lastError'ı kontrol edebilirsiniz.

sdk.modules.onCallEvent.append { (videoCall: VideoCall, newEvent: VideoCallEvent, lastEvent: VideoCallEvent) in
    if(videoCall.rtcId != call.rtcId){
        return // Sadece mevcut görüşmeye ait olayları yakalamak için. // Tüm görüşmelerin olaylarını yakalamak için bu satırı yoruma alın
    }

if(newEvent.type == .Error){
    Logger.error("sdk.modules.onCallEvent'ten: \(newEvent.detail ?? "")")

    Logger.error(videoCall.lastError)
}

}

videoCall.lastError'ın tipi ErrorObject'tir ve içinde şunlar bulunur:

public class ErrorObject {
    public var name: ErrorName
    public var message: String

public init(name: ErrorName = ErrorName.NO_ERROR, message: String = "Hata yok.") {
    self.name = name
    self.message = message
}

}

public enum ErrorName { case NO_ERRORNO_ERRORcase caseSERVICE_URL_REQUIREDcase SERVICE_URL_REQUIREDCALL_NOT_INITIALIZEDcase caseCALL_ALREADY_DIALEDcase CALL_NOT_INITIALIZEDQUEUE_SOCKET_CLOSEDcase caseERROR_DIALINGcase CALL_ALREADY_DIALEDCALL_NOT_DIALEDcase caseERROR_WAITING_FOR_ROOMcase QUEUE_SOCKET_CLOSEDNO_ICE_SERVERS_FOUNDcase caseHANGUP_FAILED}

Yani belirli bir hatayı kontrol edebilirsiniz:

sdk.modules.onCallEvent.append { (videoCall: VideoCall, newEvent: VideoCallEvent, lastEvent: VideoCallEvent) in
    if(videoCall.rtcId != call.rtcId){
        return // Sadece mevcut görüşmeye ait olayları yakalamak için. // Tüm görüşmelerin olaylarını yakalamak için bu satırı yoruma alın
    }

if(newEvent.type == .Error){
    Logger.error("sdk.modules.onCallEvent'ten: \(newEvent.detail ?? "")")
    Logger.error(videoCall.lastError)

    switch videoCall.lastError.name {
        case .SERVICE_URL_REQUIRED:
            break
        case .CALL_NOT_DIALED:
            break
        case .NO_ICE_SERVERS_FOUND:
            break
        // vb..
    }
}

}

İzin Yönetimi

// Kamera ve mikrofon izinlerini isteyin
AVCaptureDevice.requestAccess(for: .video) { granted in
    if granted {
        // Kamera izni verildi
    } else {
        // Kamera izni reddedildi
    }
}

AVCaptureDevice.requestAccess(for: .audio) { granted in ifinif granted { // Mikrofon izni verildi }verildi} else { // Mikrofon izni reddedildireddedildi}}

En İyi Uygulamalar

1. Tek SDK Örneği: Uygulamanızın yaşam döngüsü boyunca tek bir ECVSdk örneği bulundurun.
2. Doğru Temizlik: Görüşme sona erdiğinde kaynakları mutlaka temizleyin:
3. Hata Kurtarma: Uygun hata kurtarma mekanizmaları uygulayın:
4. Bellek Yönetimi: Retain cycle'lara dikkat edin:

weak var call: VideoCall?
weak var webRtcConnection: WebRtcConnection?

Yapılandırma Kılavuzu

Bu belge, ECV Video Call iOS SDK'da mevcut olan yapılandırma seçeneklerini detaylandırır.

SDK Yapılandırması

Temel Yapılandırma

ECVSdkConfiguration sınıfı, görüntülü görüşme örneğini yapılandırmak için kullanılır:

let config = ECVSdkConfiguration(
    name: "Ortam_Adi",
    serviceUrl: "SERVIS_URLINIZ",
)

Gerekli Parametreler

• name: String Uygulamanıza veya arka ucunuza referans veren herhangi bir ad
• serviceUrl: String ECV arka uç servisinizin temel URL'si

Opsiyonel Parametreler

• webrtcUrl: String Özel WebRTC sunucu URL'si, varsayılan: serviceUrl
• signalingUrl: String Özel sinyalleşme sunucu URL'si, varsayılan: serviceUrl
• useQueueSocket: Bool Kuyruk soketi kullanılsın mı (v1.75+ için true, v1.5 için false), varsayılan: true
• waitForRoomIntervalDelay: Integer Sadece useQueueSocket: false ise aktif/etkin olur, ECV 1.5'te, temsilcinin http isteğiyle bağlanıp bağlanmadığını kontrol etme aralığı, varsayılan: 3000
• waitForRoomIntervalEndpoint: String Sadece useQueueSocket: false ise aktif/etkin olur, ECV 1.5'te, "temsilcinin bağlanmasını bekleme" http endpoint'i, varsayılan: serviceUrl + API.waitForRoomInterval + "?rtcId="

Örnek Kullanımlar:

let configV175 = ECVSdkConfiguration(
    name: "Bir ECV 1.75 Uygulaması",
    serviceUrl: "https://prod-v175.ecv.ornek.com"
)

let configV15 = ECVSdkConfiguration( name: "Bir ECV 1.5 Uygulaması", serviceUrl: "https://prod-v15.ecv.ornek.com", useQueueSocket: false )

let configSeparateV15 = ECVSdkConfiguration( name: "Özel bir ECV 1.5 Uygulaması", serviceUrl: "https://api.ornek.com", webrtcUrl: "https://webrtc-v15.ornek.com", // /join için ayrı endpoint signalingUrl:endpointsignalingUrl: "https://websocket-v15.ornek.com", // Sinyalleşme için ayrı WebSocket sunucusu (v1.5 için geçerliyse) useQueueSocket: false, // v1.5 için gerekli waitForRoomIntervalDelay:gerekliwaitForRoomIntervalDelay: 3000, // 5 saniyede bir kontrol et waitForRoomIntervalEndpoint:etwaitForRoomIntervalEndpoint: "/ozel/pollstatus?callid=" // Özel polling endpointendpoint)

Görüşme Yapılandırması

Temel Görüşme Yapılandırması

DialCallParameters sınıfı, bireysel görüşmeleri yapılandırmak için kullanılır:

let dialCallParameters = DialCallParameters() // Zorunlu parametre yok

Opsiyonel DialCallParameters Parametreleri

• callerName: String Arayanın adı, opsiyonel ama verilmesi önerilir, verilmezse rastgele bir ad oluşturulur
• attributes: [String: String] Görüşmeye veri ekleyin
• queue: String Verilmezse sistemin varsayılan kuyruğu kullanılır
• acdAttributes: [String: String] Görüşme için ekstra özel acdAttributes (Gelişmiş Arka Uç Ayarları)
• customPayload: [String: String] Görüşme için ekstra özel payload (Gelişmiş Arka Uç Ayarları)
• additionalHeaders: [String: String] DialRequest'e eklenebilecek ekstra http başlıkları

Örnek Kullanımlar:

let dialCallParameters = DialCallParameters(
    callerName: "Jane Doe",
    attributes: [
        "hesapNumarasi": "ACC9876",
        "sonGorusme": "2023-10-26"
    ],
    queue: "DestekKuyrugu",
    additionalHeaders: ["X-Auth-Token": "kullanici_oturum_tokeni"]
)

await call.start(dialCallParameters: dialCallParameters)

WebRTC Bağlantı Parametreleri

Bu parametreler, videoCall.connect() çağrılırken isteğe bağlı olarak verilir ve WebRTC eş bağlantısının davranışını ince ayar yapmanızı sağlar. Çoğu parametrenin varsayılanı uygundur.

• Bağlantı & Sinyalleşme:
  • connectionTimeout: Int = 10000: WebRTC bağlantı denemesi için zaman aşımı (ms)
  • joinHttpConnectTimeout: Int = 3000: /join isteği için HTTP bağlantı zaman aşımı (ms)
  • joinHttpReadTimeout: Int = 3000: /join isteği için HTTP okuma zaman aşımı (ms)
  • additionalHeaders: [String: String]: /join isteğine ve WebSocket sinyalleşme bağlantısına eklenen özel HTTP başlıkları. Kimlik doğrulama token'ları için faydalı.
• Medya Kontrolü & Davranış:
  • videoCallEnabled: Boolean = true: Video izleri ayarlanacak mı. Sadece sesli görüşmeler için false yapın.
  • useSpeakerPhone: Boolean = true: Görüşme hoparlörle başlasın mı.
  • autoHandleCameraSwitch: Boolean = true: SDK'nın belirli olaylarda kamerayı otomatik değiştirmesine izin verir (ör. temsilci arka kamerayla fotoğraf isterse).
  • autoHandleHoldSideEffects: Boolean = true: Temsilci görüşmeyi beklemeye aldığında/aldığında yerel ses/video otomatik olarak sessize alınır/açılır.
• Video Yapılandırması:
  • videoWidth: Int = 480 / videoHeight: Int = 640: İstenen video çözünürlüğü.
  • videoFps: Int = 0 (Varsayılan ~30): İstenen video kare hızı.
  • videoMaxBitrate: Int = 0 (WebRTC varsayılanı): Video kodlama için maksimum bitrate (kbps).
  • videoCodec: String = "VP8": Tercih edilen video codec'i ("VP8", "VP9", "H264").
  • videoCodecHwAcceleration: Boolean = true: Donanım hızlandırma açılsın mı.
• Ses Yapılandırması:
  • audioCodec: String = "OPUS": Tercih edilen ses codec'i ("OPUS", "ISAC").
  • audioStartBitrate: Int = 0 (WebRTC varsayılanı): Başlangıç ses bitrate'i (kbps).
  • noAudioProcessing: Boolean = false: Platform ses işleme (AEC, AGC, NS) devre dışı bırakılır.
  • disableBuiltInAEC: Boolean = false / disableBuiltInNS: Boolean = false: Donanım AEC/NS devre dışı bırakılırsa.
• Hata Ayıklama:
  • tracing: Boolean = false: WebRTC iç izlemeyi açar.
• Veri Kanalı (textChannelConfig):
  • textChannelConfig: DataChannelConfig? = DataChannelConfig(...): Komutlar için kullanılan yerleşik metin veri kanalının yapılandırması (FLASH_ON/OFF, HOLD/PICKUP vb.). Genellikle varsayılan bırakılır. Detaylar için DataChannelConfig sınıfına bakın.

Örnek Kullanım:

let customConnectParams = ConnectParameters(
    videoWidth: 1280,
    videoHeight: 720,
    videoCodec: "H264",
    additionalHeaders: ["X-WebRTC-Auth": "webrtc_token"]
)

// WebRtcConnection'ı özel parametrelerle alın letnlet webRtcConnection = videoCall.connect(parameters: customConnectParams) webRtcConnection.startRoom()

DataChannelConfig

DataChannelConfig, eşler arası iletişim ortamında bir veri kanalını başlatmak için kullanılan bir yapılandırma modelidir.

Özellikler

• enabled: Bool Veri kanalı etkin mi.
• label: String Veri kanalı için okunabilir bir etiket.
• id: Int Veri kanalı için ID (-1 ise ayarlanmamış).
• negotiated: Bool Kanal önceden müzakere edilmiş mi (manuel kurulum).
• protocol: String Alt protokol adı (Swift anahtar kelime çakışmasını önlemek için yeniden adlandırıldı).
• ordered: Bool Mesajlar sıralı mı gelmeli.
• maxRetransmits: Int Maksimum tekrar sayısı (-1 ise ayarlanmamış).
• maxRetransmitTimeMs: Int Tekrarlar için maksimum süre milisaniye cinsinden (-1 ise ayarlanmamış).

Başlatıcı

init(
    enabled: Bool,
    label: String,
    id: Int = -1,
    negotiated: Bool = false,
    protocol: String = "",
    ordered: Bool = true,
    maxRetransmits: Int = -1,
    maxRetransmitTimeMs: Int = -1
)

Demo Uygulama Kılavuzu

Genel Bakış

ECV175_iOS_DEMO uygulaması, ECV Video Call SDK'nın bir iOS uygulamasına nasıl entegre edileceğini ve kullanılacağını pratik olarak gösteren bir örnektir. Bu kılavuz, uygulamanın mimarisi, temel bileşenleri ve nasıl etkili kullanılacağı konusunda sizi yönlendirecek.

Uygulama Mimarisi

Temel Bileşenler

1. Uygulama Yapısı
   • Modern iOS geliştirme uygulamalarıyla SwiftUI framework'ü kullanılarak inşa edilmiştir
   • MVVM (Model-View-ViewModel) mimari desenini takip eder
   • Ekran yönetimi için SwiftUI'nin navigasyon sistemini kullanır
   • NavigationRoute enum'u ile tip güvenli navigasyon uygular
   • Bağımlılık enjeksiyonu için environment object'leri kullanır
2. Durum Yönetimi
   • AppState: Merkezi durum yönetim sınıfı;
     • Ortam yapılandırması kalıcılığı (UserDefaults ile)
     • SDK örneği yaşam döngüsü yönetimi
     • Ortam seçimi ve saklanması
     • @Published özellikleriyle reaktif UI güncellemeleri
   • ConfigurationManager: Ortam yapılandırmalarını yönetir
     • Ön tanımlı ve özel ortamları yönetir
     • Ortam yapılandırmaları için CRUD işlemleri sağlar
     • Ortam ayarlarını kalıcı hale getirir
3. Navigasyon Sistemi
   • Üç ana rota ile tip güvenli navigasyon:
     • mainScreen: Ortam seçimi sonrası giriş noktası
     • queueScreen(rtcId:name:queue:): Kuyruk yönetim arayüzü
     • callScreen(rtcId:): Görüntülü görüşme arayüzü
   • Doğru geri dönüş ve derin bağlantı desteği
   • Modern navigasyon için SwiftUI'nin NavigationStack'i kullanılır

Temel Özellikler

1. Ortam Seçimi
   • Birden fazla ortam yapılandırmasını destekler:
     • Ön tanımlı ortamlar
     • Ayarlanabilir özel ortamlar
   • Ortam yapılandırması şunları içerir:
     • Servis URL'si
     • WebRTC URL'si (opsiyonel)
     • Sinyalleşme URL'si (opsiyonel)
     • Kuyruk soketi yapılandırması
     • Oda aralığı ayarları
   • Seçilen ortam UserDefaults ile kalıcı hale getirilir
   • Seçilen ortam ile SDK otomatik başlatılır
2. Görüntülü Görüşme Entegrasyonu
   • ECV Video Call SDK ile sorunsuz entegrasyon
   • Özellikler:
     • Gerçek zamanlı video akışı
     • Ses kontrolleri (sessize al/aç)
     • Video kontrolleri (aç/kapat)
     • Kamera değiştirme
     • Fener kontrolü
     • Resim içinde resim desteği
   • Kuyruk yönetim sistemi:
     • Mevcut kuyruklara katılma
     • Yeni kuyruk oluşturma
     • Kuyruk durumunu izleme
   • Görüşme olay yönetimi:
     • Görüşme durumu yönetimi
     • Hata yönetimi
     • Bağlantı durumu izleme

Başlarken

Ön Koşullar

• Xcode 14.0 veya üzeri
• iOS 15.0 veya üzeri
• ECV175_iOS_SDK.xcframework
• WebRTC.xcframework
• Kamera ve mikrofon izinleri
• İnternet bağlantısı

Kurulum Süreci

1. Proje Yapılandırması
   • ECV175_iOS_DEMO.xcodeproj dosyasını açın
   • Demo uygulama hedefinin doğru yapılandırıldığından emin olun
   • Tüm bağımlılıkların doğru şekilde bağlandığını kontrol edin
   • Info.plist dosyasında gerekli izinleri yapılandırın:
     • Kamera kullanım açıklaması
     • Mikrofon kullanım açıklaması
2. Ortam Yapılandırması
   • Uygulamayı başlatın
   • Ortam seçimi ekranından istediğiniz ortamı seçin
   • Ortam ayarlarını yapılandırın:
     • Servis URL'si (zorunlu)
     • WebRTC URL'si (opsiyonel)
     • Sinyalleşme URL'si (opsiyonel)
     • Kuyruk soketi ayarları
   • Uygulama, seçilen ortam ile SDK'yı otomatik olarak başlatacaktır

Uygulama Akışı

1. İlk Başlatma
   • Uygulama, daha önce kaydedilmiş ortam yapılandırmasını kontrol eder
   • Varsa, otomatik olarak ana ekrana geçer
   • Yoksa, ortam seçimi ekranı gösterilir
   • Gerekli izinler (kamera, mikrofon) istenir
2. Ana Ekran
   • Mevcut görüntülü görüşme seçeneklerini gösterir
   • Geçerli ortam yapılandırmasını gösterir
   • Şunlara erişim sağlar:
     • Kuyruk seçimi
     • Görüşme başlatma
     • Ortam ayarları
   • İzin yönetimini ele alır
   • Görüntülü görüşme örneğini başlatır
3. Kuyruk Yönetimi
   • Mevcut kuyruklara katılma
   • Yeni kuyruk oluşturma
   • Kuyruk durumunu izleme
   • Kuyruk ayarlarını yapılandırma
   • Kuyruk olaylarını yönetme
4. Görüntülü Görüşme Arayüzü
   • Gerçek zamanlı video akışı:
     • Yerel video önizlemesi
     • Uzaktaki video gösterimi
     • Resim içinde resim desteği
   • Görüşme kontrolleri:
     • Sesi sessize al/aç
     • Videoyu aç/kapat
     • Kamera değiştirme
     • Fener kontrolü
   • Görüşme yönetimi:
     • Kapatma işlevi
     • Hata yönetimi
     • Bağlantı durumu izleme

Kod Yapısı

Temel Dosyalar

1. ECV175_iOS_DEMOApp.swift
   • Uygulama giriş noktası
   • Ana navigasyon yapısını kurar
   • Temel durum nesnelerini başlatır:
     • AppState
     • ConfigurationManager
   • Environment object'leri yapılandırır
2. AppState.swift
   • Uygulama durumunu yönetir
   • Ortam kalıcılığını ele alır
   • SDK yaşam döngüsünü kontrol eder
   • Durum geri yüklemeyi uygular
   • SDK örneğini yönetir
3. Views Dizini
   • Screens/:
     • EnvironmentsScreen.swift: Ortam seçimi ve yapılandırma
     • MainScreen.swift: Ana arayüz ve görüşme başlatma
     • CallScreen.swift: Görüntülü görüşme arayüzü
     • QueueScreen.swift: Kuyruk yönetimi
   • Components/: Yeniden kullanılabilir UI bileşenleri
   • SwiftUI ile uygun durum yönetimiyle arayüzler uygular

En İyi Uygulamalar

1. Durum Yönetimi
   • Bağımlılık enjeksiyonu için @EnvironmentObject kullanın
   • Sorumlulukları net şekilde ayırın
   • Uygun hata yönetimi uygulayın
   • Reaktif güncellemeler için @Published özellikleri kullanın
   • Durum kalıcılığını doğru yönetin
2. Navigasyon
   • Tip güvenli navigasyon rotaları kullanın
   • Doğru geri dönüşü uygulayın
   • Derin bağlantı senaryolarını yönetin
   • Navigasyon durumunu yönetin
   • Navigasyon hatalarını ele alın
3. SDK Entegrasyonu
   • SDK'yı yalnızca gerektiğinde başlatın
   • SDK yaşam döngüsünü doğru yönetin
   • SDK işlemleri için hata yönetimi uygulayın
   • Kaynakları verimli yönetin
   • SDK olaylarını doğru yönetin

Sorun Giderme

1. Yaygın Sorunlar
   • SDK başlatma hataları:
     • Ortam yapılandırmasını kontrol edin
     • Ağ bağlantısını doğrulayın
     • Gerekli izinlerin verildiğinden emin olun
   • Navigasyon durumu tutarsızlıkları:
     • Navigasyon rotalarını kontrol edin
     • Durum yönetimini kontrol edin
     • Navigasyon hatalarını ele alın
   • Ortam yapılandırma sorunları:
     • Yapılandırma ayarlarını doğrulayın
     • URL formatlarını kontrol edin
     • Zorunlu alanları doğrulayın
2. Hata Ayıklama İpuçları
   • Ayrıntılı hata mesajları için konsol loglarını kontrol edin
   • Ortam yapılandırmasını doğrulayın
   • SDK'nın doğru başlatıldığından emin olun
   • Ağ bağlantısını izleyin
   • İzin durumunu kontrol edin
   • Xcode hata ayıklama araçlarını kullanın

SDK Entegrasyonu ve Teknik Detaylar

Temel Yapılandırma ve Derleme Sistemi

1. Build.swift
   • Farklı derleme türlerini ve ortamları yönetir
   • Birden fazla bundle identifier destekler:
     • ccr.ECV175-iOS-DEMO.CORE: Temel demo ortamı
   • Her ortam yapılandırması şunları içerir:
     • Servis URL'si
     • Kuyruk yapılandırmaları
     • Ön tanımlı ayarlar (ör. callAttributes)
2. AppState.swift
   • SDK entegrasyonu için merkezi durum yönetimi
   • Temel sorumluluklar:
     • SDK örneği yaşam döngüsü yönetimi
     • Ortam yapılandırması kalıcılığı
     • Durum geri yükleme
     • Olay yönetimi koordinasyonu
   • Reaktif güncellemeler için @Published özellikleri kullanır
   • Ortam seçimi için UserDefaults kalıcılığı uygular

Ekran Bazında SDK Entegrasyonu

1. EnvironmentsScreen
   • Ortam seçimi ve yapılandırma
   • SDK Entegrasyonu:
     • Ortam yapılandırmalarını yönetir
     • Ön tanımlı ve özel ortamları yönetir
     • Ortam seçimini kalıcı hale getirir
     • Seçilen yapılandırma ile SDK'yı başlatır
2. MainScreen
   • Görüşme başlatmak için ana arayüz
   • SDK Entegrasyonu:

     • Görüntülü görüşme örneğini başlatır

     • İzinleri (kamera, mikrofon) yönetir

     • Kuyruk seçimini yönetir

     • Görüşme olay dinleyicilerini kurar

     • Temel özellikler:

       ```swift
       // SDK başlatma
       let call = await appState.sdk?.createVideoCall()
       // Olay yönetimi
       ECVModules?.onCallEvent.append { (videoCall, newEvent, lastEvent) in
       // Olayları yönet
       }
       
       
       

3. QueueScreen
   • Kuyruk yönetimi ve temsilci bağlantısı
   • SDK Entegrasyonu:

     • Kuyruğa katılmayı yönetir

     • Temsilci bağlantısını yönetir

     • Hem ECV 1.75 hem de 1.5 sürümlerini destekler

     • Temel özellikler:

       ```swift
       // Kuyruğa katılma
       let dialCallParameters = DialCallParameters(
       callerName: name,
       queue: queue,
       attributes: [queueKey: queueValue]
       )
       // Olay dinleme
       let ECVModules = appState.sdk?.modules
       ECVModules?.onCallEvent.append { (videoCall: VideoCall, newEvent: VideoCallEvent, lastEvent: VideoCallEvent) in
       if(videoCall.rtcId != call?.rtcId){
       return // Sadece mevcut görüşmeye ait olayları yakalamak için. // Tüm görüşmelerin olaylarını yakalamak için bu satırı yoruma alın
       }
       // Temsilci bağlantı yönetimi
       if(newEvent.type == .AgentConnected) {
       // TEMSİLCİ BAĞLANDI
       // GÖRÜŞME EKRANINA GEÇ
       }
       else if(newEvent.type == .Error){
       // showError = true
       }
       }
       // Görüşmeyi başlat
       await call?.start(dialCallParameters: dialCallParameters)
       
       
       

4. CallScreen
   • Görüntülü görüşme arayüzü
   • SDK Entegrasyonu:

     • WebRTC bağlantısını yönetir

     • Video/ses akışlarını yönetir

     • Görüşme özelliklerini kontrol eder

     • Temel özellikler:

       ```swift
       // WebRTC kurulumu
       let webRtcConnection = videoCall?.connect()
       // Akış yönetimi
       localRenderer = webRtcConnection?.localStream
       remoteRenderer = webRtcConnection?.remoteStream
       // Görüşme kontrolleri
       func toggleLocalAudio()
       func toggleLocalVideo()
       func toggleFlashlight()
       func switchCamera()
       func switchViewRenderers()
       
       
       
       

sdk.modules.onCallEvent.append { (videoCall: VideoCall, newEvent: VideoCallEvent, lastEvent: VideoCallEvent) in
    if(videoCall.rtcId != call?.rtcId){
        return // Sadece mevcut çağrıya ait olayları yakaladığımızdan emin oluyoruz. // Tüm çağrıların olaylarını yakalamak için bu satırı yoruma alın.
    }

if(newEvent.type == .Error){
    // Hata olayını işle
}
else if(newEvent.type == .AgentConnected) {
    // AgentConnected olayını işle
}
else {
    print("ECVModules?.onCallEvent üzerinden gelen: \(newEvent)")
}

// Kullanıcı profil verisi
let userId = "user123"
let accountType = "Premium"
let intent = "Fatura Sorgusu"
// Hedef kuyruk/skill
let targetQueue = "FaturaDestek"
// SDK örneğini al ve görüşme oluştur
let videoCall = sdkInstance.createVideoCall()
// ... GotRtcId bekle ...
// Uygulamaya özel verilerle parametreleri oluştur
let dialParams = DialCallParameters(
    callerName: "Kullanıcı \(userId)", // veya gerçek kullanıcı adı
    attributes: [
        "userId": userId,
        "accountType": accountType,
        "callIntent": intent
    ],
    acdAttributes: [
        "skill": "Fatura"
    ],
    queue: targetQueue, // Hedef kuyruğu açıkça belirt
    additionalHeaders: ["Authorization": "Bearer \(getUserAuthToken())"] // Örnek auth
)
// Görüşmeyi başlat
videoCall.start(dialParams)
// Kuyruk/Bekleme ekranına geç