Optimierung des Unified Communications SDK
Einführung
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 Echtzeitkommunikationsfunktionen (RTC), wie Audio- und Videokonferenzen. Bei der Bereitstellung dieser Anwendungen in einer virtualisierten Umgebung können jedoch Herausforderungen auftreten. Herkömmliche Bereitstellungsmethoden leiten Medienströ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, die auf einem lokalen Desktop ausgeführt wird, 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 diese Erfahrung.
Diese Produktdokumentation enthält alle Informationen, die 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 profitieren alle Citrix Kunden, die eine UCSDK-optimierte Anwendung verwenden, von einer verbesserten Erfahrung. Citrix UCSDK kann auch von Citrix Kunden genutzt werden, wenn eine benutzerdefinierte Inhouse-Anwendung entwickelt wird. In den meisten Fällen müssen Kunden UCSDK jedoch nicht nutzen und entwickeln – sie müssen lediglich die Citrix Umgebung und die Anwendung konfigurieren, um eine optimierte Erfahrung zu erzielen.
Hinweis:
Verweise auf Citrix WebRTC SDK (oder) eine HDX™-optimierte Anwendung weisen auf die Integration mit Citrix UCSDK hin und können synonym verwendet werden.
Neuigkeiten
UCSDK 4.1.0 ist die neuest 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 den UCSDK-Versionen 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 für neue Funktionen erforderlichen Citrix Komponenten zu aktualisieren.
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 größeren Mehrwert für unsere Kunden ermöglichen.
Neue Funktionen
- UCSDK Endpunkt-Bildschirmaufzeichnung (Technische Vorschau): Um eine wichtige Lücke bei der Compliance-Aufzeichnung zu schließen, können neue UCSDK-APIs nun 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 erweitern, 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 nun dynamisch Citrix-Sitzungsunterbrechungen handhaben und bieten Endbenutzern ein nahtloses Benutzererlebnis.
-
Unterstützung für neue Methoden: Es wurde Unterstützung für das Neustarten des ICE-Gatherings und Unterstützung für
iceCandidatePoolSizeinRTCConfigurationhinzugefügt. -
Verbesserte Fehlerbehandlung und Compliance-Verbesserungen: Verbesserte Konformität mit 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 Virtuelle Anwendungen 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 wurden, 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.
- Reduzierte CPU- und Bandbreitennutzung 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.
- Geringere 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 hinweg und optimieren Agenten-Workflows.
- Beispiele: Amazon Connect, Twilio, Avaya Experience Platform, Talkdesk, Content Guru
-
Unified Communications as a Service (UCaaS) / Cloud-Geschäftskommunikation: 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
-
Videokonferenzen und Zusammenarbeit für Unternehmen: Dedizierte Plattformen für hochwertige Videobesprechungen, Konferenzen und erweiterte Kollaborationsfunktionen.
- Beispiel: Pexip
-
Kommunikation im Finanzhandel: 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, selbst wenn sie derzeit nicht als mit UCSDK optimiert aufgeführt sind. Wir ermutigen Kunden, sich mit Citrix in Verbindung zu setzen, wenn sie Anwendungsfälle oder Anwendungen optimiert sehen möchten.
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 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. Ein vollständiger Umlauf des Datenflusses 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 des UCSDK – 4.1.0 – benötigt werden. Details zur Kompatibilität für ältere SDK-Versionen 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 Anbieteranwendung die entsprechende UCSDK-Version integriert und die Funktion aktiviert hat und dass Sie die entsprechenden VDA- und CWA-Versionen in Ihrer Umgebung verwenden.
Vollständig kompatible Versionen
Vollständig kompatible Versionen bedeuten, 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 aktuellste 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 Funktionalität der UCSDK-Funktionen hängt von drei Faktoren ab: der UCSDK-Version, die der Anbieter integriert und die Funktionen, die der Anbieter aktiviert hat, Citrix Virtual Apps and Desktops und der verwendeten Version der Citrix Workspace-App.
Auf der Citrix-Seite stellen Sie bitte sicher, dass Folgendes konfiguriert ist, damit die optimierte Anwendung optimiert werden kann:
- 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. DasCtxHdxWebSocketService(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 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. Bei diesem Registrierungswert wird die Groß-/Kleinschreibung nicht beachtet.
Wenn die Anwendung über einen Browser anstatt einer vollwertigen Desktopanwendung aufgerufen wird, müssen Sie z. B. chrome.exe im Registrierungswert zulassen.
Sobald 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 hat möglicherweise einen sehr spezifischen Anwendungsnamen. Beachten Sie daher die in der Sektion Aktueller Anbieter-Support verlinkte Anbieterdokumentation, um festzustellen, welcher Anwendungsname im WebSocketService zugelassen werden muss.
Versionen und Feature-Matrix
Da Versionsaktualisierungen häufig erfolgen, beachten Sie bitte die Produktlebenszyklus-Seiten 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 Neuestes CU / 2311 CR | 2402 LTSR Neuestes CU / 2311 CR | 2311 | 2311 | 2312 |
| Proxy-Server-Unterstützung | 3.1.0 | 2203 LTSR Neuestes CU / 2311 CR | 2402 LTSR Neuestes 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 |
| Stream-Auflösung / Simulcast | 3.1.0 | 2203 LTSR Neuestes CU / 2311 CR | 2402 LTSR Neuestes CU / 2311 CR | 2311 | 2311 | 2312 |
| Remote-Audio (mit Schleife) | 3.1.0 | 2203 LTSR Neuestes CU / 2311 CR | 2402 LTSR Neuestes 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 finden Sie unten:
| Anbieter | Dokumentation |
|---|---|
| Amazon Connect | Amazon Connect-Audio für Citrix Cloud-Desktops optimieren |
| Ring Central | Verwenden von RingCentral in einer Citrix VDI-Umgebung |
| 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 Rainbow Desktop-Anwendung |
| Talkdesk | Talkdesk Agent Workspace VDI Connect |
| IPC | IPC Unigy Soft Client Citrix VDI |
| Vitero | Vitero Inspire für Citrix VDI |
| Pexip | Bereitstellung 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.