Optimierung des Unified Communications SDK

Einleitung

Mit Citrix Virtual Apps and Desktops können Sie Anwendungen für Ihre Benutzer auf einer Vielzahl von Endgeräten bereitstellen. Viele dieser Anwendungen umfassen Echtzeitkommunikations-(RTC)-Funktionen, wie Audio- und Videokonferenzen. Bei der Bereitstellung dieser Anwendungen in einer virtualisierten Umgebung können jedoch Herausforderungen auftreten. Herkömmliche Bereitstellungsmethoden leiten Mediendatenströme (Audio/Video) vom Clientgerät zum VDI-Server im Rechenzentrum, bevor sie an den Endpunkt zurückgesendet werden. Dieses „Hairpinning“ führt zu unnötigem Datenverkehr und Verarbeitungsaufwand auf dem Server, insbesondere bei bandbreitenintensiven Audio- und Videoanrufen.

Das Citrix Unified Communications SDK (UCSDK) ist eine Technologie, die es Technologieanbietern ermöglicht, diese RTC-Anwendungen für die Verwendung in Citrix Umgebungen zu optimieren. Wenn eine Anwendung optimiert ist, kann sie eine Benutzererfahrung bieten, die der einer Anwendung auf einem lokalen Desktop entspricht oder diese sogar übertrifft. In der heutigen Welt ist nahtlose Echtzeitkommunikation für Produktivität und Zusammenarbeit unerlässlich. Bei der Verwendung von Anwendungen in einer virtuellen Umgebung ist es entscheidend, dass Audio- und Videoanrufe, Bildschirmfreigabe und andere Kommunikationsfunktionen so reibungslos funktionieren, als würden sie auf einem lokalen Desktop ausgeführt. Optimierte Anwendungen bieten dieses Erlebnis.

Diese Produktdokumentation beschreibt alles, was Citrix Kunden benötigen, um UCSDK-optimierte Anwendungen kennenzulernen und bereitzustellen.

Funktionsweise

Citrix bietet eine optimierte Bereitstellungsmethode für Echtzeitkommunikationsanwendungen innerhalb von VDIs. Dieser Ansatz nutzt das Unified Communications SDK (UCSDK), um die virtualisierte Anwendung in zwei Teile aufzuteilen:

  • Benutzeroberfläche (UI): Die Benutzeroberfläche verbleibt im virtuellen Host und wird nahtlos im virtuellen Desktop oder Anwendungsfenster angezeigt.
  • Media Engine: Die Medienverarbeitungsaufgaben (Kodierung/Dekodierung von Audio und Video) werden auf das lokale Gerät des Benutzers ausgelagert. Dies minimiert die Serverlast und optimiert die Netzwerknutzung.

Typischerweise bietet Citrix das UCSDK Technologieanbietern im Bereich der Echtzeitkommunikation an und arbeitet mit ihnen zusammen, um das UCSDK in diese Anwendungen zu integrieren. Nach der Integration erhält jeder Citrix Kunde, der eine UCSDK-optimierte Anwendung verwendet, ein verbessertes Erlebnis. Citrix UCSDK kann auch von Citrix Kunden genutzt werden, wenn eine benutzerdefinierte Inhouse-Anwendung entwickelt wird. In den meisten Fällen müssen Kunden jedoch das UCSDK nicht nutzen und damit entwickeln – sie müssen lediglich die Citrix Umgebung und die Anwendung konfigurieren, um ein optimiertes Erlebnis zu erzielen.

Hinweis:

Verweise auf das Citrix WebRTC SDK (oder) eine HDX™-optimierte Anwendung weisen auf eine Integration mit Citrix UCSDK hin und können synonym verwendet werden.

Hauptvorteile

Wenn Sie Anwendungen verwenden, die mit Citrix UCSDK optimiert sind, können Sie Folgendes erwarten:

  • Verbesserte Medienverarbeitungsleistung durch Auslagerung der prozessorintensiven Medienkodierung/-dekodierung vom Citrix Virtual Delivery Agent (VDA) auf den Client-Endpunkt, wodurch die allgemeine Reaktionsfähigkeit für Endbenutzer erhöht wird.
  • Reduzierter CPU- und Bandbreitenverbrauch auf Citrix VDA, wodurch die IT mehr gleichzeitige Benutzer pro Host unterstützen und Unternehmen Citrix Virtual-Desktop-Bereitstellungen kostengünstig skalieren können.
  • Niedrigere Gesamtbetriebskosten für Unternehmen, da optimierte Endpunkte die Lebensdauer älterer virtueller Desktops verlängern und den Bedarf an Host-Infrastruktur reduzieren, wodurch Investitions- und Betriebskosten im Laufe der Zeit gesenkt werden.
  • Unterstützung für Windows-, Mac-, Linux-, ChromeOS- und HTML5-Endpunktplattformen.

