HarmonyOS 鸿蒙Next中自定义铃声未生效

检查一下自定义铃声字段的铃声文件是不是放在其他地方了，当前仅支持放在/resources/rawfile路径下，可以参考文档 https://developer.huawei.com/consumer/cn/doc/harmonyos-references/push-scenariozed-api-request-param#notification

更多关于HarmonyOS 鸿蒙Next中自定义铃声未生效的实战系列教程也可以访问 https://www.itying.com/category-93-b0.html

itying888 2楼

尊敬的开发者，您好，

可参考以下方案排查：

一、基础资质检查：

category取值为MARKETING

category 参数检查 (消息体)：

检查您推送消息的请求体中，AlertPayload 或其上级结构中的 category 参数值。

category 设置为 MARKETING (营销) 时，不支持自定义铃声！请确保该值不是 MARKETING。

二、铃声文件配置：

路径：铃声文件必须放在您应用的 /resources/rawfile/ 目录下。

格式：铃声文件格式需为 m4a, aac, mp3, ogg, wav, flac, amr 之一。

文件名： sound 属性中只需填写文件名（不含路径和扩展名）。例如文件是 /resources/rawfile/mycoolring.mp3，则 sound 应设置为 “mycoolring”。

三、soundDuration 参数：

检查 sound 属性相关的 soundDuration 参数（如果使用）。

请勿将 soundDuration 设置为 0。应设置为铃声文件的实际播放时长（单位：秒）。

详情参考通知消息自定义铃声实现。

如您确认以上 4 点均已正确配置，但铃声仍然不生效：请提供您尝试发送的完整推送请求体 (JSON)，以便进一步分析问题。

eggper 3楼

自定义铃声不生效一般先不要只看服务端字段，要同时确认“通知通道”和“本地资源”两边。很多系统通知能力会优先使用已创建通道的声音配置；如果通道已经按默认铃声创建，后续单次推送里改 sound 字段不一定能覆盖旧通道。

建议排查：1. 铃声文件是否随包放在通知能力要求的资源位置，文件名、格式、时长都符合要求；2. 客户端创建通知通道时是否已经指定自定义声音，且通道 ID 与服务端下发的一致；3. 如果之前创建过同名通道，卸载重装或换新的 channelId 验证，排除通道配置缓存；4. 前台本地通知和后台 Push 分别测试，确认是 Push 字段问题还是本地通知通道问题；5. 部分系统状态如静音、勿扰、用户手动改过通道声音，也会影响最终播放。

eggper 4楼

在HarmonyOS Next中，自定义铃声未生效常见原因：

铃声文件未正确添加到媒体库，需通过MediaStore写入并获取content:// URI。
未动态申请ohos.permission.READ_MEDIA_AUDIO权限。
使用RingtoneManager.setActualDefaultRingtoneUri()时传入的URI非MediaStore返回的URI。
通知渠道未正确设置音频属性（setSound()或setRingtone()）。

请检查上述步骤。

yuanlaile 5楼

自定义铃声未生效通常由以下几个原因导致：

铃声文件位置不正确：推送通知中指定的铃声资源需放在应用内可访问的路径，HarmonyOS 中自定义铃声应放置在 rawfile 目录下，服务端推送的 sound 字段值需匹配为 "rawfile/文件名"（不含扩展名或含扩展名，需与实际情况一致），若路径或名称有误则系统会回退到默认铃声。
文件格式与大小限制：系统支持的铃声格式有限（如 MP3、WAV 等），且文件大小不宜过大，否则可能被忽略。
服务端配置字段错误：Push Kit 的消息体需正确填写声音字段，例如 Android 配置中的 sound 字段或 HarmonyOS 对应的扩展字段，请确认字段名及值是否为后台实际下发的格式，避免使用过时的定制字段。
设备端权限与状态：检查应用是否已获得通知权限，设备是否处于静音、震动或勿扰模式，这些状态会覆盖自定义铃声，导致播放默认提示音。
系统版本兼容性：部分自定义铃声能力可能仅在特定 HarmonyOS NEXT 版本支持，请确认测试设备系统版本符合要求。