DCV 模块 - NICE DCV
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 Amazon Web Services 服务入门

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

DCV 模块

实现 DCV 协议客户端的模块。

方法

身份验证(url、回调)→ {身份验证}

启动指定的 NICE DCV 服务器端点的身份验证过程。

参数:

名称 类型 描述
url 字符串 正在运行的 NICE DCV 服务器的主机名和端口,格式如下:https://dcv_host_address:port. 例如:https://my-dcv-server:8443.
callbacks 身份验证回调 在身份验证过程中可调用的回调。

返回值:

-身份验证对象。

类型

身份验证

连接(配置)→ {Promise。 <Connection>|承诺。 < {code: ConnectionErrorCode,消息:字符串} >}

连接到指定的 NICE DCV 服务器端点。如果连接成功,将返回一个 Connection 对象。如果连接失败,则返回错误对象。

参数:

名称 类型 描述
config ConnectionConfig 这些区域有: ConnectionConfig 对象。

返回值:

-连接对象或错误对象。

类型

承诺。 <Connection> | 承诺。 < {code: ConnectionErrorCode,消息:字符串} >

setLogHandler(处理程序)→ {void}

设置自定义日志处理函数。覆盖默认日志处理程序时,使用浏览器控制台进行调试时,原始日志条目位置将丢失。

参数:

名称 类型 描述
handler 函数 自定义日志处理函数。处理函数包含级别(数字)、LevelName(字符串)、域(字符串)和消息(字符串)。

返回值:

类型

void

setLogLevel(等级)→ {void}

设置日志级别。只有在使用默认日志处理程序时必需。

参数:

名称 类型 描述
level LogLevel 要使用的日志级别。

返回值:

类型

void

成员

(常量) AudioError:AudioErrorCode

这些区域有: AudioError 代码枚举

类型:

(常量) AuthenticationError:AuthenticationErrorCode

这些区域有: AuthenticationError 代码枚举

类型:

(常量) ChannelError:ChannelErrorCode

这些区域有: ChannelError 代码枚举

类型:

(常量) ClosingReasonError:ClosingReasonErrorCode

这些区域有: ClosingReasonError 代码枚举

类型:

(常量) ConnectionError:ConnectionErrorCode

这些区域有: ConnectionError 代码枚举

类型:

(常量) CustomChannelError:CustomChannelErrorCode

这些区域有: CustomChannelError 代码枚举

类型:

(常量) DisplayConfigError:DisplayConfigErrorCode

这些区域有: DisplayConfigError 代码枚举

类型:

(常量) FileStorageError:FileStorageErrorCode

这些区域有: FileStorageError 代码枚举

类型:

(常量) LogLevel:LogLevel

可用的 SDK 日志级别。

类型:

(常量) MultiMonitorError:MultiMonitorErrorCode

这些区域有: MultiMonitorError 代码枚举

类型:

(常量) ResolutionError:ResolutionErrorCode

这些区域有: ResolutionError 代码枚举

类型:

(常量)版本

NICE DCV 版本包含主要、次要、补丁、修订版、扩展版和 versionStr。

属性:

名称 类型 描述
major integer 主要版本号。
minor integer 次要版本号。
patch integer 补丁程序版本号。
revision integer 修订版号。
extended 字符串 扩展字符串。
versionStr 字符串 主要版本、次要版本、补丁程序号和修订版号的串联形式major.minor.patch+build.revision.

(常量) ScreenshotError:ScreenshotErrorCode

这些区域有: ScreenshotError 代码枚举

类型:

(常量) WebcamError:WebcamErrorCode

这些区域有: WebcamError 代码枚举

类型:

类型和回调定义

AudioErrorCode

这些区域有: AudioError DCV 模块中可用的代码枚举

  • SETTING_AUDIO_FAILED

  • CHANNEL_NOT_AVAILABLE

类型:

  • number

身份验证回调

身份验证回调

类型:

  • 对象

属性:

