Unified Communications SDK-Optimierung
Einführung
Mit Citrix Virtual Apps and Desktops können Sie Ihren Benutzern Anwendungen auf einer Vielzahl von Endpunktgeräten bereitstellen. Viele dieser Anwendungen umfassen Echtzeitkommunikationsfunktionen (RTC), wie etwa 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 ein Benutzererlebnis bieten, das dem der auf einem lokalen Desktop ausgeführten Anwendung entspricht oder dieses sogar übertrifft. In der heutigen Welt ist eine 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 Kommunikationsfeatures genauso reibungslos funktionieren wie auf einem lokalen Desktop. Optimierte Anwendungen ermöglichen dieses Erlebnis.
In dieser Produktdokumentation wird alles beschrieben, was Citrix-Kunden zum Erlernen und Bereitstellen von UCSDK-optimierten Anwendungen benötigen.
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 bleibt innerhalb des virtuellen Hosts und wird nahtlos im virtuellen Desktop oder Anwendungsfenster angezeigt.
- Media Engine: Die Aufgaben der Medienverarbeitung (Kodieren/Dekodieren von Audio und Video) werden auf das lokale Gerät des Benutzers ausgelagert. Dadurch wird die Serverlast minimiert und die Netzwerknutzung optimiert.
Normalerweise bietet Citrix UCSDK Technologieanbietern im Bereich Echtzeitkommunikation an und arbeitet mit ihnen zusammen, um UCSDK in diese Anwendungen zu integrieren. Nach der Integration wird jeder Citrix-Kunde, der eine für UCSDK optimierte Anwendung verwendet, von einem verbesserten Erlebnis profitieren. Citrix UCSDK kann auch von Citrix-Kunden verwendet werden, wenn eine benutzerdefinierte interne Anwendung erstellt wird. In den meisten Fällen müssen Kunden jedoch keine Entwicklung mit UCSDK durchführen – sie müssen lediglich die Citrix-Umgebung und die Anwendung konfigurieren, um ein optimiertes Erlebnis zu erzielen.
Hinweis:
Verweise auf Citrix WebRTC SDK (oder) eine für HDX™ optimierte Anwendung weisen auf eine Integration mit Citrix UCSDK hin und können austauschbar verwendet werden.
Neue Features
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 den UCSDK-Versionen werden neue Features eingeführt und Technologieanbieter müssen sicherstellen, dass das SDK aktualisiert wird, damit die Features für die Kunden verfügbar werden. Auf diese Weise können sich Citrix-Kunden ganz auf die Aktualisierung der Citrix-Komponenten konzentrieren, die für neue Features erforderlich sind.
Mit der Veröffentlichung von UCSDK 4.1.0 führen wir wichtige Verbesserungen der Benutzererfahrung und brandneue Features ein, die eine tiefere Integration mit den Produkten unserer Partner und einen Mehrwert für unsere Kunden ermöglichen.
Neue Features
- UCSDK-Endpunkt-Bildschirmaufzeichnung (Technical Preview): Neue UCSDK-APIs schließen eine wichtige Lücke bei der Compliance-Aufzeichnung und können jetzt Inhalte auf dem Endpunkt erfassen, selbst wenn Anwendungen innerhalb von VDI ausgeführt werden. Dieses Feature, das sich derzeit in Preview 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 dieses Feature auf die Verbesserung von Anbieteranwendungen ausgerichtet ist und sich von der Citrix-Sitzungsaufzeichnung unterscheidet.
- Handhabung der erneuten Sitzungsverbindung: Eine wichtige Verbesserung an Bootstrap verbessert die Browseranwendungserfahrung erheblich und bringt sie näher an die von Electron-basierten Desktopanwendungen heran. Browserbasierte Anwendungen, die Bootstrap verwenden, können jetzt Citrix-Sitzungstrennungen dynamisch verarbeiten und bieten Endbenutzern so ein nahtloses Benutzererlebnis.
-
Unterstützung für neue Methoden: Unterstützung für den Neustart der ICE-Erfassung und Unterstützung für
iceCandidatePoolSizeinRTCConfigurationhinzugefügt. -
Bessere Fehlerbehandlung und Compliance-Verbesserungen: Verbesserte Compliance mit der WebRTC-Spezifikation für
getUserMedia. Verbessert:getStats()fürCitrixPeerConnection,RtpSenderundRtpReceiver, um bei Fehlerbedingungen einen leeren Bericht statt “void” zurückzugeben.
Vollständig kompatible Versionen für UCSDK 4.1.0 umfassen:
- Citrix Virtual Apps and 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 Features hinzuzufügen, falls es Anwendungsfälle gibt, die mit den neu eingeführten Features erreicht werden können.
Hauptvorteile
Wenn Sie mit Citrix UCSDK optimierte Anwendungen verwenden, können Sie Folgendes erwarten:
- Verbesserte Medienverarbeitungsleistung durch Auslagerung der prozessorintensiven Medienkodierung/-dekodierung vom Citrix Virtual Delivery Agent (VDA) auf den Clientendpunkt, wodurch die allgemeine Reaktionsfähigkeit für Endbenutzer erhöht wird.
- Reduzierte CPU- und Bandbreitennutzung auf Citrix VDA, sodass die IT mehr gleichzeitige Benutzer pro Host unterstützen und Unternehmen die Bereitstellung virtueller Citrix-Desktops kostengünstig skalieren kann.
- Niedrigere Gesamtbetriebskosten für Unternehmen, da optimierte Endpunkte die Lebensdauer älterer virtueller Desktops verlängern und den Bedarf an Hostinfrastruktur reduzieren, wodurch im Laufe der Zeit die Investitions- und Betriebskosten sinken.
- Unterstützung für Windows-, Mac-, Linux-, ChromeOS- und HTML5-Endpunktplattformen.
Anwendungsfälle
UCSDK wurde speziell für die Optimierung von Echtzeit-Kommunikationsanwendungen entwickelt, die dem WebRTC-Standard entsprechen. Hier sind die wichtigsten Szenarien und die Arten von WebRTC-basierten Anwendungen, die UCSDK verwenden können bzw. bereits verwenden.
-
Contact Center as a Service (CCaaS) / Cloud Contact Center-Plattformen: Verwalten Sie in erster Linie Kundeninteraktionen über mehrere Kanäle hinweg und optimieren Sie die Arbeitsabläufe der Mitarbeiter.
- Beispiele: Amazon Connect, Twilio, Avaya Experience Platform, Talkdesk, Content Guru
-
Unified Communications as a Service (UCaaS) / Cloud Business Communications: Integrieren Sie Sprache, Video, Teamnachrichten und Präsenz für eine umfassende Geschäftskommunikation.
- Beispiele: Ring Central, 8x8, Intermedia, Alcatel-Lucent Rainbow
-
Kommunikationsplattform als Service (CPaaS): Bereitstellung von APIs zum Einbetten von Echtzeit-Kommunikationsfunktionen direkt in benutzerdefinierte Anwendungen.
- Beispiele: Twilio, Ribbon Communications
-
Videokonferenzen und Zusammenarbeit im Unternehmen: Spezielle Plattformen für hochwertige Videokonferenzen, Konferenzen und erweiterte Features zur Zusammenarbeit.
- Beispiel: Pexip
-
Finanzhandelskommunikation: Entwickelt für die einzigartigen, leistungsstarken und konformen Kommunikationsanforderungen der Finanzmärkte.
- Beispiel: IPC Unigy
-
Virtuelle Lern- und Trainingsplattformen: Entwickelt für interaktive, hochwertige virtuelle Unterrichts- und Trainingserlebnisse.
- Beispiel: Vitero
Die zugrunde liegende WebRTC-Grundlage des Citrix UCSDK bedeutet, dass seine Optimierungsfunktionen auf alle WebRTC-basierten Kommunikationsanwendungen erweitert werden können. Dies öffnet die Tür zur Optimierung einer breiten Palette von Anwendungen, die WebRTC für Echtzeitinteraktionen nutzen, auch wenn sie derzeit nicht als mit UCSDK optimiert aufgeführt sind. Wir empfehlen unseren Kunden, sich mit allen Anwendungsfällen oder Anwendungen, die sie optimiert sehen möchten, an Citrix zu wenden.
UCSDK-Architektur

