Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
5b561d9f
D
Docs
项目概览
OpenHarmony
/
Docs
接近 2 年 前同步成功
通知
159
Star
292
Fork
28
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
0
列表
看板
标记
里程碑
合并请求
0
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
D
Docs
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
0
Issue
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
提交
Issue看板
提交
5b561d9f
编写于
8月 17, 2023
作者:
M
magekkkk
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
add changelog for audio apis change
Signed-off-by:
N
magekkkk
<
lixin113@huawei.com
>
上级
1a4f9361
变更
1
隐藏空白更改
内联
并排
Showing
1 changed file
with
70 addition
and
0 deletion
+70
-0
zh-cn/release-notes/changelogs/OpenHarmony_4.0.11.3/changelogs-multimedia.md
.../changelogs/OpenHarmony_4.0.11.3/changelogs-multimedia.md
+70
-0
未找到文件。
zh-cn/release-notes/changelogs/OpenHarmony_4.0.11.3/changelogs-multimedia.md
0 → 100644
浏览文件 @
5b561d9f
# multimedia子系统ChangeLog
## cl.multimedia.1 preferOutputDeviceForRendererInfo系列接口命名变更
对于getPreferOutputDeviceForRendererInfo和对应的on/off订阅接口,命名内preferOutput变更为preferredOutput,与新增的preferredInput相匹配,满足英文翻译要求
**变更影响**
已在Beta版本发布的ts接口,影响使用此三方应用的兼容性。
**关键的接口/组件变更**
修改前的接口原型:
```
ts
getPreferOutputDeviceForRendererInfo
(
rendererInfo
:
AudioRendererInfo
,
callback
:
AsyncCallback
<
AudioDeviceDescriptors
>
):
void
;
getPreferOutputDeviceForRendererInfo
(
rendererInfo
:
AudioRendererInfo
):
Promise
<
AudioDeviceDescriptors
>
;
on
(
type
:
'
preferOutputDeviceChangeForRendererInfo
'
,
rendererInfo
:
AudioRendererInfo
,
callback
:
Callback
<
AudioDeviceDescriptors
>
):
void
;
off
(
type
:
'
preferOutputDeviceChangeForRendererInfo
'
,
callback
?:
Callback
<
AudioDeviceDescriptors
>
):
void
;
```
修改后的接口原型:
```
ts
getPreferredOutputDeviceForRendererInfo
(
rendererInfo
:
AudioRendererInfo
,
callback
:
AsyncCallback
<
AudioDeviceDescriptors
>
):
void
;
getPreferredOutputDeviceForRendererInfo
(
rendererInfo
:
AudioRendererInfo
):
Promise
<
AudioDeviceDescriptors
>
;
on
(
type
:
'
preferredOutputDeviceChangeForRendererInfo
'
,
rendererInfo
:
AudioRendererInfo
,
callback
:
Callback
<
AudioDeviceDescriptors
>
):
void
;
off
(
type
:
'
preferredOutputDeviceChangeForRendererInfo
'
,
callback
?:
Callback
<
AudioDeviceDescriptors
>
):
void
;
```
**适配指导**
修改后开发者调用该接口时,需要使用修改后的接口命名定义。
系统会暂时兼容两种命名方式的接口调用,但建议在使用新版本SDK后立即修改适配。
## cl.multimedia.2 @ohos.multimedia.audio.d.ts内带入参的API10接口新增错误码声明
**变更影响**
携带入参的接口,当开发者参数类型或数量传错情况下,接口会同步抛出401错误码的异常,当参数值不符合取值范围,当接口为同步接口,会抛出相应错误码的异常,当接口为异步接口,会通过异步error返回错误码。
如果接口使用符合定义要求,则无兼容性影响。
**关键的接口/组件变更**
涉及新增错误声明的接口:
```
ts
getPreferredOutputDeviceForRendererInfo
(
rendererInfo
:
AudioRendererInfo
,
callback
:
AsyncCallback
<
AudioDeviceDescriptors
>
):
void
;
getPreferredOutputDeviceForRendererInfo
(
rendererInfo
:
AudioRendererInfo
):
Promise
<
AudioDeviceDescriptors
>
;
on
(
type
:
'
preferredOutputDeviceChangeForRendererInfo
'
,
rendererInfo
:
AudioRendererInfo
,
callback
:
Callback
<
AudioDeviceDescriptors
>
):
void
;
off
(
type
:
'
preferredOutputDeviceChangeForRendererInfo
'
,
callback
?:
Callback
<
AudioDeviceDescriptors
>
):
void
;
setAudioEffectMode
(
mode
:
AudioEffectMode
,
callback
:
AsyncCallback
<
void
>
):
void
;
setAudioEffectMode
(
mode
:
AudioEffectMode
):
Promise
<
void
>
;
```
涉及新增的错误码类型:
```
ts
// 入参类型或数量缺少
@
throws
{
BusinessError
}
401
-
If
input
parameter
type
or
number
mismatch
.
// 入参值不符合取值范围
@
throws
{
BusinessError
}
6800101
-
Invalid
parameter
error
.
// 系统通用内部错误
@
throws
{
BusinessError
}
6800301
-
System
error
.
```
**适配指导**
接口使用时,当发现抛出错误码为401的异常,开发者需要检查传入的参数类型和数量是否符合接口定义。
当发现接口异步返回了错误,可以根据错误码,检查接口错误的原因,进行合理的异常处置。
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录