Anwendungsfälle

UCSDK wurde speziell zur Optimierung von Echtzeit-Kommunikationsanwendungen entwickelt, die dem WebRTC-Standard entsprechen. Hier sind wichtige Szenarien und die Arten von WebRTC-basierten Anwendungen, die UCSDK nutzen können / bereits nutzen.

  • Contact Center as a Service (CCaaS) / Cloud Contact Center-Plattformen: Verwalten hauptsächlich Kundeninteraktionen über mehrere Kanäle und optimieren Agenten-Workflows.
    • Beispiele: Amazon Connect, Twilio, Avaya Experience Platform, Talkdesk, Content Guru
  • Unified Communications as a Service (UCaaS) / Cloud Business Communications: Integrieren Sprache, Video, Team-Messaging und Präsenz für eine umfassende Geschäftskommunikation.
    • Beispiele: Ring Central, 8x8, Intermedia, Alcatel-Lucent Rainbow
  • Communications Platform as a Service (CPaaS): Bieten APIs zum direkten Einbetten von Echtzeit-Kommunikationsfunktionen in benutzerdefinierte Anwendungen.
    • Beispiele: Twilio, Ribbon Communications
  • Enterprise Video Conferencing und Collaboration: Dedizierte Plattformen für hochwertige Videokonferenzen und erweiterte Kollaborationsfunktionen.
    • Beispiel: Pexip
  • Finanzhandelskommunikation: Entwickelt für die einzigartigen, hochleistungsfähigen und konformen Kommunikationsanforderungen der Finanzmärkte.
    • Beispiel: IPC Unigy
  • Virtuelle Lern- und Trainingsplattformen: Entwickelt für interaktive, hochwertige virtuelle Klassenzimmer- und Trainingserlebnisse.
    • Beispiel: Vitero

Die zugrunde liegende WebRTC-Grundlage des Citrix UCSDK bedeutet, dass seine Optimierungsfunktionen auf alle WebRTC-basierten Kommunikationsanwendungen ausgeweitet werden können. Dies eröffnet die Möglichkeit, eine Vielzahl von Anwendungen zu optimieren, die WebRTC für Echtzeitinteraktionen nutzen, selbst wenn sie derzeit nicht als mit UCSDK optimiert aufgeführt sind. Wir ermutigen Kunden, sich mit Anwendungsfällen oder Anwendungen, die sie optimiert sehen möchten, an Citrix zu wenden.

UCSDK-Architektur

UCSDK-Architektur

  • Herstelleranwendung: Dies kann jede Desktop- oder Browser-basierte Echtzeit-Kommunikationsanwendung eines Drittanbieters sein, die UCSDK integriert hat.

  • UCSDK JS: UCSDK JS stellt die APIs bereit, die Herstelleranwendungen nutzen, um Audio/Video an den Endpunkt auszulagern.

  • HdxRtcEngine: Dies ist die eingebettete WebRTC-Medien-Engine in der Citrix Workspace App, die den ausgelagerten Audio-/Videoanruf verarbeitet und handhabt.

Sobald das SDK geladen und verwendet wird, wird der HdxRtcEngine.exe-Prozess auf dem Client-Endpunkt gestartet, wenn die Umleitung erfolgreich ist. Sobald HdxRtcEngine.exe auf dem Client-Endpunkt gestartet wird, fließen alle Signalisierungs- und Nutzdaten vom Citrix VDA zum Client-Endpunkt, erreichen die Cloud, kehren zum Client-Endpunkt zurück und werden dann an den VDA weitergeleitet. Zum Beispiel könnte ein vollständiger Umlauf des Datenflusses sein:

Vendor App -> CitrxWebrtc.js SDK -> Citrix VDA components -> Citrix Client Endpoint components -> Cloud -> Citrix Client Endpoint components -> Citrix VDA components -> CitrxWebrtc.js SDK -> Vendor App

Systemanforderungen

Die Systemanforderungen geben die verschiedenen Versionen der Citrix-Komponenten an, die mit der neuesten Version des UCSDK – 5.0.0 – benötigt werden. Kompatibilitätsdetails für ältere Versionen des SDK und spezifische Funktionsanforderungen finden Sie in der Tabelle Versions- und Funktionsmatrix unten.

Hinweis:

Damit Kunden eine Funktion nutzen können, die dem UCSDK hinzugefügt wurde, stellen Sie sicher, dass die Herstelleranwendung die entsprechende UCSDK-Version integriert und die Funktion aktiviert hat und Sie die entsprechenden VDA- und CWA-Versionen in Ihrer Umgebung verwenden.

