# opus

**Repository Path**: openharmony-sig/opus

## Basic Information

- **Project Name**: opus
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: BSD-3-Clause
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 5
- **Created**: 2022-04-16
- **Last Updated**: 2025-05-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# opus

## 简介
> Opus是一种用于在互联网上进行交互式语音和音频传输的编解码器。它可以从低比特率窄带语音扩展到非常高的高品质立体声音乐。

![](screenshot/result.png)

## 下载安装
直接在OpenHarmony-SIG仓中搜索opus并下载。

## 使用说明
以OpenHarmony 3.1 Beta的rk3568版本为例

1. 将下载的opus库代码存在以下路径：./third_party/opus

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/opus:opus_targets",
      ],
      "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"
      ]
    }
  }
}

```

3. 编译：./build.sh --product-name rk3568 --ccache

4. 生成库文件和一些可执行测试文件，路径：out/rk3568/developtools/profiler

## 接口说明
1. 解码多流Opus数据包：
   `opus_multistream_decode()`
2. 使用浮点输出解码多流Opus数据包：
   `opus_multistream_decode_float()`
3. 分配和初始化多流解码器状态：
   `opus_multistream_decoder_create()`
4. 在多流Opus解码器上执行CTL功能：
   `opus_multistream_decoder_ctl()`
5. 释放已分配的OpusMSDecoder：
   `opus_multistream_decoder_destroy()`
6. 获取OpusMSDecoder结构的大小：
   `opus_multistream_decoder_get_size()`
7. 初始化以前分配的解码器状态对象：
   `opus_multistream_decoder_init()`
8. 对多流Opus帧进行编码：
   `opus_multistream_encode()`
9. 从浮点输入对多流Opus帧进行编码：
   `opus_multistream_encode_float()`
10. 分配和初始化多流编码器状态：
      `opus_multistream_encoder_create()`
11. 在多流Opus编码器上执行CTL功能：
      `opus_multistream_encoder_ctl()`
12. 释放已分配的OpusMSEncoder：
      `opus_multistream_encoder_destroy()`
13. 获取OpusMSEncoder结构的大小：
      `opus_multistream_encoder_get_size()`
14. 初始化以前分配的多流编码器状态：
      `opus_multistream_encoder_init()`  

## 约束与限制

在下述版本验证通过：

DevEco Studio 版本：3.1 Beta1(3.1.0.200)，SDK:API9 Beta5(3.2.10.6)

## 目录结构
````
|---- opus
|     |---- celt                                 #低延迟CELT
|     |---- doc                                  #资源文件及说明文档
|     |---- include                              #头文件
|     |---- m4                                   #预处理文件
|     |---- scripts                              #脚本文件
|     |---- silk                                 #语音编解码器Silk
|     |---- src                                  #opus实现                      
|           |---- opus_decoder.c                 #opus解码器
|           |---- opus_demo.c                    #opus示例
|           |---- opus_encoder.c                 #opus编码器
|           |---- opus_multistream_decoder.c     #opus多流解码器
|           |---- opus_multistream_encoder.c     #opus多流编码器
|     |---- tests                        #测试文件
|     |---- win32                        #win32项目和生成自动化
|     |---- README.md                    #安装使用方法
````

## 贡献代码
使用过程中发现任何问题都可以提 [Issue](https://gitee.com/openharmony-sig/opus/issues) 给我们，当然，我们也非常欢迎你给我们发 [PR](https://gitee.com/openharmony-sig/opus/pulls) 。

## 开源协议
本项目基于 [BSD license](https://gitee.com/openharmony-sig/opus/blob/master/LICENSE_PLEASE_READ.txt) ，请自由地享受和参与开源。