名称 类型 描述
promptCredentials authPromptCredentials回调 当用户被要求获取凭据时要调用的回调函数。
error authErrorCallback 认证失败时要调用的回调函数。
success authSuccessCallback 认证成功时要调用的回调函数。

AuthenticationErrorCode

这些区域有: AuthenticationError DCV 模块中可用的代码枚举

  • INVALID_MESSAGE

  • UNKNOWN_AUTH_MODE

  • SESSION_NOT_AVAILABLE

  • NO_SESSIONS

  • WRONG_CREDENTIALS

  • SASL_CHALLENGE

  • SASL_AUTH_MECHANISM

  • FAILED_COMMUNICATION

  • AUTHENTICATION_REJECTED

  • GENERIC_ERROR

  • WRONG_CREDENTIALS_FORMAT

  • WRONG_CREDENTIALS_TYPE

  • UNREQUESTED_CREDENTIALS

  • MISSING_CREDENTIAL

类型:

  • number

authErrorCallback(身份验证,错误)

认证失败时要调用的回调函数。

参数:

名称 类型 描述
authentication 身份验证 身份验证对象。
error 对象 身份验证过程引发的错误对象。
名称 类型 描述
code AuthenticationErrorCode 错误代码。
message 字符串 错误消息。

authPromptCredentials回调(身份验证、质询)

当用户被要求获取凭据时要调用的回调函数。用户必须通过提供请求的凭据来回答质询。

参数:

名称 类型 描述
authentication 身份验证 身份验证对象。
challenge 对象 挑战。
名称 类型 描述
requiredCredentials 数组。 <Object> 请求的凭证对象数组。
名称 类型 描述
name 字符串 请求的凭证的名称。
type 字符串 请求的凭证的类型。

authSuccessCallback(身份验证、身份验证数据)

认证成功时要调用的回调函数。

参数:

名称 类型 描述
authentication 身份验证 身份验证对象。
authenticationData 数组。 <Object> 包含 NICE DCV 会话 ID 和身份验证令牌的对象数组。
名称 类型 描述
sessionId 字符串 NICE DCV 会话 ID。
authToken 字符串 NICE DCV 会话的身份验证令牌。

通道

可以指定的可用频道。

类型:

  • “剪贴板” | “显示” | “输入” | “音频” | “文件存储”

ChannelErrorCode

这些区域有: ChannelError DCV 模块中可用的代码枚举

  • ALREADY_OPEN

  • INITIALIZATION_FAILED

  • REJECTED

类型:

  • number

clipboardEventCallback(事件)

当一个回调函数clipboardEvent生成。

参数:

名称 类型 描述
event 对象 有关剪贴板事件的信息。
名称 类型 属性 描述
name 建立 | 复制 | 粘贴 | dataSizeAlert| autoCopyDone | newDataAvailable| autoPasteDone | 远程错误 | pasteAvailableData 始终为。事件名称。
clipboardData 对象 | 字符串 剪贴板中的数据。
autoCopy 布尔值 <optional> 指示是否启用从会话剪贴板到本地客户端剪贴板的自动复制。
maxDataSize number <optional> 可以放置在剪贴板中的最大数据量。
error 字符串 <optional> 错误信息(如果适用)。

ClosingReasonErrorCode

这些区域有: ClosingReasonError DCV 模块中可用的代码枚举

  • TRANSPORT_ERROR

  • NO_ERROR

  • GENERIC_ERROR

  • INTERNAL_SERVER_ERROR

  • PROTOCOL_ERROR

  • AUTHORIZATION_DENIED

  • AUTHORIZATION_REVOKED

  • ACCESS_REJECTED

  • IDLE_TIMEOUT_EXPIRED

  • DISCONNECT_BY_OWNER

  • DISCONNECT_BY_USER

  • EVICTED

类型:

  • number

ColorSe

可以指定的可用色彩空间。

类型:

  • “RGB” | “YUV_REC601" | “YUV_REC709"