Vollständig kompatible Versionen

Vollständig kompatible Versionen zeigen an, dass Kunden durch die Verwendung dieser Versionen von Citrix-Komponenten zusammen mit der neuesten Version von UCSDK alle verfügbaren Funktionen nutzen können. Für die aktuelle Version von UCSDK – 5.0.0 – sind die vollständig kompatiblen Versionen der Citrix-Komponenten wie folgt:

  • Citrix Virtual Apps™ und Desktops: 2603
  • Citrix Workspace App für Windows: 2603
  • Citrix Workspace App für Mac: Wird noch veröffentlicht
  • Citrix Workspace App für Linux: 2603
  • Citrix Workspace App für ChromeOS/HTML5: Wird noch veröffentlicht

Hinweis:

Die UCSDK-Optimierung wird auf allen Endpunktplattformen unterstützt: Windows, Mac, Linux, ChromeOS und HTML5. Wenn die obige Liste für eine bestimmte Endpunktplattform Wird noch veröffentlicht anzeigt, bedeutet dies lediglich, dass eine Version, die vollständig mit den neuesten UCSDK-Funktionen kompatibel ist, noch nicht veröffentlicht wurde. Daher können Kunden weiterhin ältere Versionen der Citrix Workspace-App verwenden, um bestehende Funktionen zu nutzen, selbst mit dem neueren UCSDK.

Konfiguration

Die Funktionsweise der UCSDK-Funktion hängt von drei Faktoren ab: der UCSDK-Version, die der Anbieter integriert hat, und den Funktionen, die der Anbieter aktiviert hat, den Citrix Virtual Apps and Desktops und der verwendeten Version der Citrix Workspace-App.

Stellen Sie auf der Citrix-Seite sicher, dass Folgendes konfiguriert ist, damit die optimierte Anwendung optimiert werden kann:

  1. Stellen Sie sicher, dass die Umleitungsrichtlinie für Microsoft Teams aktiviert ist. Weitere Informationen finden Sie unter Multimedia-Richtlinieneinstellungen. Beachten Sie, dass diese Richtlinie standardmäßig aktiviert ist.
  2. Drittanbieter-Electron- oder browserbasierte Anwendungen, die das CitrixWebrtc.js SDK verwenden, werden standardmäßig nicht unterstützt. Der CtxHdxWebSocketService (WebSocketService.exe) lässt keine Verbindungen von Anwendungen zu, die nicht auf der Zulassungsliste stehen. Der gewünschte Name der ausführbaren Binärdatei der Anwendung muss einem Whitelist-Registrierungsschlüssel hinzugefügt werden.

Auf dem VDA

  • Erstellen Sie einen Schlüsselpfad: HKLM\Software\WOW6432Node\Citrix\WebSocketService
  • Schlüsselname: ProcessWhitelist
  • Typ: MULTISZ
  • Schlüsselwert: Mytestapp.exe

Wenn Sie mehrere Anwendungen haben, geben Sie jede Anwendung in eine neue Zeile ein. Kopieren Sie nicht aus einer Textdatei und fügen Sie keine Kommas ein. Stellen Sie sicher, dass der angegebene Name mit dem ausführbaren Namen der Anwendung übereinstimmt. Dieser Registrierungswert ist nicht Groß-/Kleinschreibung-sensitiv.

Wenn die Anwendung über einen Browser anstatt einer vollwertigen Desktop-Anwendung aufgerufen wird, müssen Sie beispielsweise chrome.exe im Registrierungswert zulassen.

Nachdem die obige Registrierung erfolgreich konfiguriert wurde, starten Sie den VDA neu oder starten Sie CtxHdxWebSocketService neu, um die Whitelist-Einrichtung abzuschließen.

Auf dem Client

Es ist keine Konfiguration erforderlich. Installieren Sie einfach die Citrix Workspace-App.

Jeder Anbieter kann einen sehr spezifischen Anwendungsnamen haben. Beachten Sie daher die Anbieterdokumentation, die im Abschnitt Aktuelle Anbieterunterstützung verlinkt ist, um zu bestimmen, welcher Anwendungsname im WebSocketService zugelassen werden muss.

Versionen und Funktionsmatrix

Da Versionsaktualisierungen häufig erfolgen, beachten Sie bitte die Produktlebenszyklusseiten von Citrix Virtual Apps and Desktops und Citrix Workspace-App, um sicherzustellen, dass eine bestimmte Version unterstützt wird. Für viele der älteren Funktionen sind die in der Tabelle genannten Versionen die letzten unterstützten Current Release (CR)-Versionen zum Zeitpunkt der Erstellung dieses Dokuments.

