简介

libogg是Ogg容器格式库,支持创建、解码和使用Ogg比特流。

此文件是OggVorbis软件编解码器源代码的一部分。

OpenHarmony编解码器—libogg 【GN编译】_数据库

下载安装

直接在OpenHarmony-SIG仓中搜索libogg并下载。

使用说明

以OpenHarmony 3.1 Beta的rk3568版本为例

  1. 将下载的libogg库代码存在以下路径:./third_party/libogg
  2. 修改添加依赖的编译脚本,路径:/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"
      ]
    }
  }
}
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.
  • 8.
  • 9.
  • 10.
  • 11.
  • 12.
  • 13.
  • 14.
  • 15.
  • 16.
  • 17.
  • 18.
  • 19.
  • 20.
  • 21.
  • 22.
  • 23.
  • 24.
  • 25.
  • 26.
  • 27.
  • 28.
  • 29.
  1. 编译:./build.sh --product-name rk3568 --ccache
  2. 生成库文件和一些可执行测试文件,路径:out/rk3568/developtools/profiler

接口说明

  1. 使用Ogg bitpacking函数初始化为写入的oggpack缓冲区: oggpack_writeinit()
  2. 检查先前使用Ogg bitpacking函数初始化为写入的oggpack缓冲区的就绪状态: oggpack_writecheck()
  3. 将oggpack缓冲区的内容重置为其原始状态: oggpack_reset()
  4. 截断已写入oggpack缓冲区的数据: oggpack_writetrunc()
  5. 将oggpack缓冲区中的零填充到下一个字节边界: oggpack_writealign()
  6. 将位序列从源缓冲区复制到oggpack缓冲区: oggpack_writecopy()
  7. 在写入后清除缓冲区,并释放oggpack缓冲区使用的内存: oggpack_writeclear()
  8. 使用普通缓冲区并准备oggpack缓冲区,以便使用Ogg bitpacking函数进行读取: oggpack_readinit()
  9. 将位写入oggpack缓冲区: oggpack_write()
  10. 查看缓冲区中指定数量的位: oggpack_look()
  11. 查看下一位: oggpack_look1()
  12. 将位置指针提前指定的位数,而不读取任何数据: oggpack_adv()
  13. 将位置指针前进一位,而不读取任何数据: oggpack_adv1()
  14. 从缓冲区读取请求的位数,并前进位置指针: oggpack_read()
  15. 从oggpack缓冲区数据中读取一位,并前进位置指针: oggpack_read1()
  16. 返回oggpack缓冲区中当前访问点后面的总字节数: oggpack_bytes()
  17. 返回oggpack缓冲区内部缓冲区中当前的总位数: oggpack_bits()
  18. 返回指向给定oggpack buffer结构中的数据缓冲区的指针: oggpack_get_buffer()
  19. 将ogg_sync_state结构初始化为已知的初始值,以准备操作ogg比特流: ogg_sync_init()
  20. 检查ogg_sync_state结构: ogg_sync_check()
  21. 释放ogg_sync_state结构的内部存储,并将结构重置为初始状态: ogg_sync_clear()
  22. 销毁ogg_sync_state结构并释放所有使用的内存: ogg_sync_destroy()
  23. 将ogg_sync_state结构的内部计数器重置为初始值: ogg_sync_reset()
  24. 为写入提供适当大小的缓冲区: ogg_sync_buffer()
  25. 告诉ogg_sync_state结构写入缓冲区的字节数: ogg_sync_wrote()
  26. 将ogg_sync_state结构同步到下一个ogg页面: ogg_sync_pageseek()
  27. 获取存储在ogg_sync_state结构缓冲区中的数据,并将其插入ogg页面: ogg_sync_pageout()
  28. 向位流添加完整页面: ogg_stream_pagein()
  29. 组装数据包以输出到编解码器解码引擎: ogg_stream_packetout()
  30. 组装原始数据包并返回: ogg_stream_packetpeek()
  31. 将数据包提交到位流以进行页面封装: ogg_stream_packetin()
  32. 将数据包形成页面: ogg_stream_pageout()
  33. 将数据包形成页面,类似于ogg_stream_pageout(),但允许应用程序显式请求特定的页面溢出大小: ogg_stream_pageout_fill()
  34. 检查流中的剩余数据包,并将剩余数据包强制放入页面: ogg_stream_flush()
  35. 将可用数据包刷新到页面中,类似于ogg_stream_flush() ,但允许应用程序显式请求特定的页面溢出大小: ogg_stream_flush_fill()
  36. 初始化ogg_stream_state结构,并为编码或解码分配适当的内存: ogg_stream_init()
  37. 检查ogg_stream_state结构的错误或准备状态: ogg_stream_check()
  38. 清除和释放ogg_stream_state结构所使用的内部内存,但不会释放结构本身: ogg_stream_clear()
  39. 将ogg_stream_state结构中的值设置回初始值: ogg_stream_reset()
  40. 重新初始化ogg_stream_state状态中的值,就像ogg_stream_reset()一样: ogg_stream_reset_serialno()
  41. 释放ogg_stream_state结构使用的内部内存以及结构本身: ogg_stream_destroy()
  42. 返回此页面中使用的ogg页面的版本: ogg_page_version()
  43. 指示当前页是否包含从上一页继续的数据包数据: ogg_page_continued()
  44. 返回此页上完成的数据包数: ogg_page_packets()
  45. 指示此页是否位于逻辑位流的开头: ogg_page_bos()
  46. 指示此页是否位于逻辑位流的末尾: ogg_page_eos()
  47. 返回此页末尾包含的数据包数据的精确粒度位置: ogg_page_granulepos()
  48. 返回此页的逻辑位流的唯一序列号: ogg_page_serialno()
  49. 返回连续页码: ogg_page_pageno()
  50. 清除ogg数据包结构使用的内存,但不会释放结构本身: ogg_packet_clear()
  51. 对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                    #安装使用方法
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.
  • 8.

