From 1503eaf6a06b37b684bf82a0da5e0c6c5407eae0 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E9=A9=AC=E5=BF=97=E5=AE=9D?= Date: Thu, 26 Jun 2025 10:22:42 +0800 Subject: [PATCH 1/5] =?UTF-8?q?=E8=A7=86=E9=A2=91mv=E5=BC=80=E5=85=B3?= =?UTF-8?q?=E9=9C=80=E6=B1=82=E5=A2=9E=E5=8A=A0keepDecodingOnMute=E6=8E=A5?= =?UTF-8?q?=E5=8F=A3=EF=BC=8C=E4=BF=AE=E6=94=B9setMediaMute=E5=92=8CmutedM?= =?UTF-8?q?ediaType=E8=AF=B4=E6=98=8E?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Change-Id: I6ce446f7c0c464fc83efdb144d3d44eccafd02dd Signed-off-by: 马志宝 --- .../reference/apis-media-kit/js-apis-media.md | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/zh-cn/application-dev/reference/apis-media-kit/js-apis-media.md b/zh-cn/application-dev/reference/apis-media-kit/js-apis-media.md index 707b747241a..8c57e9d2cf2 100644 --- a/zh-cn/application-dev/reference/apis-media-kit/js-apis-media.md +++ b/zh-cn/application-dev/reference/apis-media-kit/js-apis-media.md @@ -1054,7 +1054,7 @@ avPlayer.prepare().then(() => { setMediaMuted(mediaType: MediaType, muted: boolean ): Promise\ -设置音频静音/取消音频静音。只能在prepared/playing/paused/completed状态下调用。仅支持设置mediaType为音频格式。 +设置音频静音/取消音频静音, 视频画面关闭/恢复。只能在prepared/playing/paused/completed状态下调用。 **原子化服务API：** 从API version 12开始，该接口支持在原子化服务中使用。 @@ -1065,7 +1065,7 @@ setMediaMuted(mediaType: MediaType, muted: boolean ): Promise\ | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | ---- | -------------------- | | mediaType | [MediaType](#mediatype8) | 是 | 播放策略。 | -| muted | boolean | 是 | 是否静音播放。true表示是静音播放，false表示不是静音播放。| +| muted | boolean | 是 音频是否静音播放。true表示是静音播放，false表示不是静音播放。 视频画面是否关闭， true表示关闭画面， false表示恢复画面 | **返回值：** @@ -8676,11 +8676,12 @@ request.finishLoading(uuid, loadingError); | preferredHdr | boolean | 否 | 播放策略true是hdr，false非hdr，默认非hdr。
**原子化服务API：** 从API version 12开始，该接口支持在原子化服务中使用。 | | enableSuperResolution18+ | boolean | 否 | 表示是否使能超分功能。true表示使能超分，false表示不使能超分，默认为false。
若不使能超分，则后续不能调用超分相关接口。若使能超分，则超分功能默认开启，默认目标分辨率为1920x1080，单位为像素。
**原子化服务API：** 从API version 18开始，该接口支持在原子化服务中使用。 | | showFirstFrameOnPrepare17+ | boolean | 否 | 播放策略true是Prepare之后显示视频起播首帧，false是Prepare之后不显示视频起播首帧，默认不显示。
**原子化服务API：** 从API version 17开始，该接口支持在原子化服务中使用。 | -| mutedMediaType | [MediaType](#mediatype8) | 否 | 静音播放的媒体类型，仅支持设置 MediaType.MEDIA_TYPE_AUD。 | +| mutedMediaType | [MediaType](#mediatype8) | 否 | 关闭输出的媒体类型，支持设置 MediaType.MEDIA_TYPE_AUD和MediaType.MEDIA_TYPE_VID | | preferredAudioLanguage13+ | string | 否 | 播放策略首选音轨语言。dash场景下应用可按需设置。非dash场景暂不支持，建议缺省。
**原子化服务API：** 从API version 13开始，该接口支持在原子化服务中使用。 | | preferredSubtitleLanguage13+ | string | 否 | 播放策略首选字幕语言。dash场景下应用可按需设置。非dash场景暂不支持，建议缺省。
**原子化服务API：** 从API version 13开始，该接口支持在原子化服务中使用。 | | preferredBufferDurationForPlaying18+ | number | 否 | 播放策略首选起播缓冲水线。当起播缓冲时间超过该值，开始播放。单位s，取值范围0-20。
**原子化服务API：** 从API version 18开始，该接口支持在原子化服务中使用。 | | thresholdForAutoQuickPlay18+ | number | 否 | 智能追帧水线，单位为s，取值应不小于2s，且需大于起播缓冲水线，默认设置为5s。
播放策略可以通过设置智能追帧水线来保证直播的实时性。flv直播场景下应用可按需设置，非flv直播场景暂不支持。网络状态的变化可能会导致播放器在某段时间内积压大量数据。播放器会定期检查当前播放时间与缓存中最新的帧时间戳之间的差值，当这个差值过大时，播放器将以1.2倍速开始智能追帧。[speedDone事件](#onspeeddone9)会回调特定值100，表示智能追帧开启成功。当差值小于起播缓冲水线时，则停止追帧并恢复到正常播放速度。
**原子化服务API：** 从API version 18开始，该接口支持在原子化服务中使用。 | +| keepDecodingOnMute20+ | boolean | 否 | 表示在关闭视频媒体时解码器是否继续运行，用于方便快速打开媒体。目前仅支持视频。默认设置为false,表示当媒体关闭时，相应的解码器将停止运行，以减少功耗。
**原子化服务API：** 从API version 20开始，该接口支持在原子化服务中使用。 | ## AVScreenCaptureRecordPreset12+ -- Gitee From f019bea5391d7b10b1ea863ac4a738f74af87e0e Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E9=A9=AC=E5=BF=97=E5=AE=9D?= Date: Sat, 28 Jun 2025 14:22:21 +0800 Subject: [PATCH 2/5] =?UTF-8?q?=E8=A7=86=E9=A2=91mv=E5=BC=80=E5=85=B3?= =?UTF-8?q?=E9=9C=80=E6=B1=82=E5=A2=9E=E5=8A=A0keepDecodingOnMute=E6=8E=A5?= =?UTF-8?q?=E5=8F=A3=EF=BC=8C=E4=BF=AE=E6=94=B9setMediaMute=E5=92=8CmutedM?= =?UTF-8?q?ediaType=E8=AF=B4=E6=98=8E?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Change-Id: I5c97d3ce1eb681a7d4e79fdd0aaa1c3b87ed0108 Signed-off-by: 马志宝 --- .../application-dev/reference/apis-media-kit/js-apis-media.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/zh-cn/application-dev/reference/apis-media-kit/js-apis-media.md b/zh-cn/application-dev/reference/apis-media-kit/js-apis-media.md index 8c57e9d2cf2..e71cdd29593 100644 --- a/zh-cn/application-dev/reference/apis-media-kit/js-apis-media.md +++ b/zh-cn/application-dev/reference/apis-media-kit/js-apis-media.md @@ -1054,7 +1054,7 @@ avPlayer.prepare().then(() => { setMediaMuted(mediaType: MediaType, muted: boolean ): Promise\ -设置音频静音/取消音频静音, 视频画面关闭/恢复。只能在prepared/playing/paused/completed状态下调用。 +设置音频静音/取消音频静音。只能在prepared/playing/paused/completed状态下调用。 API20及之后版本支持视频画面关闭和恢复。 **原子化服务API：** 从API version 12开始，该接口支持在原子化服务中使用。 @@ -1065,7 +1065,7 @@ setMediaMuted(mediaType: MediaType, muted: boolean ): Promise\ | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | ---- | -------------------- | | mediaType | [MediaType](#mediatype8) | 是 | 播放策略。 | -| muted | boolean | 是 音频是否静音播放。true表示是静音播放，false表示不是静音播放。 视频画面是否关闭， true表示关闭画面， false表示恢复画面 | +| muted | boolean | 是 | 音频是否静音播放。true表示是静音播放，false表示不是静音播放。 （API20及之后版本支持视频类型）视频画面是否关闭， true表示关闭画面， false表示恢复画面 | **返回值：** -- Gitee From 3a7a68743dea25272b68e6f98541f2a6e0c46dc9 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E9=A9=AC=E5=BF=97=E5=AE=9D?= Date: Sat, 28 Jun 2025 15:17:48 +0800 Subject: [PATCH 3/5] =?UTF-8?q?Revert=20"=E8=A7=86=E9=A2=91mv=E5=BC=80?= =?UTF-8?q?=E5=85=B3=E9=9C=80=E6=B1=82=E5=A2=9E=E5=8A=A0keepDecodingOnMute?= =?UTF-8?q?=E6=8E=A5=E5=8F=A3=EF=BC=8C=E4=BF=AE=E6=94=B9setMediaMute?= =?UTF-8?q?=E5=92=8CmutedMediaType=E8=AF=B4=E6=98=8E"?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit This reverts commit f019bea5391d7b10b1ea863ac4a738f74af87e0e. --- .../application-dev/reference/apis-media-kit/js-apis-media.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/zh-cn/application-dev/reference/apis-media-kit/js-apis-media.md b/zh-cn/application-dev/reference/apis-media-kit/js-apis-media.md index e71cdd29593..8c57e9d2cf2 100644 --- a/zh-cn/application-dev/reference/apis-media-kit/js-apis-media.md +++ b/zh-cn/application-dev/reference/apis-media-kit/js-apis-media.md @@ -1054,7 +1054,7 @@ avPlayer.prepare().then(() => { setMediaMuted(mediaType: MediaType, muted: boolean ): Promise\ -设置音频静音/取消音频静音。只能在prepared/playing/paused/completed状态下调用。 API20及之后版本支持视频画面关闭和恢复。 +设置音频静音/取消音频静音, 视频画面关闭/恢复。只能在prepared/playing/paused/completed状态下调用。 **原子化服务API：** 从API version 12开始，该接口支持在原子化服务中使用。 @@ -1065,7 +1065,7 @@ setMediaMuted(mediaType: MediaType, muted: boolean ): Promise\ | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | ---- | -------------------- | | mediaType | [MediaType](#mediatype8) | 是 | 播放策略。 | -| muted | boolean | 是 | 音频是否静音播放。true表示是静音播放，false表示不是静音播放。 （API20及之后版本支持视频类型）视频画面是否关闭， true表示关闭画面， false表示恢复画面 | +| muted | boolean | 是 音频是否静音播放。true表示是静音播放，false表示不是静音播放。 视频画面是否关闭， true表示关闭画面， false表示恢复画面 | **返回值：** -- Gitee From ba90f9252cd6e0ce1e1c5c68c3e2f31769bf5ed8 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E9=A9=AC=E5=BF=97=E5=AE=9D?= Date: Sat, 28 Jun 2025 15:17:50 +0800 Subject: [PATCH 4/5] =?UTF-8?q?Revert=20"=E8=A7=86=E9=A2=91mv=E5=BC=80?= =?UTF-8?q?=E5=85=B3=E9=9C=80=E6=B1=82=E5=A2=9E=E5=8A=A0keepDecodingOnMute?= =?UTF-8?q?=E6=8E=A5=E5=8F=A3=EF=BC=8C=E4=BF=AE=E6=94=B9setMediaMute?= =?UTF-8?q?=E5=92=8CmutedMediaType=E8=AF=B4=E6=98=8E"?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit This reverts commit 1503eaf6a06b37b684bf82a0da5e0c6c5407eae0. --- .../reference/apis-media-kit/js-apis-media.md | 7 +++---- 1 file changed, 3 insertions(+), 4 deletions(-) diff --git a/zh-cn/application-dev/reference/apis-media-kit/js-apis-media.md b/zh-cn/application-dev/reference/apis-media-kit/js-apis-media.md index 8c57e9d2cf2..707b747241a 100644 --- a/zh-cn/application-dev/reference/apis-media-kit/js-apis-media.md +++ b/zh-cn/application-dev/reference/apis-media-kit/js-apis-media.md @@ -1054,7 +1054,7 @@ avPlayer.prepare().then(() => { setMediaMuted(mediaType: MediaType, muted: boolean ): Promise\ -设置音频静音/取消音频静音, 视频画面关闭/恢复。只能在prepared/playing/paused/completed状态下调用。 +设置音频静音/取消音频静音。只能在prepared/playing/paused/completed状态下调用。仅支持设置mediaType为音频格式。 **原子化服务API：** 从API version 12开始，该接口支持在原子化服务中使用。 @@ -1065,7 +1065,7 @@ setMediaMuted(mediaType: MediaType, muted: boolean ): Promise\ | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | ---- | -------------------- | | mediaType | [MediaType](#mediatype8) | 是 | 播放策略。 | -| muted | boolean | 是 音频是否静音播放。true表示是静音播放，false表示不是静音播放。 视频画面是否关闭， true表示关闭画面， false表示恢复画面 | +| muted | boolean | 是 | 是否静音播放。true表示是静音播放，false表示不是静音播放。| **返回值：** @@ -8676,12 +8676,11 @@ request.finishLoading(uuid, loadingError); | preferredHdr | boolean | 否 | 播放策略true是hdr，false非hdr，默认非hdr。
**原子化服务API：** 从API version 12开始，该接口支持在原子化服务中使用。 | | enableSuperResolution18+ | boolean | 否 | 表示是否使能超分功能。true表示使能超分，false表示不使能超分，默认为false。
若不使能超分，则后续不能调用超分相关接口。若使能超分，则超分功能默认开启，默认目标分辨率为1920x1080，单位为像素。
**原子化服务API：** 从API version 18开始，该接口支持在原子化服务中使用。 | | showFirstFrameOnPrepare17+ | boolean | 否 | 播放策略true是Prepare之后显示视频起播首帧，false是Prepare之后不显示视频起播首帧，默认不显示。
**原子化服务API：** 从API version 17开始，该接口支持在原子化服务中使用。 | -| mutedMediaType | [MediaType](#mediatype8) | 否 | 关闭输出的媒体类型，支持设置 MediaType.MEDIA_TYPE_AUD和MediaType.MEDIA_TYPE_VID | +| mutedMediaType | [MediaType](#mediatype8) | 否 | 静音播放的媒体类型，仅支持设置 MediaType.MEDIA_TYPE_AUD。 | | preferredAudioLanguage13+ | string | 否 | 播放策略首选音轨语言。dash场景下应用可按需设置。非dash场景暂不支持，建议缺省。
**原子化服务API：** 从API version 13开始，该接口支持在原子化服务中使用。 | | preferredSubtitleLanguage13+ | string | 否 | 播放策略首选字幕语言。dash场景下应用可按需设置。非dash场景暂不支持，建议缺省。
**原子化服务API：** 从API version 13开始，该接口支持在原子化服务中使用。 | | preferredBufferDurationForPlaying18+ | number | 否 | 播放策略首选起播缓冲水线。当起播缓冲时间超过该值，开始播放。单位s，取值范围0-20。
**原子化服务API：** 从API version 18开始，该接口支持在原子化服务中使用。 | | thresholdForAutoQuickPlay18+ | number | 否 | 智能追帧水线，单位为s，取值应不小于2s，且需大于起播缓冲水线，默认设置为5s。
播放策略可以通过设置智能追帧水线来保证直播的实时性。flv直播场景下应用可按需设置，非flv直播场景暂不支持。网络状态的变化可能会导致播放器在某段时间内积压大量数据。播放器会定期检查当前播放时间与缓存中最新的帧时间戳之间的差值，当这个差值过大时，播放器将以1.2倍速开始智能追帧。[speedDone事件](#onspeeddone9)会回调特定值100，表示智能追帧开启成功。当差值小于起播缓冲水线时，则停止追帧并恢复到正常播放速度。
**原子化服务API：** 从API version 18开始，该接口支持在原子化服务中使用。 | -| keepDecodingOnMute20+ | boolean | 否 | 表示在关闭视频媒体时解码器是否继续运行，用于方便快速打开媒体。目前仅支持视频。默认设置为false,表示当媒体关闭时，相应的解码器将停止运行，以减少功耗。
**原子化服务API：** 从API version 20开始，该接口支持在原子化服务中使用。 | ## AVScreenCaptureRecordPreset12+ -- Gitee From 3fcd724089adc9863bcf033a5b6fa3394a7cb7be Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E9=A9=AC=E5=BF=97=E5=AE=9D?= Date: Sat, 28 Jun 2025 15:38:11 +0800 Subject: [PATCH 5/5] =?UTF-8?q?=E8=A7=86=E9=A2=91mv=E5=BC=80=E5=85=B3?= =?UTF-8?q?=E9=9C=80=E6=B1=82=E5=A2=9E=E5=8A=A0keepDecodingOnMute=E6=8E=A5?= =?UTF-8?q?=E5=8F=A3=EF=BC=8C=E4=BF=AE=E6=94=B9setMediaMute=E5=92=8CmutedM?= =?UTF-8?q?ediaType=E8=AF=B4=E6=98=8E?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Change-Id: I4aae1d6e1219bec15f1a71dda054867133ee3b9e Signed-off-by: 马志宝 --- .../reference/apis-media-kit/arkts-apis-media-AVPlayer.md | 4 ++-- .../reference/apis-media-kit/arkts-apis-media-i.md | 4 ++-- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/zh-cn/application-dev/reference/apis-media-kit/arkts-apis-media-AVPlayer.md b/zh-cn/application-dev/reference/apis-media-kit/arkts-apis-media-AVPlayer.md index b0e5aead88c..572fc18021a 100644 --- a/zh-cn/application-dev/reference/apis-media-kit/arkts-apis-media-AVPlayer.md +++ b/zh-cn/application-dev/reference/apis-media-kit/arkts-apis-media-AVPlayer.md @@ -423,7 +423,7 @@ avPlayer.prepare().then(() => { setMediaMuted(mediaType: MediaType, muted: boolean ): Promise\ -设置音频静音/取消音频静音。只能在prepared/playing/paused/completed状态下调用。仅支持设置mediaType为音频格式。 +设置音频静音/取消音频静音。 从API 20开始，支持设置关闭视频画面/取消关闭视频画面。 只能在prepared/playing/paused/completed状态下调用。 **原子化服务API：** 从API version 12开始，该接口支持在原子化服务中使用。 @@ -434,7 +434,7 @@ setMediaMuted(mediaType: MediaType, muted: boolean ): Promise\ | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | ---- | -------------------- | | mediaType | [MediaType](arkts-apis-media-e.md#mediatype8) | 是 | 播放策略。 | -| muted | boolean | 是 | 是否静音播放。true表示是静音播放，false表示不是静音播放。| +| muted | boolean | 是 | API 12-19，仅支持设置音频格式，表示音频是否静音播放。true表示是静音播放，false表示不是静音播放。
API20增加支持设置视频格式，表示视频画面是否关闭，true表示关闭画面，false表示恢复画面。| **返回值：** diff --git a/zh-cn/application-dev/reference/apis-media-kit/arkts-apis-media-i.md b/zh-cn/application-dev/reference/apis-media-kit/arkts-apis-media-i.md index 0bc3a066ab5..572ab5cd61a 100644 --- a/zh-cn/application-dev/reference/apis-media-kit/arkts-apis-media-i.md +++ b/zh-cn/application-dev/reference/apis-media-kit/arkts-apis-media-i.md @@ -351,12 +351,12 @@ async function setupPlayer() { | preferredHdr | boolean | 否 | 播放策略true是hdr，false非hdr，默认非hdr。
**原子化服务API：** 从API version 12开始，该接口支持在原子化服务中使用。 | | enableSuperResolution18+ | boolean | 否 | 表示是否使能超分功能。true表示使能超分，false表示不使能超分，默认为false。
若不使能超分，则后续不能调用超分相关接口。若使能超分，则超分功能默认开启，默认目标分辨率为1920x1080，单位为像素。
**原子化服务API：** 从API version 18开始，该接口支持在原子化服务中使用。 | | showFirstFrameOnPrepare17+ | boolean | 否 | 播放策略true是Prepare之后显示视频起播首帧，false是Prepare之后不显示视频起播首帧，默认不显示。
**原子化服务API：** 从API version 17开始，该接口支持在原子化服务中使用。 | -| mutedMediaType | [MediaType](arkts-apis-media-e.md#mediatype8) | 否 | 静音播放的媒体类型，仅支持设置 MediaType.MEDIA_TYPE_AUD。 | +| mutedMediaType | [MediaType](arkts-apis-media-e.md#mediatype8) | 否 | 关闭输出的媒体类型。
API 12-19，仅支持设置MediaType.MEDIA_TYPE_AUD。API 20起，增加支持MediaType.MEDIA_TYPE_VID。 | | preferredAudioLanguage13+ | string | 否 | 播放策略首选音轨语言。dash场景下应用可按需设置。非dash场景暂不支持，建议缺省。
**原子化服务API：** 从API version 13开始，该接口支持在原子化服务中使用。 | | preferredSubtitleLanguage13+ | string | 否 | 播放策略首选字幕语言。dash场景下应用可按需设置。非dash场景暂不支持，建议缺省。
**原子化服务API：** 从API version 13开始，该接口支持在原子化服务中使用。 | | preferredBufferDurationForPlaying18+ | number | 否 | 播放策略首选起播缓冲水线。当起播缓冲时间超过该值，开始播放。单位s，取值范围0-20。
**原子化服务API：** 从API version 18开始，该接口支持在原子化服务中使用。 | | thresholdForAutoQuickPlay18+ | number | 否 | 智能追帧水线，单位为s，取值应不小于2s，且需大于起播缓冲水线，默认设置为5s。
播放策略可以通过设置智能追帧水线来保证直播的实时性。flv直播场景下应用可按需设置，非flv直播场景暂不支持。网络状态的变化可能会导致播放器在某段时间内积压大量数据。播放器会定期检查当前播放时间与缓存中最新的帧时间戳之间的差值，当这个差值过大时，播放器将以1.2倍速开始智能追帧。[speedDone事件](arkts-apis-media-AVPlayer.md#onspeeddone9)会回调特定值100，表示智能追帧开启成功。当差值小于起播缓冲水线时，则停止追帧并恢复到正常播放速度。
**原子化服务API：** 从API version 18开始，该接口支持在原子化服务中使用。 | - +| keepDecodingOnMute20+ | boolean | 否 | 表示在关闭视频媒体时解码器是否继续运行，用于方便快速打开媒体。目前仅支持视频。默认设置为false，表示当媒体关闭时，相应的解码器将停止运行以减少功耗。
**原子化服务API：** 从API version 20开始，该接口支持在原子化服务中使用。 | ## AVScreenCaptureStrategy20+ 录屏策略。 -- Gitee