Optimierung des Unified Communications SDK
Einführung
Mit Citrix Virtual Apps and Desktops können Sie Anwendungen auf einer Vielzahl von Endgeräten für Ihre Benutzer bereitstellen. Viele dieser Anwendungen umfassen Echtzeitkommunikationsfunktionen (RTC), 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 auf einem lokalen Desktop ausgeführten Anwendung 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, wie sie es auf einem lokalen Desktop tun würden. 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.
- Medien-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 UCSDK Technologieanbietern im Bereich der Echtzeitkommunikation an und arbeitet mit ihnen zusammen, um UCSDK in diese Anwendungen zu integrieren. Nach der Integration erhält jeder Citrix Kunde, der eine UCSDK-optimierte Anwendung verwendet, eine verbesserte Erfahrung. Citrix UCSDK kann auch von Citrix Kunden genutzt werden, wenn eine benutzerdefinierte Inhouse-Anwendung erstellt wird. In den meisten Fällen müssen Kunden UCSDK jedoch nicht nutzen und damit entwickeln – sie müssen lediglich die Citrix Umgebung und die Anwendung konfigurieren, um eine optimierte Erfahrung zu erzielen.
Hinweis:
Verweise auf das Citrix WebRTC SDK (oder) eine HDX™-optimierte Anwendung weisen auf die Integration mit Citrix UCSDK hin und können synonym verwendet werden.
Neuerungen
UCSDK 4.1.0 ist die neueste allgemein verfügbare Version, die Technologieanbieter integrieren können. Darüber hinaus werden zwei weitere Versionen unterstützt – UCSDK 4.0.2 und UCSDK 3.1.0. Mit UCSDK-Releases werden neue Funktionen eingeführt, und Technologieanbieter müssen sicherstellen, dass sie das SDK aktualisieren, damit Kunden die Funktionen erhalten. Auf diese Weise können sich Citrix Kunden darauf konzentrieren, die notwendigen Citrix Komponenten zu aktualisieren, um neue Funktionen zu erhalten.
Mit der Veröffentlichung von UCSDK 4.1.0 führen wir entscheidende Verbesserungen der Benutzererfahrung und brandneue Funktionen ein, die eine tiefere Integration mit den Produkten unserer Partner und einen höheren Mehrwert für unsere Kunden ermöglichen.
Neue Funktionen
- UCSDK Endpunkt-Bildschirmaufzeichnung (Tech Preview): Um eine wichtige Lücke bei der Compliance-Aufzeichnung zu schließen, können neue UCSDK-APIs jetzt Inhalte auf dem Endpunkt erfassen, selbst wenn Anwendungen innerhalb von VDI ausgeführt werden. Diese Funktion, die sich derzeit in der Vorschau für Windows-Endpunkte befindet, ermöglicht es Technologieanbietern, ihre Anwendungen zu verbessern, um die Endpunkt-Bildschirmaufzeichnung auf Citrix zu unterstützen. Beachten Sie, dass diese Funktion auf die Verbesserung von Anbieteranwendungen abzielt und sich von der Citrix Sitzungsaufzeichnung unterscheidet.
- Behandlung der Sitzungswiederverbindung: Eine entscheidende Verbesserung von Bootstrap verbessert das Erlebnis von Browseranwendungen erheblich und bringt es näher an das von Electron-basierten Desktop-Anwendungen heran. Browserbasierte Anwendungen, die Bootstrap verwenden, können jetzt Citrix-Sitzungsunterbrechungen dynamisch handhaben und bieten Endbenutzern ein nahtloses Benutzererlebnis.
-
Unterstützung für neue Methoden: Zusätzliche Unterstützung für das Neustarten der ICE-Sammlung und Unterstützung für
iceCandidatePoolSizeinRTCConfiguration. -
Verbesserte Fehlerbehandlung und Compliance-Verbesserungen: Verbesserte Einhaltung der WebRTC-Spezifikation für
getUserMedia. VerbessertesgetStats()fürCitrixPeerConnection,RtpSenderundRtpReceiver, um bei Fehlerbedingungen einen leeren Bericht anstelle von void zurückzugeben.
Vollständig kompatible Versionen für UCSDK 4.1.0 umfassen:
- Citrix Virtual Apps und Desktops™ 2503
- Citrix Workspace™ App für Windows 2503
- Citrix Workspace App für Mac 2503
- Citrix Workspace App für Linux 2503
- Die neueste ChromeOS/HTML5-Version.
Hinweis:
Citrix-Kunden können sich an Technologieanbieter wenden, um das SDK zu aktualisieren (oder) Unterstützung für bestimmte Funktionen hinzuzufügen, falls es Anwendungsfälle gibt, die mit den neu eingeführten Funktionen realisiert werden können.
Wichtige Vorteile
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 dem 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 entwickelt, um Echtzeit-Kommunikationsanwendungen zu optimieren, 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 die Arbeitsabläufe der Agenten.
- 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 Einbetten von Echtzeit-Kommunikationsfunktionen direkt in benutzerdefinierte Anwendungen.
- Beispiele: Twilio, Ribbon Communications
-
Enterprise-Videokonferenzen und -Zusammenarbeit: Dedizierte Plattformen für hochwertige Videobesprechungen, Konferenzen und erweiterte Kollaborationsfunktionen.
- Beispiel: Pexip
-
Finanzhandelskommunikation: Entwickelt für die einzigartigen, hochleistungsfähigen und konformen Kommunikationsanforderungen der Finanzmärkte.
- Beispiel: IPC Unigy
-
Plattformen für virtuelles Lernen und Training: 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, auch 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