连接回调

发生连接错误时可调用的回调。

类型:

  • 对象

属性:

名称 类型 描述
disconnect 断开回调 连接结束时调用的回调函数。
displayLayout displayLayoutCallback 更改显示布局或分辨率时要调用的回调函数。
displayAvailability displayAvailabilityCallback 当显示器的可用性发生变化时要调用的回调函数。
firstFrame firstFrameCallback 从 NICE DCV 服务器接收到第一帧时要调用的回调函数。
filePrinted filePrintedCallback 在 NICE DCV 服务器上打印文件时要调用的回调函数。
fileDownload fileDownloadCallback 准备从 NICE DCV 服务器下载文件时调用的回调函数。
dataChannel dataChannelCallback 当 NICE DCV 服务器发送有关数据通道可用性的通知时要调用的回调函数。
licenseNotification licenseNotificationCallback NICE DCV 服务器发送有关许可证状态的通知时要调用的回调函数。
idleWarningNotification idleWarningNotification回调 NICE DCV 服务器发送空闲超时警告时要调用的回调函数。
collaboratorList collaboratorListCallback NICE DCV 服务器发送协作者列表时要调用的回调函数(自 NICE DCV Web Client SDK 版本 1.1.0 起)。
qualityIndicatorState qualityIndicatorState回调 连接质量指示器状态改变时要调用的回调函数。
filestorageEnabled filestorageEnabledCallback 启用或禁用文件存储时要调用的回调函数。
featuresUpdate featuresUpdateCallback 要在功能状态更改时调用的回调函数。
clipboardEvent clipboardEventCallback 当一个回调函数clipboardEvent生成。
deviceChangeEvent deviceChangeEvent回调 当一个回调函数被调用deviceChange触发事件。
screenshot 屏幕截图回调 当一个回调函数screenshot可用。

ConnectionConfig

NICE DCV 连接的配置。

类型:

  • 对象

属性:

名称 类型 描述
url 字符串 正在运行的 NICE DCV 服务器的主机名和端口,格式如下:https://dcv_host_address:port. 例如:https://my-dcv-server:8443.
sessionId 字符串 NICE DCV 会话 ID。
authToken 字符串 连接到服务器时使用的身份验证令牌。
baseUrl 字符串 用于加载 SDK 文件的绝对或相对 URL。
resourceBaseUrl 字符串 用于访问 DCV 资源的绝对或相对 URL。
enabledChannels 数组。 <Channel> 指示可以启用的频道列表。如果未指定或提供了空数组,则默认为所有可用的通道。
losslessColorspace ColorSe 表示将要使用的色彩空间。如果未指定,则默认为 “RGB”。
divId 字符串 的 IDdiv对象,在 HTML DOM 中,SDK 应该使用远程流创建画布。
volumeLevel integer 首选音量级别。有效范围为 0 至 100。
clipboardAutoSync 布尔值 指示是否为兼容的 Web 浏览器启用了从 NICE DCV 会话剪贴板到本地客户端剪贴板的自动复制。
dynamicAudioTuning 布尔值 指示在建立连接时是否根据 NICE DCV 服务器的音频设置动态调整音频。
clientHiDpiScaling 布尔值 指示是否根据客户端的 DPI 缩放画布。
highColorAccuracy 布尔值 指示是否应使用高色彩精度(如果有)。如果未指定,则默认为false.
enableWebCodecs 布尔值 表示是否 WebCodecs 如果可用,应使用。如果未指定,则默认为 false
observers 连接回调 要为与连接相关的事件调用的回调函数。
callbacks 连接回调 与相同observers属性,但每个回调都包含Connection对象为第一个参数。

ConnectionErrorCode

