简介
libogg是Ogg容器格式库,支持创建、解码和使用Ogg比特流。
此文件是OggVorbis软件编解码器源代码的一部分。
下载安装
直接在OpenHarmony-SIG仓中搜索libogg并下载。
使用说明
以OpenHarmony 3.1 Beta的rk3568版本为例
- 将下载的libogg库代码存在以下路径:./third_party/libogg
- 修改添加依赖的编译脚本,路径:/developtools/bytrace_standard/ohos.build
{
"subsystem": "developtools",
"parts": {
"bytrace_standard": {
"module_list": [
"//developtools/bytrace_standard/interfaces/innerkits/native:bytrace_core",
"//developtools/bytrace_standard/bin:bytrace_target",
"//developtools/bytrace_standard/bin:bytrace.cfg",
"//developtools/bytrace_standard/interfaces/kits/js/napi:bytrace",
"//third_party/libogg:libogg"
],
"inner_kits": [
{
"type": "so",
"name": "//developtools/bytrace_standard/interfaces/innerkits/native:bytrace_core",
"header": {
"header_files": [
"bytrace.h"
],
"header_base": "//developtools/bytrace_standard/interfaces/innerkits/native/include"
}
}
],
"test_list": [
"//developtools/bytrace_standard/bin/test:unittest"
]
}
}
}
- 编译:./ --product-name rk3568 --ccache
- 生成库文件和一些可执行测试文件,路径:out/rk3568/developtools/profiler
接口说明
- 使用Ogg bitpacking函数初始化为写入的oggpack缓冲区:
oggpack_writeinit()
- 检查先前使用Ogg bitpacking函数初始化为写入的oggpack缓冲区的就绪状态:
oggpack_writecheck()
- 将oggpack缓冲区的内容重置为其原始状态:
oggpack_reset()
- 截断已写入oggpack缓冲区的数据:
oggpack_writetrunc()
- 将oggpack缓冲区中的零填充到下一个字节边界:
oggpack_writealign()
- 将位序列从源缓冲区复制到oggpack缓冲区:
oggpack_writecopy()
- 在写入后清除缓冲区,并释放oggpack缓冲区使用的内存:
oggpack_writeclear()
- 使用普通缓冲区并准备oggpack缓冲区,以便使用Ogg bitpacking函数进行读取:
oggpack_readinit()
- 将位写入oggpack缓冲区:
oggpack_write()
- 查看缓冲区中指定数量的位:
oggpack_look()
- 查看下一位:
oggpack_look1()
- 将位置指针提前指定的位数,而不读取任何数据:
oggpack_adv()
- 将位置指针前进一位,而不读取任何数据:
oggpack_adv1()
- 从缓冲区读取请求的位数,并前进位置指针:
oggpack_read()
- 从oggpack缓冲区数据中读取一位,并前进位置指针:
oggpack_read1()
- 返回oggpack缓冲区中当前访问点后面的总字节数:
oggpack_bytes()
- 返回oggpack缓冲区内部缓冲区中当前的总位数:
oggpack_bits()
- 返回指向给定oggpack buffer结构中的数据缓冲区的指针:
oggpack_get_buffer()
- 将ogg_sync_state结构初始化为已知的初始值,以准备操作ogg比特流:
ogg_sync_init()
- 检查ogg_sync_state结构:
ogg_sync_check()
- 释放ogg_sync_state结构的内部存储,并将结构重置为初始状态:
ogg_sync_clear()
- 销毁ogg_sync_state结构并释放所有使用的内存:
ogg_sync_destroy()
- 将ogg_sync_state结构的内部计数器重置为初始值:
ogg_sync_reset()
- 为写入提供适当大小的缓冲区:
ogg_sync_buffer()
- 告诉ogg_sync_state结构写入缓冲区的字节数:
ogg_sync_wrote()
- 将ogg_sync_state结构同步到下一个ogg页面:
ogg_sync_pageseek()
- 获取存储在ogg_sync_state结构缓冲区中的数据,并将其插入ogg页面:
ogg_sync_pageout()
- 向位流添加完整页面:
ogg_stream_pagein()
- 组装数据包以输出到编解码器解码引擎:
ogg_stream_packetout()
- 组装原始数据包并返回:
ogg_stream_packetpeek()
- 将数据包提交到位流以进行页面封装:
ogg_stream_packetin()
- 将数据包形成页面:
ogg_stream_pageout()
- 将数据包形成页面,类似于ogg_stream_pageout(),但允许应用程序显式请求特定的页面溢出大小:
ogg_stream_pageout_fill()
- 检查流中的剩余数据包,并将剩余数据包强制放入页面:
ogg_stream_flush()
- 将可用数据包刷新到页面中,类似于ogg_stream_flush() ,但允许应用程序显式请求特定的页面溢出大小:
ogg_stream_flush_fill()
- 初始化ogg_stream_state结构,并为编码或解码分配适当的内存:
ogg_stream_init()
- 检查ogg_stream_state结构的错误或准备状态:
ogg_stream_check()
- 清除和释放ogg_stream_state结构所使用的内部内存,但不会释放结构本身:
ogg_stream_clear()
- 将ogg_stream_state结构中的值设置回初始值:
ogg_stream_reset()
- 重新初始化ogg_stream_state状态中的值,就像ogg_stream_reset()一样:
ogg_stream_reset_serialno()
- 释放ogg_stream_state结构使用的内部内存以及结构本身:
ogg_stream_destroy()
- 返回此页面中使用的ogg页面的版本:
ogg_page_version()
- 指示当前页是否包含从上一页继续的数据包数据:
ogg_page_continued()
- 返回此页上完成的数据包数:
ogg_page_packets()
- 指示此页是否位于逻辑位流的开头:
ogg_page_bos()
- 指示此页是否位于逻辑位流的末尾:
ogg_page_eos()
- 返回此页末尾包含的数据包数据的精确粒度位置:
ogg_page_granulepos()
- 返回此页的逻辑位流的唯一序列号:
ogg_page_serialno()
- 返回连续页码:
ogg_page_pageno()
- 清除ogg数据包结构使用的内存,但不会释放结构本身:
ogg_packet_clear()
- 对ogg页进行校验:
ogg_page_checksum_set()
约束与限制
在下述版本验证通过:
DevEco Studio 版本:3.1 Beta1(3.1.0.200),SDK:API9 Beta5(3.2.10.6)
目录结构
|---- libogg
| |---- doc #Ogg规范和libogg API文档
| |---- include #头文件
| |---- src #libogg的源,实现公共域Ogg比特流格式
| |---- bitwise.c #将大小可变的单词打包到八位字节流中
| |---- framing.c #将原始数据包编码到框架OggSquish流中,并将Ogg流解码回原始数据包
| |---- win32 #win32项目和生成自动化
| |---- README.md #安装使用方法
经常有很多小伙伴抱怨说:不知道学习鸿蒙开发哪些技术?不知道需要重点掌握哪些鸿蒙应用开发知识点?
为了能够帮助到大家能够有规划的学习,这里特别整理了一套纯血版鸿蒙(HarmonyOS Next)全栈开发技术的学习路线,包含了鸿蒙开发必掌握的核心知识要点,内容有(ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、WebGL、元服务、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、OpenHarmony驱动开发、系统定制移植等等)鸿蒙(HarmonyOS NEXT)技术知识点。
《鸿蒙 (Harmony OS)开发学习手册》(共计892页)
如何快速入门?
1.基本概念
2.构建第一个ArkTS应用
3.……
1.应用基础知识
2.配置文件
3.应用数据管理
4.应用安全管理
5.应用隐私保护
6.三方应用调用管控机制
7.资源分类与访问
8.学习ArkTS语言
9.……
基于ArkTS 开发
1.Ability开发
2.UI开发
3.公共事件与通知
4.窗口管理
5.媒体
6.安全
7.网络与链接
8.电话服务
9.数据管理
10.后台任务(Background Task)管理
11.设备管理
12.设备使用信息统计
13.DFX
14.国际化开发
15.折叠屏系列
16.……
OpenHarmony 开发环境搭建
《OpenHarmony源码解析》
- 搭建开发环境
- Windows 开发环境的搭建
- Ubuntu 开发环境搭建
- Linux 与 Windows 之间的文件共享
- ……
- 系统架构分析
- 构建子系统
- 启动流程
- 子系统
- 分布式任务调度子系统
- 分布式通信子系统
- 驱动子系统
- ……
OpenHarmony 设备开发学习手册