经常有很多小伙伴抱怨说:不知道学习鸿蒙开发哪些技术?不知道需要重点掌握哪些鸿蒙应用开发知识点?

为了能够帮助到大家能够有规划的学习,这里特别整理了一套纯血版鸿蒙(HarmonyOS Next)全栈开发技术的学习路线,包含了鸿蒙开发必掌握的核心知识要点,内容有(ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、WebGL、元服务、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、OpenHarmony驱动开发、系统定制移植等等)鸿蒙(HarmonyOS NEXT)技术知识点。

OpenHarmony编解码器—libogg 【GN编译】_数据库_02

《鸿蒙 (Harmony OS)开发学习手册》(共计892页)
如何快速入门?

1.基本概念
2.构建第一个ArkTS应用
3.……

OpenHarmony编解码器—libogg 【GN编译】_缓存_03

1.应用基础知识

2.配置文件

3.应用数据管理

4.应用安全管理

5.应用隐私保护

6.三方应用调用管控机制

7.资源分类与访问

8.学习ArkTS语言

9.……

OpenHarmony编解码器—libogg 【GN编译】_数据库_04

基于ArkTS 开发

1.Ability开发

2.UI开发

3.公共事件与通知

4.窗口管理

5.媒体

6.安全

7.网络与链接

8.电话服务

9.数据管理

10.后台任务(Background Task)管理

11.设备管理

12.设备使用信息统计

13.DFX

14.国际化开发

15.折叠屏系列

16.……

OpenHarmony编解码器—libogg 【GN编译】_数据库_05

OpenHarmony编解码器—libogg 【GN编译】_OpenHarmony_06

OpenHarmony 开发环境搭建

OpenHarmony编解码器—libogg 【GN编译】_OpenHarmony_07

《OpenHarmony源码解析》

  • 搭建开发环境
  • Windows 开发环境的搭建
  • Ubuntu 开发环境搭建
  • Linux 与 Windows 之间的文件共享
  • ……
  • 系统架构分析
  • 构建子系统
  • 启动流程
  • 子系统
  • 分布式任务调度子系统
  • 分布式通信子系统
  • 驱动子系统
  • ……

OpenHarmony编解码器—libogg 【GN编译】_OpenHarmony_08

OpenHarmony 设备开发学习手册

OpenHarmony编解码器—libogg 【GN编译】_嵌入式硬件_09

OpenHarmony编解码器—libogg 【GN编译】_嵌入式硬件_10