这些区域有: ConnectionError DCV 模块中可用的代码枚举

  • ALREADY_OPEN

  • INVALID_CONFIG

  • INITIALIZATION_FAILED

  • REJECTED

  • MAIN_CHANNEL_ALREADY_OPEN

  • GENERIC_ERROR(自 DCV 服务器 2021.0 起)

  • INTERNAL_SERVER_ERROR(自 DCV 服务器 2021.0 起)

  • AUTHENTICATION_FAILED(自 DCV 服务器 2021.0 起)

  • PROTOCOL_ERROR(自 DCV 服务器 2021.0 起)

  • INVALID_SESSION_ID(自 DCV 服务器 2021.0 起)

  • INVALID_CONNECTION_ID(自 DCV 服务器 2021.0 起)

  • CONNECTION_LIMIT_REACHED(自 DCV 服务器 2021.0 起)

  • SERVER_UNREACHABLE(自 DCV 服务器 2022.1 起)

类型:

  • number

创建目录(路径)

参数:

名称 类型 描述
path 字符串 我们要在其中创建目录的服务器上的绝对路径。它还应包含目标目录的名称。

CustomChannelErrorCode

这些区域有: CustomChannelError DCV 模块中可用的代码枚举

  • TRANSPORT_ERROR

类型:

  • number

dataChannelCallback(信息)

当 NICE DCV 服务器发送有关数据通道可用性的通知时要调用的回调函数。

参数:

名称 类型 描述
info 对象 有关数据通道的信息。
名称 类型 描述
name 字符串 数据通道的名称。
token 字符串 数据通道的身份验证令牌。

删除文件(路径)

参数:

名称 类型 描述
path 字符串 服务器上标识我们要删除的文件的绝对路径。

deviceChangeEvent回调 ()

当一个回调函数被调用deviceChange触发事件。

断开回调(原因)

连接结束时调用的回调函数。

参数:

名称 类型 描述
reason 对象 断开连接的原因。
名称 类型 描述
code number 原因代码。
message 字符串 原因消息。

displayAvailabilityCallback(状态,displayID)

当显示器的可用性发生变化时要调用的回调函数。

参数:

名称 类型 描述
status 对象 显示屏的状态。
名称 类型 说明
enabled 布尔值 指示显示器是否已启用。
closed 布尔值 指示显示屏是否关闭。
displayId number 显示的标识符。

DisplayConfigErrorCode

这些区域有: DisplayConfigError DCV 模块中可用的代码枚举

  • INVALID_ARGUMENT

  • UNSUPPORTED_OPERATION

  • NO_CHANNEL

类型:

  • number

displayLayoutCallback(服务器宽度、服务器高度、头部)

更改显示布局或分辨率时要调用的回调函数。

参数:

名称 类型 描述
serverWidth number 主显示器的宽度 (像素)。
serverHeight number 主显示器的高度 (像素)。
heads 数组。 <显示器> NICE DCV 服务器支持的显示头。

功能

要素值。

  • display-表示单屏视频流的可用性。

  • display-multi-表示多显示器视频流的可用性。

  • high-color-accuracy-表示高色彩精度的可用性(自 NICE DCV Web Client SDK 版本 1.1.0 起)。

  • mouse-表示鼠标功能的可用性。

  • keyboard-表示键盘功能的可用性。

  • keyboard-sas-表示 SAS 序列(控制 + Alt + 删除)功能的可用性。

  • relative-mouse-表示相对鼠标模式的可用性。

  • clipboard-copy-表示从 NICE DCV 服务器到客户端的剪贴板复制功能是否可用。

  • clipboard-paste-表示从客户端到 NICE DCV 服务器的剪贴板粘贴功能的可用性。

  • audio-in-表示使用麦克风的音频输入功能的可用性。

  • audio-out-表示音频播放功能的可用性。

  • webcam-表示网络摄像头流媒体功能的可用性。

  • file-download-表示从 NICE DCV 服务器到客户端的文件下载功能的可用性。

  • file-upload-表示从客户端到 NICE DCV 服务器的文件上传功能的可用性。

类型:

  • 字符串

featuresUpdateCallback(功能列表)

要在功能状态更改时调用的回调函数。

