HarmonyOS鸿蒙Next中上架检测FAQ：导航类要设置正确的应用类型

HarmonyOS鸿蒙Next中上架检测FAQ：导航类要设置正确的应用类型

概述

导航类要设置正确的应用类型，是指在功耗测试过程中，需要根据应用的三级分类来准确设置应用类型。

设计原则

导航类应用需设置正确的应用类型，并使用系统自带的导航场景音效算法，降低功耗使用。

典型案例

您的应用存在导航类应用使用了错误的usage类型STREAM_USAGE_NOTIFICATION为通知音，不符合审核标准。

import { audio } from '@kit.AudioKit';
import { hilog } from '@kit.PerformanceAnalysisKit';

let audioStreamInfo: audio.AudioStreamInfo = {
  samplingRate: audio.AudioSamplingRate.SAMPLE_RATE_44100,
  channels: audio.AudioChannel.CHANNEL_1,
  sampleFormat: audio.AudioSampleFormat.SAMPLE_FORMAT_S16LE,
  encodingType: audio.AudioEncodingType.ENCODING_TYPE_RAW
};
let audioRendererInfo: audio.AudioRendererInfo = {
  //usage值为错误的类型，应该设置成audio.StreamUsage.STREAM_USAGE_NAVIGATION
  usage: audio.StreamUsage.STREAM_USAGE_NOTIFICATION,
  rendererFlags: 0
};
let audioRendererOptions: audio.AudioRendererOptions = {
  streamInfo: audioStreamInfo,
  rendererInfo: audioRendererInfo
};
audio.createAudioRenderer(audioRendererOptions, (err, data) => {
  if (err) {
    hilog.error(0x0000, 'Sample', `Invoke createAudioRenderer failed, code is ${err.code}, message is ${err.message}`);
    return;
  } else {
    hilog.info(0x0000, 'Sample', 'Invoke createAudioRenderer succeeded.');
    let audioRenderer = data;
  }
});

修改指引

StreamUsage播放音频流类型的枚举值，设置导航播放的usage类型为audio.StreamUsage.STREAM_USAGE_NAVIGATION，值为13。详情见Audio Kit（音频服务）-ArkST API-@ohos.multimedia.audio (音频管理)-Enums。确保导航类应用能使用系统低功耗方案，详细见导航定位场景低功耗规则。

低功耗音频播放是一种通过软硬芯协同设计实现的音频渲染方案，减少频繁处理音频数据的功耗，显著降低系统级功耗负载，详情见低功耗音频播放。

应用上架前迭代版本测试可使用DevEco Testing应用上架预检功能在本地设备/虚拟机提供黑盒专业测试能力，提前发现上架基础体验类问题，提升上架审核效率。

应用上架提审前可使用云测试应用上架预检功能在云端提供远程黑盒专业测试，包含多品类，多设备，多OS的兼容测试能力，提前发现上架基础体验类问题，提升上架审核效率。


更多关于HarmonyOS鸿蒙Next中上架检测FAQ：导航类要设置正确的应用类型的实战教程也可以访问 https://www.itying.com/category-93-b0.html

2 回复

在HarmonyOS Next应用上架检测中，导航类应用必须正确设置应用类型。开发者需在AppGallery Connect的应用信息中，将应用类别明确选择为“导航”或“地图导航”。若应用类型设置错误，例如误设为“工具”或“出行”，将无法通过上架审核。此设置直接影响应用在应用市场的分类展示与推荐。

更多关于HarmonyOS鸿蒙Next中上架检测FAQ：导航类要设置正确的应用类型的实战系列教程也可以访问 https://www.itying.com/category-93-b0.html


这是一个非常关键的上架审核要点。帖子内容已经清晰地指出了问题核心和解决方案。

核心问题：导航类应用在创建音频渲染器（AudioRenderer）时，错误地将 usage 类型设置为了 STREAM_USAGE_NOTIFICATION（通知音）。这会导致系统无法识别该音频流属于导航场景，从而无法启用针对导航场景优化的低功耗音频播放方案。

正确做法：必须将 usage 设置为 audio.StreamUsage.STREAM_USAGE_NAVIGATION。

修改后的关键代码段应为：

let audioRendererInfo: audio.AudioRendererInfo = {
  // 正确设置为导航用途
  usage: audio.StreamUsage.STREAM_USAGE_NAVIGATION, // 值：13
  rendererFlags: 0
};

为什么必须这样设置？

  1. 功耗优化：STREAM_USAGE_NAVIGATION 会触发 HarmonyOS 的系统级低功耗音频播放方案。该方案通过软硬协同，减少频繁处理音频数据的功耗，对于导航这类需要长时间后台播放语音提示的应用至关重要。
  2. 音效处理：系统会为导航类音频应用专门的音效算法（如语音清晰度增强），确保在驾驶等环境中语音提示清晰可辨。
  3. 策略管理：系统能根据此标识正确管理音频焦点和声音策略，例如在播放音乐时恰当地压低音量播报导航提示。

检查与测试建议：

  • 在提交上架前，务必使用 DevEco Testing 的本地预检功能 或 云测试的云端预检功能 进行检测。这些工具能帮助发现此类不符合审核标准的配置问题。
  • 仔细核对应用的三级分类，确保与音频流的 usage 类型设置一致。

总之，准确设置 AudioRendererInfo 中的 usage 类型，是导航类应用满足 HarmonyOS Next 上架功耗与体验标准的基础要求，直接关系到审核能否通过。

回到顶部