-
Anbieteranwendung: Dies kann jede Desktop- oder Browser-basierte Echtzeit-Kommunikationsanwendung eines Drittanbieters sein, in die UCSDK integriert ist.
-
UCSDK JS: UCSDK JS stellt die APIs bereit, die Anbieteranwendungen verwenden, 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 Prozess HdxRtcEngine.exe auf dem Clientendpunkt gestartet, wenn die Umleitung erfolgreich ist. Sobald HdxRtcEngine.exe auf dem Clientendpunkt gestartet wird, fließen alle Signal- und Nutzdaten vom Citrix VDA zum Clientendpunkt, erreichen die Cloud, werden zum Clientendpunkt zurückgeschickt und dann an den VDA weitergeleitet. Ein vollständiger Rundlauf des Datenflusses könnte beispielsweise wie folgt 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 Featureanforderungen finden Sie in der Tabelle Versionen und Funktionsmatrix weiter unten.
Hinweis:
Damit Kunden alle zu UCSDK hinzugefügten Features nutzen können, müssen Sie dafür sorgen, dass die Anbieteranwendung die entsprechende UCSDK-Version integriert und das Feature aktiviert hat, und 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 von UCSDK alle verfügbaren Features nutzen können. Für die aktuelle neueste Version von UCSDK – 4.1.0 sind die folgenden vollständig kompatiblen Versionen der Citrix-Komponenten verfügbar:
- 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 des UCSDK-Features hängt von drei Faktoren ab: der vom Anbieter integrierten UCSDK-Version und den vom Anbieter aktivierten Features, den Citrix Virtual Apps and Desktops sowie 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:
- Stellen Sie sicher, dass die Umleitungsrichtlinie von Microsoft Teams aktiviert ist. Weitere Informationen finden Sie unter Multimedia-Richtlinieneinstellungen. Beachten Sie, dass diese Richtlinie standardmäßig aktiviert ist.
- Electron- oder browserbasierte Anwendungen von Drittanbietern, die das
CitrixWebrtc.jsSDK verwenden, werden standardmäßig nicht unterstützt. DerCtxHdxWebSocketService(WebSocketService.exe) lässt keine Verbindungen von Anwendungen zu, die nicht auf der Whitelist stehen. Der gewünschte Name der ausführbaren Binärdatei der Anwendung muss zu 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 und fügen Sie nicht aus einer Textdatei ein und fügen Sie keine Kommas ein. Achten Sie darauf, dass der angegebene Name mit dem ausführbaren Namen der Anwendung übereinstimmt. Bei diesem Registrierungswert wird die Groß-/Kleinschreibung nicht beachtet.
Wenn auf die Anwendung über einen Browser und nicht über eine vollwertige Desktopanwendung zugegriffen wird, müssen Sie beispielsweise chrome.exe im Registrierungswert zulassen.
Sobald die obige Registrierung erfolgreich konfiguriert ist, starten Sie den VDA neu oder starten Sie CtxHdxWebSocketService neu, um die Einrichtung der Positivliste 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. Lesen Sie daher die im Abschnitt Aktueller Anbietersupport verlinkte Herstellerdokumentation, um zu bestimmen, welcher Anwendungsname im WebSocketService zulässig sein muss.
Versionen und Featurematrix
Da Versionsaktualisierungen häufig erfolgen, lesen Sie bitte die Produktlebenszyklusseiten Citrix Virtual Apps and Desktops und Citrix Workspace-App, um sicherzustellen, dass eine bestimmte Version unterstützt wird. Bei vielen der älteren Features handelt es sich bei den in der Tabelle genannten Versionen um die letzten unterstützten Current Release (CR)-Versionen zum Zeitpunkt der Erstellung dieses Dokuments.
| Feature | UCSDK-Version | VDA | CWA Windows | CWA Mac | CWA Linux | CWA ChromeOS/HTML5 |
|---|---|---|---|---|---|---|
| Audio/Video (p2p und conference) | 3.1.0 | 2203 LTSR Neueste CU / 2311 CR | 2402 LTSR Neueste CU / 2311 CR | 2311 | 2311 | 2312 |
| Bildschirmfreigabe | 3.1.0 | 2203 LTSR Neueste CU / 2311 CR | 2402 LTSR Neueste CU / 2311 CR | 2311 | 2311 | 2312 |
| Mehrfrequenzwahlverfahren | 3.1.0 | 2203 LTSR Neueste CU / 2311 CR | 2402 LTSR Neueste CU / 2311 CR | 2311 | 2311 | 2312 |
| Proxyserverunterstützung | 3.1.0 | 2203 LTSR Neueste CU / 2311 CR | 2402 LTSR Neueste CU / 2311 CR | 2311 | 2311 | 2312 |
| App-Freigabe | 3.1.0 | 2203 LTSR Neueste CU / 2311 CR | 2402 LTSR Neueste CU / 2311 CR | 2311 | 2311 | – |
| Dynamisches e911 | 3.1.0 | 2203 LTSR Neueste CU / 2311 CR | 2402 LTSR Neueste CU / 2311 CR | 2311 | 2311 | 2312 |
| Mehrere Fenster | 3.1.0 | 2203 LTSR Neueste CU / 2311 CR | 2402 LTSR Neueste CU / 2311 CR | 2311 | 2311 | 2312 |
| SDP Unified Plan-Unterstützung | 3.1.0 | 2203 LTSR Neueste CU / 2311 CR | 2402 LTSR Neueste CU / 2311 CR | 2311 | 2311 | 2312 |
| Stream-Auflösung / Simulcast | 3.1.0 | 2203 LTSR Neueste CU / 2311 CR | 2402 LTSR Neueste CU / 2311 CR | 2311 | 2311 | 2312 |
| Remote-Audio (mit Schleife) | 3.1.0 | 2203 LTSR Neueste CU / 2311 CR | 2402 LTSR Neueste CU / 2311 CR | 2311 | 2311 | 2405 |
| Browserbasiertes UCSDK (Bootstrap-Unterstützung) | 4.0.2 | 2407 CR | 2402 LTSR Neueste CU / 2311 CR | 2311 | 2311 | 2312 |
| Web HID API | 4.0.2 | 2203 LTSR Neueste CU / 2311 CR | 2409.10 | 2411 | 2411 | 2505 |
| Web Audio API | 4.0.2 | 2203 LTSR Neueste CU / 2311 CR | 2405 | 2405 | 2405 | – |
| Restart ICE | 4.1.0 | 2203 LTSR Neueste CU / 2311 CR | 2503.2 | 2503 | 2503 | 2502.10 |
| Bildschirmaufzeichnung (Preview)¹ | 4.1.0 | 2503 | 2503.2 | – | – | – |
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.
Aktuelle Anbieterunterstützung
Mehrere Drittanbieter haben das Unified Communications SDK in ihre Produkte integriert. Die aktuelle Liste der Anbieter und der zugehörigen Dokumentation finden Sie unten:
| Vendor | Dokumentation |
|---|---|
| Amazon Connect | Optimieren Sie Amazon Connect-Audio für Citrix Cloud-Desktops |
| 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 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 |
Problembehandlung
Informationen zur Fehlerbehebung finden Sie unter Anleitung zur Fehlerbehebung für mit Citrix Unified Communications SDK optimierte Apps.
Bekannte Probleme & Einschränkungen
In diesem Abschnitt werden die derzeit bekannten Probleme und Einschränkungen dokumentiert, sobald sie erkannt werden.