参数:

名称 类型 描述
featuresList 数组。 <功能> 一系列已更改的功能。

fileDownloadCallback(文件资源)

准备从 NICE DCV 服务器下载文件时调用的回调函数。

参数:

名称 类型 描述
fileResource 对象 有关可供下载的文件的信息。
名称 类型 描述
id 字符串 文件的标识符。
url 字符串 用于下载文件的 URL。
domain 字符串 资源域。
token 字符串 用于下载文件的身份验证令牌。该令牌也包含在 URL 中。

filePrintedCallback(打印资源)

在 NICE DCV 服务器上打印文件时要调用的回调函数。

参数:

名称 类型 描述
printResource 对象 有关打印文件的信息。
名称 类型 描述
id 字符串 打印文件的标识符。
url 字符串 用于下载打印文件的 URL。
domain 字符串 资源域。在本例中,printer.
token 字符串 用于下载打印文件的身份验证令牌。该令牌也包含在 URL 中。

文件存储

允许在文件系统上浏览和执行操作的对象。

类型:

  • 对象

属性:

名称 类型 描述
list 列表 允许列出服务器上提供的路径中存在的项目(文件和目录)的函数。
createDirectory 创建目录 允许在服务器上的指定路径创建目录的函数。
retrieveFile 检索文件 允许在服务器上的指定路径本地下载文件的函数。
deleteFile DeleteFile 允许删除服务器上指定路径的文件的函数。
renameFile 重命名文件 允许将文件从指定源路径重命名为指定目标路径的函数。
renameDirectory 重命名目录 允许将指定源路径中的目录重命名为绝对目标路径的函数。
storeFile 存储文件 允许将本地文件上载到服务器上提供的路径的函数。

filestorageEnabledCallback(启用)

启用文件存储时要调用的回调函数。仅限互联网资源管理器 11 上的懒人频道。

参数:

名称 类型 说明
enabled 布尔值 指示是否启用了文件存储。

FileStorageErrorCode

这些区域有: FileStorageError DCV 模块中可用的代码枚举

  • CANCELLED

  • ABORTED

  • INVALID_ARGUMENT

  • NOT_IMPLEMENTED

  • ERROR

  • ALREADY_EXIST

  • NOT_FOUND

类型:

  • number

firstFrameCallback(已启用调整大小, relativeMouseMode已启用,displayID)

从 NICE DCV 服务器接收到第一帧时要调用的回调函数。为每个显示器发射。

参数:

名称 类型 说明
resizeEnabled 布尔值 指示服务器是否支持调整客户端显示布局的大小。
relativeMouseModeEnabled 布尔值 指示服务器是否支持相对鼠标模式。
displayId number 显示的标识符。

idleWarningNotification回调 (disconnectionDateTime)

NICE DCV 服务器发送空闲超时警告时要调用的回调函数。

参数:

名称 类型 说明
disconnectionDateTime 日期 断开连接的日期和时间。

collaboratorListCallback(合作者)

NICE DCV 服务器发送协作者列表时要调用的回调函数。

参数:

名称 类型 描述
collaborators 数组。 <Object> 包含有关协作者信息的对象的有关协作者的信息。
名称 类型 描述
username 字符串 协作者的用户名。
owner 布尔值 指示协作者是否为会话所有者。
connectionId number 表示服务器为连接分配的 ID。

licenseNotificationCallback(通知)

NICE DCV 服务器发送有关许可证状态的通知时要调用的回调函数。

参数:

名称 类型 描述
notification 对象 通知。
名称 类型 描述
product 字符串 DCV 产品。
status 字符串 许可证的状态。
message 字符串 消息。
leftDays number 许可证过期前的天数。
isDemo 布尔值 指示许可证是否为演示许可证。
numUnlicensed number 未许可连接的数量。
licensingMode 字符串 许可模式。
documentationUrl 字符串 文档的 URL。

列表(路径)

参数:

名称 类型 描述
path 字符串 我们要列出其内容的服务器上的绝对路径。

LogLevel

可用的 SDK 日志级别。

类型:

  • 跟踪 | 调试 | 信息 | 警告 | 错误 | 静默

监控

类型:

  • 对象

属性:

名称 类型 描述
name 字符串 显示头的名称。
rect 对象 有关显示头的信息。
名称 类型 描述
x number 最初的x显示头的坐标。
y number 最初的y显示头的坐标。
width number 显示头的宽度 (像素)。
height number 显示头的高度 (像素)。
primary 布尔值 指示显示头是否为主显示头。这是通过远程操作系统(如果可用)确定的。
dpi number 显示头的 DPI。

MultiMonitorErrorCode

这些区域有: MultiMonitorError DCV 模块中可用的代码枚举

  • NO_DISPLAY_CHANNEL

  • MAX_DISPLAY_NUMBER_REACHED

  • INVALID_ARGUMENT

  • DISPLAY_NOT_OPENED_BY_SERVER

  • REQUEST_TIMEOUT

  • GENERIC_ERROR

  • NO_ERROR

类型:

  • number

qualityIndicatorState回调(状态)

连接质量指示器状态改变时要调用的回调函数。

参数:

名称 类型 描述
state 数组。 <Object> 有关连接质量的信息。
名称 类型 描述
name 字符串 指标的名称。
status 正常 | 警告 | 严重 状态的描述。
changed 布尔值 指示状态是否已更改。

重命名目录 (src、dest)

参数:

名称 类型 描述
src 字符串 服务器上标识我们要重命名的目录的绝对源路径。
dest 字符串 服务器上的绝对目标路径,用于指定目标路径和目录名。

重命名文件 (src、dest)

参数:

名称 类型 描述
src 字符串 服务器上标识我们要重命名的文件的绝对源路径。
dest 字符串 服务器上指定目标路径和文件名的绝对目标路径。

ResolutionErrorCode

这些区域有: ResolutionError DCV 模块中可用的代码枚举

  • INVALID_ARGUMENT

  • NO_CHANNEL

类型:

  • number

检索文件(路径)

参数:

名称 类型 描述
path 字符串 服务器上标识我们要在本地下载的文件的绝对路径。

屏幕截图回调(屏幕截图)

屏幕截图可用时要调用的回调函数。

参数:

名称 类型 描述
screenshot byte[] PNG 格式的屏幕截图缓冲区,或null如果屏幕截图检索失败。

ScreenshotErrorCode

这些区域有: ScreenshotError DCV 模块中可用的代码枚举

  • NO_CHANNEL

  • GENERIC_ERROR

类型:

  • number

服务器信息

类型:

  • 对象

属性:

名称 类型 描述
name 字符串 软件的名称。
version 对象 软件版本号。
名称 类型 描述
major number 主要版本号。
minor number 次要版本号。
revision number 修订版本号。
os 字符串 操作系统。
arch 字符串 架构。
hostname 字符串 主机名。

stats

类型:

  • 对象

属性:

名称 类型 描述
fps number 当前每秒的帧数。
traffic number 当前流量(以 bit/s 为单位)。
peakTraffic number 自建立连接以来的流量峰值(以 bit/s 为单位)。
latency number 当前延迟(以毫秒为单位)。
currentChannels number 自建立连接以来已打开的通道数。
openedChannels number 当前打开的通道数。
channelErrors number 已报告错误的频道数。

存储文件(文件、目录)

参数:

名称 类型 描述
file 文件 我们要上传到服务器的文件对象(有关更多信息,请参阅 https://developer.mozilla.org/en-US/docs/Web/API/File)。
dir 字符串 我们要上传文件的服务器上的绝对路径。

WebcamErrorCode

这些区域有: WebcamError DCV 模块中可用的代码枚举

  • SETTING_WEBCAM_FAILED

  • CHANNEL_NOT_AVAILABLE

类型:

  • number