Ringtone Kit（铃声服务）是一个用于设置铃声的工具库。通过使用Ringtone Kit，开发者可以在HarmonyOS应用中提供铃声设置的功能，为用户提供简单一致、安全高品质的铃声设置体验。

场景介绍

Ringtone Kit支持将音频文件设置成多种铃声类型，满足各类铃声需求场景。

• 多种铃声类型：可设置来电铃声、通知铃声、信息铃声、闹钟铃声。
• 支持双卡铃声：可对双卡分别设置不同来电铃声和信息铃声。
• 铃声快捷管理：点击我的铃声按钮快速跳转“设置-声音与振动”管理铃声。

铃声设置组件效果图：

约束与限制

当不满足所需条件时，部分功能不可使用：

• 当HarmonyOS设备不支持SIM卡时，来电铃声和信息铃声设置功能将不可用。
• 目前可设置的铃声音频源格式为OGG和MP3。
• 设置的铃声最大时长为5分钟。

1. 导入ringtone模块和相关公共模块。

import { ringtone } from '@kit.RingtoneKit'
import { uniformTypeDescriptor } from '@kit.ArkData';
import { JSON } from '@kit.ArkTS';
import { hilog } from '@kit.PerformanceAnalysisKit';
const APP_TAG = "Msc_Demo"
const DOMAIN = 0x0001

1. 调用[ringtone.getSupportedRingtoneTypes]接口，查询支持设置的铃声类型。

let ringtoneTypeList: Array<ringtone.RingtoneType> = ringtone.getSupportedRingtoneTypes();
hilog.info(DOMAIN, APP_TAG,'getSupportedRingtoneTypes : ' + JSON.stringify(ringtoneTypeList));

1. 调用[ringtone.getSupportedDataTypes]接口，查询支持的数据类型。当前只支持OGG和MP3文件类型。

// 其中 ringtone.RingtoneType.NOTIFICATION 为通知铃声
let dataTypeList: Array<uniformTypeDescriptor.UniformDataType> = ringtone.getSupportedDataTypes(ringtone.RingtoneType.NOTIFICATION);
hilog.info(DOMAIN, APP_TAG,'getSupportedDataTypes: ' + JSON.stringify(dataTypeList));

1. 设置铃声，并返回设置的铃声类型。

通过promise异步方式：

// 详细代码参考API参考
let audioPath: string = (getContext(this) as common.UIAbilityContext).filesDir + '/' + this.buttonText;
let fileName: string = audioPath.substring(audioPath.lastIndexOf('/') + 1, audioPath.lastIndexOf('.'));
await ringtone.startRingtoneSetting(this.context, audioPath, fileName).then(res => {
  hilog.info(DOMAIN, APP_TAG,'setFlag :' + res);
});

通过callback异步方式：

// 详细代码参考API参考
let audioPath: string = (getContext(this) as common.UIAbilityContext).filesDir + '/' + this.buttonText;
let fileName: string = audioPath.substring(audioPath.lastIndexOf('/') + 1, audioPath.lastIndexOf('.'));
ringtone.startRingtoneSetting(this.context, audioPath, fileName, (err, data) => {
  hilog.info(DOMAIN, APP_TAG,'setFlag :' + data);
});

1. 获取当前铃声支持的最大时长（信息铃声时长不超过5分钟，其他类型铃声时长请参见[ringtone.getSupportedMaxDuration]）。

// 其中 ringtone.RingtoneType.MESSAGE 为短信铃声
let maxDuration: number =
                ringtone.getSupportedMaxDuration(ringtone.RingtoneType.MESSAGE, uniformTypeDescriptor.UniformDataType.MP3)
hilog.info(DOMAIN, APP_TAG,'getSupportedMaxDuration: ' + maxDuration);

最后呢

很多开发朋友不知道需要学习那些鸿蒙技术？鸿蒙开发岗位需要掌握那些核心技术点？为此鸿蒙的开发学习必须要系统性的进行。

而网上有关鸿蒙的开发资料非常的少，假如你想学好鸿蒙的应用开发与系统底层开发。你可以参考这份资料，少走很多弯路，节省没必要的麻烦。由两位前阿里高级研发工程师联合打造的《鸿蒙NEXT星河版OpenHarmony开发文档》里面内容包含了（ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、Harmony南向开发、鸿蒙项目实战等等）鸿蒙（Harmony NEXT）技术知识点

如果你是一名Android、Java、前端等等开发人员，想要转入鸿蒙方向发展。可以直接领取这份资料辅助你的学习。下面是鸿蒙开发的学习路线图。

针对鸿蒙成长路线打造的鸿蒙学习文档。话不多说，我们直接看详细鸿蒙（OpenHarmony ）手册（共计1236页）与鸿蒙（OpenHarmony ）开发入门视频，帮助大家在技术的道路上更进一步。

• 《鸿蒙 (OpenHarmony)开发学习视频》
• 《鸿蒙生态应用开发V2.0白皮书》
• 《鸿蒙 (OpenHarmony)开发基础到实战手册》
• OpenHarmony北向、南向开发环境搭建
• 《鸿蒙开发基础》
• 《鸿蒙开发进阶》
• 《鸿蒙开发实战》

鸿蒙开发文件前往：gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md自取

总结

鸿蒙—作为国家主力推送的国产操作系统。部分的高校已经取消了安卓课程，从而开设鸿蒙课程；企业纷纷跟进启动了鸿蒙研发。

并且鸿蒙是完全具备无与伦比的机遇和潜力的；预计到年底将有 5,000 款的应用完成原生鸿蒙开发，未来将会支持 50 万款的应用。那么这么多的应用需要开发，也就意味着需要有更多的鸿蒙人才。鸿蒙开发工程师也将会迎来爆发式的增长，学习鸿蒙势在必行！ 自↓↓↓拿