-
Anbieteranwendung: Dies kann jede Drittanbieter-Echtzeitkommunikationsanwendung sein, die Desktop-basiert oder Browser-basiert ist und UCSDK integriert hat.
-
UCSDK JS: UCSDK JS stellt die APIs bereit, die Anbieteranwendungen 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 wurde, 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. Ein vollständiger Hin- und Rückfluss könnte beispielsweise so aussehen:
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 von UCSDK – 4.1.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 zu UCSDK hinzugefügt wurde, stellen Sie sicher, dass die Anbieteranwendung die entsprechende UCSDK-Version integriert und die Funktion aktiviert hat und verwenden Sie die entsprechenden VDA- und CWA-Versionen in Ihrer Umgebung.
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 des UCSDK alle verfügbaren Funktionen nutzen können. Für die aktuelle neueste Version des UCSDK – 4.1.0 sind die vollständig kompatiblen Versionen der Citrix-Komponenten wie folgt:
- Citrix Virtual Apps und Desktops: 2503
- Citrix Workspace App Windows: 2503
- Citrix Workspace App Mac: 2503
- Citrix Workspace App Linux: 2503
- Citrix Workspace App ChromeOS/HTML5: Neueste Version
Konfiguration
Die Funktionsweise der UCSDK-Funktionen hängt von drei Faktoren ab: der UCSDK-Version, die der Anbieter integriert hat, den Funktionen, die der Anbieter aktiviert hat, Citrix Virtual Apps and Desktops und der verwendeten Version der Citrix Workspace-App.
Auf Citrix-Seite stellen Sie bitte sicher, dass Folgendes konfiguriert ist, damit die optimierte Anwendung optimiert werden darf:
- 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.
- Drittanbieter-Electron- oder browserbasierte Anwendungen, die das
CitrixWebrtc.jsSDK nutzen, werden standardmäßig nicht unterstützt. DerCtxHdxWebSocketService(WebSocketService.exe) lässt keine Verbindungen von Anwendungen zu, die sich nicht auf der Zulassungsliste befinden. Der gewünschte Name der ausführbaren Anwendungsbinärdatei muss einem Registrierungsschlüssel für die Whitelist 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 zwischen Groß- und Kleinschreibung zu unterscheiden.
Wenn die Anwendung über einen Browser anstelle einer vollwertigen Desktop-Anwendung aufgerufen wird, müssen Sie beispielsweise chrome.exe im Registrierungswert zulassen.
Sobald die oben genannte 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 Feature-Matrix
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 und Konferenz) | 3.1.0 | 2203 LTSR Neuestes CU / 2311 CR | 2402 LTSR Neuestes CU / 2311 CR | 2311 | 2311 | 2312 |
| Bildschirmfreigabe | 3.1.0 | 2203 LTSR Neuestes CU / 2311 CR | 2402 LTSR Neuestes 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 |
| Proxy-Server-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 Neuestes CU / 2311 CR | 2402 LTSR Neuestes CU / 2311 CR | 2311 | 2311 | N/A |
| Dynamisches e911 | 3.1.0 | 2203 LTSR Neuestes CU / 2311 CR | 2402 LTSR Neuestes CU / 2311 CR | 2311 | 2311 | 2312 |
| Mehrfenster | 3.1.0 | 2203 LTSR Latest CU / 2311 CR | 2402 LTSR Latest CU / 2311 CR | 2311 | 2311 | 2312 |
| SDP Unified Plan Unterstützung | 3.1.0 | 2203 LTSR Latest CU / 2311 CR | 2402 LTSR Latest CU / 2311 CR | 2311 | 2311 | 2312 |
| Streamauflö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 |
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 | Intermedia Unite auf Citrix Virtual Apps and Desktops installieren |
| Alcatel-Lucent Rainbow | Citrix-Optimierung für die Rainbow Desktop-Anwendung |
| 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 |
Fehlerbehebung
Informationen zur Fehlerbehebung finden Sie unter Troubleshooting Guidance for Apps Optimized with Citrix Unified Communications SDK.
Bekannte Probleme und Einschränkungen
Dieser Abschnitt dokumentiert die aktuellen bekannten Probleme und Einschränkungen, sobald sie erkannt werden.