diff --git a/zh-cn/application-dev/reference/apis-arkui/Readme-CN.md b/zh-cn/application-dev/reference/apis-arkui/Readme-CN.md index ccb096e9bdd11cf4a1c3dfe31309b64fbf0c530a..a61ae1e4cef4c51637a8ad4e04b5b51291edbcaf 100644 --- a/zh-cn/application-dev/reference/apis-arkui/Readme-CN.md +++ b/zh-cn/application-dev/reference/apis-arkui/Readme-CN.md @@ -565,6 +565,7 @@ - [用户界面外观服务错误码](errorcode-uiappearance.md) - [NodeAdapter错误码](errorcode-nodeadapter.md) - [XComponent组件错误码](errorcode-xcomponent.md) + - [Video组件错误码](errorcode-video.md) - 图形图像 - [屏幕错误码](errorcode-display.md) - [窗口错误码](errorcode-window.md) diff --git a/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-media-components-video.md b/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-media-components-video.md index 013097155448ed77b02715e161ff2e94b2ca139d..743b096ef8fd22b514c090cd92e499396c8ae368 100755 --- a/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-media-components-video.md +++ b/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-media-components-video.md @@ -36,7 +36,7 @@ Video(value: VideoOptions) ## VideoOptions对象说明 -**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 +定义Video的具体配置参数。 **系统能力：** SystemCapability.ArkUI.ArkUI.Full @@ -51,6 +51,8 @@ Video(value: VideoOptions) ## PlaybackSpeed8+枚举说明 +视频播放倍速选项。 + **原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 **系统能力：** SystemCapability.ArkUI.ArkUI.Full @@ -137,7 +139,7 @@ objectFit(value: ImageFit) | 参数名 | 类型 | 必填 | 说明 | | ------ | ----------------------------------------- | ---- | -------------------------------- | -| value | [ImageFit](ts-appendix-enums.md#imagefit) | 是 | 视频填充模式。
默认值：Cover。
约束：不支持ImageFit类型中的枚举值MATRIX，若设置，则作用效果与Cover一致。
异常值：若设置异常值undefined、null，或不在[ImageFit](ts-appendix-enums.md#imagefit)枚举范围内的值，作用效果均与Cover一致。| +| value | [ImageFit](ts-appendix-enums.md#imagefit) | 是 | 视频填充模式。
默认值：Cover
约束：不支持ImageFit类型中的枚举值MATRIX，若设置，则作用效果与Cover一致。
异常值：若设置异常值undefined、null，或不在[ImageFit](ts-appendix-enums.md#imagefit)枚举范围内的值，作用效果均与Cover一致。| ### loop @@ -171,7 +173,7 @@ enableAnalyzer(enable: boolean) | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | -| enable | boolean | 是 | 是否启用AI分析功能
true：开启AI分析功能；false：关闭AI分析功能。
默认值：false | +| enable | boolean | 是 | 是否启用AI分析功能。
true：开启AI分析功能；false：关闭AI分析功能。
默认值：false | > **说明：** > @@ -190,7 +192,7 @@ analyzerConfig(config: ImageAnalyzerConfig) | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | -| config | [ImageAnalyzerConfig](ts-image-common.md#imageanalyzerconfig) | 是 | 设置AI分析识别类型 | +| config | [ImageAnalyzerConfig](ts-image-common.md#imageanalyzerconfig) | 是 | 设置AI分析识别类型。 | ### enableShortcutKey15+ @@ -274,14 +276,14 @@ onError(event: VoidCallback | ErrorCallback) | 参数名 | 类型 | 必填 | 说明 | | ------ | --------------------------------------------- | ---- | ----------------------------------- | -| event | [VoidCallback](ts-types.md#voidcallback12) \| [ErrorCallback](../../apis-basic-services-kit/js-apis-base.md#errorcallback)20+ | 是 | 视频播放失败时的回调函数，[ErrorCallback](../../apis-basic-services-kit/js-apis-base.md#errorcallback)入参用于接收异常信息。
Video组件报错信息请参考以下错误信息的详细介绍，其余错误码请请参考[媒体错误码](../../apis-media-kit/errorcode-media.md)。| +| event | [VoidCallback](ts-types.md#voidcallback12) \| [ErrorCallback](../../apis-basic-services-kit/js-apis-base.md#errorcallback)20+ | 是 | 视频播放失败时的回调函数，[ErrorCallback](../../apis-basic-services-kit/js-apis-base.md#errorcallback)入参用于接收异常信息。| -以下是错误信息的详细介绍。 +以下错误码的详细介绍请参见[Video组件错误码](../errorcode-video.md)，其余错误码请参考[媒体错误码](../../apis-media-kit/errorcode-media.md)。 -|错误码|错误信息|错误描述| -|--|--|--| -|103601 |Failed to create the media player.|播放器创建失败。| -|103602 |Not a valid source.|视频资源设置无效。| +|错误码ID|错误信息| +|--|--| +|103601 |Failed to create the media player.| +|103602 |Not a valid source.| ### onStop12+ @@ -554,6 +556,8 @@ setCurrentTime(value: number, seekMode: SeekMode) ## SeekMode8+枚举说明 +视频跳转模式选项。 + **原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 **系统能力：** SystemCapability.ArkUI.ArkUI.Full @@ -804,12 +808,12 @@ struct Index { @Entry @Component struct video { - @State videoSrc: Resource = $rawfile('rabbit.mp4') - @State previewUri: Resource = $r('app.media.tree') - @State curRate: PlaybackSpeed = PlaybackSpeed.Speed_Forward_1_00_X - @State isAutoPlay: boolean = true - @State showControls: boolean = true - controller: VideoController = new VideoController() + @State videoSrc: Resource = $rawfile('rabbit.mp4'); + @State previewUri: Resource = $r('app.media.tree'); + @State curRate: PlaybackSpeed = PlaybackSpeed.Speed_Forward_1_00_X; + @State isAutoPlay: boolean = true; + @State showControls: boolean = true; + controller: VideoController = new VideoController(); build() { Column() { @@ -866,13 +870,13 @@ struct video { @Entry @Component struct VideoErrorComponent { - @State videoSrc: string = "video.mp4" // 传入不存在的视频资源路径。 - @State curRate: PlaybackSpeed = PlaybackSpeed.Speed_Forward_1_00_X - @State isAutoPlay: boolean = false - @State showControls: boolean = true - @State showFirstFrame: boolean = false - controller: VideoController = new VideoController() - @State errorMessage: string = "" + @State videoSrc: string = "video.mp4"; // 传入不存在的视频资源路径。 + @State curRate: PlaybackSpeed = PlaybackSpeed.Speed_Forward_1_00_X; + @State isAutoPlay: boolean = false; + @State showControls: boolean = true; + @State showFirstFrame: boolean = false; + controller: VideoController = new VideoController(); + @State errorMessage: string = ""; build() { Column() { @@ -968,7 +972,7 @@ struct VideoModifierDemo { @State isAutoPlay: boolean = false; @State showControls: boolean = false; controller: VideoController = new VideoController(); - @State modifier: MyVideoModifier = new MyVideoModifier() + @State modifier: MyVideoModifier = new MyVideoModifier(); build() { Column() { diff --git a/zh-cn/application-dev/reference/apis-arkui/errorcode-video.md b/zh-cn/application-dev/reference/apis-arkui/errorcode-video.md new file mode 100644 index 0000000000000000000000000000000000000000..0e61692f599e9f152335dca9b010eda760bac0e1 --- /dev/null +++ b/zh-cn/application-dev/reference/apis-arkui/errorcode-video.md @@ -0,0 +1,41 @@ +# Video组件错误码 + +> **说明：** +> +> 以下仅介绍本模块特有错误码，通用错误码请参考[通用错误码](../errorcode-universal.md)。 + +## 103601 播放器创建失败 + +**错误信息** + +Failed to create the media player. + +**错误描述** + +播放器创建失败。 + +**可能原因** + +媒体服务不存在，或因内存不足导致创建失败。 + +**处理步骤** + +销毁当前实例，并重新创建，如果重新创建失败，则停止相关操作。 + +## 103602 视频资源设置无效 + +**错误信息** + +Not a valid source. + +**错误描述** + +视频资源设置无效。 + +**可能原因** + +系统找不到资源文件，或资源文件异常。 + +**处理步骤** + +确保资源文件存在且正常，再重新设置Video组件的视频源。 \ No newline at end of file diff --git a/zh-cn/application-dev/website.md b/zh-cn/application-dev/website.md index 25503d8981974cf3991737b41bf30bdfa81010bb..2e7c7bb074283673c24205abb6fbc28485d5333d 100644 --- a/zh-cn/application-dev/website.md +++ b/zh-cn/application-dev/website.md @@ -3294,6 +3294,7 @@ - [用户界面外观服务错误码](reference/apis-arkui/errorcode-uiappearance.md) - [NodeAdapter错误码](reference/apis-arkui/errorcode-nodeadapter.md) - [XComponent组件错误码](reference/apis-arkui/errorcode-xcomponent.md) + - [Video组件错误码](reference/apis-arkui/errorcode-video.md) - UI编译 - [编译错误码](reference/apis-arkui/_ark_ui_compile.md) - 图形图像