华为镜像仓提供的官方Kbox Demo镜像不包含Android Kbox二进制，所以使用该镜像无法正常启动容器。用户使用该Demo镜像时，需要下载Android Kbox二进制到本地，并使用脚本制作可正常启动的Kbox原始镜像。如需使能硬解功能，在挂载Kbox原始镜像后，需继续制作合入NETINT编解码库的Kbox新镜像。
镜像名称+tag |
获取方式 |
使用方法 |
|---|---|---|
用户自行编译 |
用户自行编译 |
请参见软件编译章节自行编译，已包含Android Kbox二进制，容器可正常启动。 |
kbox:demo |
华为镜像仓提供的官方Kbox Demo镜像 |
不包含Android Kbox二进制，容器无法正常启动，需要执行制作Kbox镜像：合入商用二进制步骤。 |
kbox:origin |
使用脚本制作 |
基于kbox:demo和Android Kbox二进制制作的镜像，容器可以正常启动。 |
kbox:latest |
使用脚本制作的硬解镜像 |
基于kbox:origin和编解码库制作的镜像，使能硬解功能，容器可正常启动。 |
Kbox Demo镜像挂载
上传Kbox Demo镜像包至“~/dependency”目录（本文以此目录作为示例，用户可自行设置目录），并挂载。
镜像的名称和tag可以自行定义，格式为“{名称}:{tag}”，此处设置镜像名为kbox:demo。
镜像名以及tag名中只可包含数字与字母，镜像名的首字符必须为小写字母或数字。
1 2 | cd ~/dependency docker import android.tar kbox:demo |
制作Kbox镜像：合入商用二进制
用户使用华为镜像仓提供的官方Kbox Demo镜像时，需要通过该小节的操作确保镜像中包含Android Kbox二进制。
当用户使用自行编译的镜像时：
- 硬件配置方案一：可跳过该小节的全部步骤。
- 硬件配置方案二、三：可跳过该小节的步骤2。
- 解压Kbox-AOSP11.zip，将Kbox-AOSP11文件夹中的deploy_scripts目录上传至服务器的“~/dependency”目录。
- 上传Android Kbox二进制文件包BoostKit-kbox_*.zip到“~/dependency/deploy_scripts”目录。
- （硬件配置方案二、三）使用硬件配置方案二、三时需要解压显卡驱动压缩包VAGPU-25.01.01.04-RC2.tgz，获取va_driver.tgz，上传到服务器的“~/dependency/deploy_scripts”目录。
- 制作包含Android Kbox二进制的Kbox镜像，其中kbox:demo为上一步导入的官方Kbox Demo镜像，kbox:origin为包含Android Kbox二进制的新镜像。
- 硬件配置方案一：
1 2 3
cd ~/dependency/deploy_scripts chmod +x make_image.sh ./make_image.sh kbox:demo kbox:origin
- 硬件配置方案二、三：
1 2 3
cd ~/dependency/deploy_scripts chmod +x make_image.sh ./make_image.sh kbox:demo kbox:origin va_driver.tgz
- 硬件配置方案一：
（硬件配置方案一，可选）制作Kbox镜像：使能硬解功能
若环境中未使用编解码卡则不能制作并使用使能硬解功能的镜像。
- 解压Kbox-AOSP11.zip，将Kbox-AOSP11/make_img_sample目录上传至服务器的“~/dependency”目录。
- 请获取NETINT-vXXX.tar.gz，并重命名为NETINT.tar.gz，放至“~/dependency/make_img_sample/decode_iso_build”目录，对该目录下的制作镜像脚本添加可执行权限。
1 2
cd ~/dependency/make_img_sample/decode_iso_build chmod +x Dockerfile make_image.sh
Quadra编码卡和T432配套的NETINT.tar.gz不同，请选择对应的NETINT.tar.gz。
- 制作硬解镜像。以名为kbox:origin的镜像为基础制作名为kbox:latest的镜像，这两者名称可自定义。
1./make_image.sh kbox:origin kbox:latest
在启动实例时输入的参数需和此处制作的名称、tag保持一致。后文的描述中镜像名以kbox:latest为例。