openharmony/third_party_dav1d
1
0
Fork 0
mirror of https://github.com/openharmony/third_party_dav1d.git synced 2026-07-01 03:23:19 -04:00
Code Issues Packages Projects Releases Wiki Activity

readme修改，增加syscap说明

Browse Source 
Signed-off-by: ulimax_001 <wangwei234@huawei.com>
This commit is contained in:
ulimax_001
2026-02-10 20:25:16 +08:00
parent 1bd7377b73
commit b5db24c568
1 changed files with 52 additions and 8 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README_zh.md
+52 -8
View File
@@ -19,12 +19,14 @@ dav1d来源：https://code.videolan.org/videolan/dav1d
## OpenHarmony对解码器的要求
根据[OpenHarmony产品兼容性规范](https://www.openharmony.cn/systematic)：
(1) 若支持AV1软件解码时，AV1解码建议规格至少为1080p (Main Profile(8bit、10bit)、High Profile(8bit、10bit)， Level 4.0)。
(1) AV1软件解码为可选能力。
(2) 若支持AV1软件解码时，AV1解码建议规格至少为1080p (Main Profile(8bit、10bit)、High Profile(8bit、10bit)，Level 4.0)。
## OpenHarmony如何使用dav1d
部件AVCodec为OpenHarmony提供了统一的视频解码能力，参考[AVCodec 框架图](https://gitcode.com/openharmony/multimedia_av_codec/blob/master/README_zh.md)，其中：
(1) 框架层的编解码框架对应用开发者提供接口，例如：[获取支持的编解码能力](https://gitcode.com/openharmony/docs/blob/master/zh-cn/application-dev/media/avcodec/obtain-supported-codecs.md)， [查询编解码档次和级别支持情况](https://gitcode.com/openharmony/docs/blob/master/zh-cn/application-dev/media/avcodec/obtain-supported-codecs.md#%E6%9F%A5%E8%AF%A2%E7%BC%96%E8%A7%A3%E7%A0%81%E6%A1%A3%E6%AC%A1%E5%92%8C%E7%BA%A7%E5%88%AB%E6%94%AF%E6%8C%81%E6%83%85%E5%86%B5)。
(1) 框架层的编解码框架对应用开发者提供接口，例如：[获取支持的编解码能力](https://gitcode.com/openharmony/docs/blob/master/zh-cn/application-dev/media/avcodec/obtain-supported-codecs.md)，[查询编解码档次和级别支持情况](https://gitcode.com/openharmony/docs/blob/master/zh-cn/application-dev/media/avcodec/obtain-supported-codecs.md#%E6%9F%A5%E8%AF%A2%E7%BC%96%E8%A7%A3%E7%A0%81%E6%A1%A3%E6%AC%A1%E5%92%8C%E7%BA%A7%E5%88%AB%E6%94%AF%E6%8C%81%E6%83%85%E5%86%B5)。
(2) 服务层中的软件解码器模块将对dav1d进行加载和封装。
@@ -32,14 +34,24 @@ dav1d来源：https://code.videolan.org/videolan/dav1d
部件AVCodec通过feature配置的方式来使能AV1软解码。
(1) 声明：AVCodec仓的[bundle.json](https://gitcode.com/openharmony/multimedia_av_codec/blob/master/bundle.json)里声明的features：av_codec_support_av1_decoder用于使能AV1软解码。
(1) 声明：AVCodec仓的[bundle.json](https://gitcode.com/openharmony/multimedia_av_codec/blob/master/bundle.json)里声明的features：`av_codec_support_av1_decoder`用于使能AV1软解码。
```json
"component": {
"name": "av_codec",
"subsystem": "multimedia",
"features": [
"av_codec_support_av1_decoder"
]
}
```
(2) 定义与赋值：多条件判断是否使能AV1解码器。
(2) 定义与赋值：多条件判断是否使能AV1解码器(av_codec_support_av1_decoder)。
* 在AVCodec仓[Config.gni](https://gitcode.com/openharmony/multimedia_av_codec/blob/master/config.gni)中通过declare_args()定义并默认使能AV1软解码。
* 产品配置feature的值会覆盖上述默认值，参考[产品如何配置部件的feautre](https://gitcode.com/openharmony/build/blob/master/docs/%E9%83%A8%E4%BB%B6%E5%8C%96%E7%BC%96%E8%AF%91%E6%9C%80%E4%BD%B3%E5%AE%9E%E8%B7%B5.md#11-%E4%BA%A7%E5%93%81%E5%A6%82%E4%BD%95%E9%85%8D%E7%BD%AE%E9%83%A8%E4%BB%B6%E7%9A%84feature)。
* 产品配置feature的值会覆盖上述默认值，参考[产品如何配置部件的feature](https://gitcode.com/openharmony/build/blob/master/docs/%E9%83%A8%E4%BB%B6%E5%8C%96%E7%BC%96%E8%AF%91%E6%9C%80%E4%BD%B3%E5%AE%9E%E8%B7%B5.md#11-%E4%BA%A7%E5%93%81%E5%A6%82%E4%BD%95%E9%85%8D%E7%BD%AE%E9%83%A8%E4%BB%B6%E7%9A%84feature)。
* AVCodec仓的[Config.gni](https://gitcode.com/openharmony/multimedia_av_codec/blob/master/config.gni)会校验部件dav1d是否装配。如果部件[未装配](https://gitcode.com/openharmony/build/blob/master/docs/%E9%83%A8%E4%BB%B6%E5%8C%96%E7%BC%96%E8%AF%91%E6%9C%80%E4%BD%B3%E5%AE%9E%E8%B7%B5.md)，则不使能AV1软解码。
```
* 另，使能AV1解码器时，则定义宏`SUPPORT_CODEC_AV1`，通过该宏在实际代码中控制创建AV1解码器等逻辑。
```gn
// Config.gni
declare_args() {
// 初始化true，表示默认开启AV1软解码
@@ -50,10 +62,15 @@ declare_args() {
if (!defined(global_parts_info) || !defined(global_parts_info.multimedia_dav1d)) {
av_codec_support_av1_decoder = false
}
// 开启AV1解码器时，定义宏SUPPORT_CODEC_AV1
if (av_codec_support_av1_decoder) {
av_codec_defines += ["SUPPORT_CODEC_AV1"]
}
```
(3) 使用：AVCodec仓的[BUILD.gn](https://gitcode.com/openharmony/multimedia_av_codec/blob/master/services/engine/codec/video/BUILD.gn)通过判断是否使能AV1解码器来决定是否引用部件dav1d，以集成并使用其AV1的解码能力。
```
```gn
// BUILD.gn
if (av_codec_support_av1_decoder) {
external_deps += ["dav1d:dav1d_ohos"]
@@ -88,7 +105,8 @@ if (av_codec_support_av1_decoder) {
+-----------------+
图1 AVCodec服务层AV1软件解码器创建示意图
```
(1) AVCodec服务层中CodecServer通过[CodecFactory](https://gitcode.com/openharmony/multimedia_av_codec/blob/master/services/services/codec/server/video/codec_factory.cpp)，调用AV1DecoderLoader的静态方法CreateByName()创建AV1的解码器(`AV1Decoder`)。
(1) AVCodec服务层中CodecServer通过[CodecFactory](https://gitcode.com/openharmony/multimedia_av_codec/blob/master/services/services/codec/server/video/codec_factory.cpp)创建AV1解码器。
* 若宏开关`SUPPORT_CODEC_AV1`已定义则通过`AV1DecoderLoader::CreateByName()`创建AV1解码器(`AV1Decoder`)；如果宏开关未定义，则创建解码器失败
(2) `AV1Decoder`即是对**dav1d**中AV1解码器的封装，实现能力查询函数GetCodecCapability(std::vector<CapabilityData> &capaArray)，即实现对包括Profile与Level在内的能力信息查询。
@@ -188,5 +206,31 @@ void Av1Decoder::GetCodecCapability(std::vector<CapabilityData> &capaArray)
(3) 另外，dav1d仅适用于软件解码。对`硬件解码`场景：服务层CodecFactory调用`HCodecLoader`的静态方法CreateByName()创建HCodec/HCodecList，它们通过HDI接口调用HAL或硬件解码器，厂商需适配并满足`HDI`接口的要求。
## 应用如何使用dav1d
(1) 应用开发者通过AVCodec Kit使用AV1软件解码器，详情见开发指南[AVCodec Kit](https://gitcode.com/openharmony/docs/blob/master/zh-cn/application-dev/media/avcodec/Readme-CN.md)。
(2) 此外，AVCodec声明的`Syscap`（系统能力）如下，其中`SystemCapability.Multimedia.Media.VideoDecoder`为使能AV1解码器的应支持的系统能力，应用开发者可以通过Native API：`canIUse()`（参考[系统能力使用指南](https://gitcode.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/syscap.md)）查询设备是否具备该系统能力：
```json
"component": {
"name": "av_codec",
"subsystem": "multimedia",
"syscap": [
"SystemCapability.Multimedia.Media.Muxer",
"SystemCapability.Multimedia.Media.Spliter",
"SystemCapability.Multimedia.Media.AudioCodec",
"SystemCapability.Multimedia.Media.AudioDecoder",
"SystemCapability.Multimedia.Media.AudioEncoder",
"SystemCapability.Multimedia.Media.VideoDecoder",
"SystemCapability.Multimedia.Media.VideoEncoder",
"SystemCapability.Multimedia.Media.CodecBase"
],
"features": [
"av_codec_support_av1_decoder"
]
}
```
## License
具体许可条款请参见仓库根目录下的 LICENSE 文件。