Funktion UCSDK-Version VDA CWA Windows CWA Mac CWA Linux CWA ChromeOS/HTML5
Audio / Video (P2P & Konferenz) 3.1.0 2203 LTSR Latest CU / 2311 CR 2402 LTSR Latest CU / 2311 CR 2311 2311 2312
Bildschirmfreigabe 3.1.0 2203 LTSR Latest CU / 2311 CR 2402 LTSR Latest CU / 2311 CR 2311 2311 2312
DTMF 3.1.0 2203 LTSR Latest CU / 2311 CR 2402 LTSR Latest CU / 2311 CR 2311 2311 2312
Proxyserver-Unterstützung 3.1.0 2203 LTSR Latest CU / 2311 CR 2402 LTSR Latest CU / 2311 CR 2311 2311 2312
App-Freigabe 3.1.0 2203 LTSR Latest CU / 2311 CR 2402 LTSR Latest CU / 2311 CR 2311 2311 N/A
Dynamisches e911 3.1.0 2203 LTSR Latest CU / 2311 CR 2402 LTSR Latest CU / 2311 CR 2311 2311 2312
Mehrfenster 3.1.0 2203 LTSR Neuestes CU / 2311 CR 2402 LTSR Neuestes CU / 2311 CR 2311 2311 2312
SDP Unified Plan-Unterstützung 3.1.0 2203 LTSR Neuestes CU / 2311 CR 2402 LTSR Neuestes CU / 2311 CR 2311 2311 2312
Stream-Auflösung / Simulcast 3.1.0 2203 LTSR Latest CU / 2311 CR 2402 LTSR Latest CU / 2311 CR 2311 2311 2312
Remote-Audio (mit Schleife) 3.1.0 2203 LTSR Latest CU / 2311 CR 2402 LTSR Latest CU / 2311 CR 2311 2311 2405
Browserbasiertes UCSDK (Bootstrap-Unterstützung) 4.0.2 2407 CR 2402 LTSR Latest CU / 2311 CR 2311 2311 2312
Web HID API 4.0.2 2203 LTSR Latest CU / 2311 CR 2409.10 2411 2411 2505
Web Audio API 4.0.2 2203 LTSR Latest CU / 2311 CR 2405 2405 2405 N/A
ICE neu starten 4.1.0 2203 LTSR Neuestes CU / 2311 CR 2503.2 2503 2503 2502.10
Bildschirmaufzeichnung (Vorschau)¹ 4.1.0 2503 2503.2 N/A N/A N/A
SmartSync 5.0.0 2203 LTSR neuestes CU / 2311 CR 2603 N/A 2604 N/A

Hinweis:

Wir haben eine neue Richtlinie für die Bildschirmaufzeichnung eingeführt, daher benötigen Sie die Version 2503 des Delivery Controller™, die mit CVAD 2503 geliefert wird.

Aktueller Anbieter-Support

Mehrere Drittanbieter haben das Unified Communications SDK in ihre Produkte integriert. Die aktuelle Liste der Anbieter und ihrer unterstützenden Dokumentation ist unten aufgeführt:

Anbieter Dokumentation
Amazon Connect Amazon Connect-Audio für Citrix Cloud-Desktops optimieren
Ring Central RingCentral in einer Citrix VDI-Umgebung verwenden
Five9 Five9 WebRTC in Citrix-Umgebungen
Twilio Twilio Flex auf Citrix VDI
Avaya Avaya Experience Platform Public Cloud VDI-Lösung für Citrix
8x8 Citrix VDI-Integration mit 8x8 Work für Desktop & Web
Content Guru Content Guru Citrix-Integration
Ribbon Communications Ribbon Communications Citrix WebRTC SDK
Intermedia Installieren von Intermedia Unite auf Citrix Virtual Apps and Desktops
Alcatel-Lucent Rainbow Citrix-Optimierung für die Rainbow-Desktopanwendung
Talkdesk Talkdesk Agent Workspace VDI Connect
IPC IPC Unigy Soft Client Citrix VDI
Vitero Vitero Inspire für Citrix VDI
Pexip Bereitstellen der Connect-Desktop-App in Citrix Pexip Infinity Docs
Zoom Web App WebRTC-Umleitung für die Zoom Web App konfigurieren(https://support.zoom.com/hc/en/article?id=zm_kb&sysparm_article=KB0083142)

Fehlerbehebung

Informationen zur Fehlerbehebung finden Sie unter Anleitung zur Fehlerbehebung für Apps, die mit dem Citrix Unified Communications SDK optimiert wurden.

Bekannte Probleme und Einschränkungen

Dieser Abschnitt dokumentiert die aktuellen bekannten Probleme und Einschränkungen, sobald sie erkannt werden.

Optimierung des Unified Communications SDK