mirror of
https://github.com/openharmony/interface_sdk_c.git
synced 2026-08-24 14:32:50 -04:00
openharmony_ci
44e6c736e8
feat(audio): register native_audio_debug_manager in BUILD.gn and ndk.json
Created-by: jvgang
Commit-by: jvgang
Merged-by: openharmony_ci
Description: ### 相关的Issue
无
### 原因（目的、解决的问题等）
为音频模块新增 Debug Manager C API，提供音频运行时快照功能，支持开发者获取应用级、Renderer、Capturer、Session、SuiteEngine 等组件的运行时状态信息，便于调试和问题定位。
### 描述（做了什么，变更了什么）
1. **新增头文件** `multimedia/audio_framework/audio_manager/native_audio_debug_manager.h`
- 定义 `OH_AudioDebugManager` 不透明结构体
- 新增 6 个 C API：
- `OH_AudioManager_GetAudioDebugManager` — 获取 Debug Manager 单例句柄
- `OH_AudioDebugManager_ShowAppInfo` — 显示应用级音频运行时快照
- `OH_AudioDebugManager_ShowRendererInfo` — 显示 AudioRenderer 运行时快照
- `OH_AudioDebugManager_ShowCapturerInfo` — 显示 AudioCapturer 运行时快照
- `OH_AudioDebugManager_ShowSessionInfo` — 显示 AudioSessionManager 运行时快照
- `OH_AudioDebugManager_ShowSuiteInfo` — 显示 AudioSuiteEngine 运行时快照
2. **更新 `BUILD.gn`** — 在 `ohaudio_header` 的 sources 和 system_capability_headers 中注册新头文件
3. **更新 `ohaudio.ndk.json`** — 注册 6 个新 API 符号，first_introduced: "26.0.0"
### 自检结果（结果截图添加到下面）
- [x] 是否通过C语法扫描
- [x] 是否通过注释规则扫描
- [x] 是否更新json文件
- [ ] 实现代码是否已经合入
- [x] 目标是否已经添加到interface/sdk_c仓ndk依赖目标(ndk_targets.gni)里（已有`//interface/sdk_c/multimedia/audio_framework:libohaudio_ndk`和`ohaudio_header`，新头文件通过现有target注册，无需新增）
- [x] 头文件library声明与SDK so库名称一致（`@library libohaudio.so` 与 `BUILD.gn` output_name `ohaudio` 一致）
### 兼容性影响评估，如有影响请写明（Y/N）
- [x] N
- 纯新增API，不修改任何已有接口签名、参数、返回值，不影响已有代码编译和运行
### L0新增用例自检结果
- [ ] 是，有新增L0用例，且完成自检
- [x] 否
### API参考文档影响评估（提供docs仓pr链接）
- [ ] 是，已刷新API参考文档
- [x] 否，不涉及刷新API参考文档
See merge request: openharmony/interface_sdk_c!5156
Public Repository for API Declaration Files
Overview
This repository is used to store .h declaration files of C APIs. The OpenHarmony C API is collection of system C interfaces that the operating system provided for applications using the C/C++ language library.It is the contract between the system and the applications; These interfaces need to be sufficiently stable. Interfaces are currently organized into various directories according to the function, and the directories organized as follows.
Directory Structure
─ai
| ├─neural_network_runtime
├─arkui
| ├─ace_engine
├─bundlemanager
| ├─bundle_framework
│ | ├─bundle
├─commonlibrary
| ├─memory_utils
│ | ├─bundle
├─distributeddatamgr
| ├─relational_store
├─drivers
| ├─external_device_manager
├─global
| ├─resource_management
├─graphic
| ├─graphic_2d
├─hiviewdfx
| ├─hiappevent
| ├─hilog
| ├─hitrace
├─multimedia
| ├─audio_framework
| ├─av_codec
| ├─image_framework
| ├─player_framework
├─resourceschedule
| ├─ffrt
├─security
| ├─huks
├─startup
| ├─init
├─third_party
Repositories Involved
interface_sdk_c C API编码规范: A guide that describes how to design and publish an interface. C API构建指南：A guide that describes how to add a build target for the C API in the build.gn