SuperAPI AI 工具集

shazamkit

编程与开发

查看项目

更新于 10-16 06:15

技能介绍

用途:在 iOS 与 iPadOS 中将录制或环境音频与 Shazam 目录或自定义音频目录进行匹配识别。

主要能力:iOS 17+ 可用 SHManagedSession 将录音、会话管理与识别封装为异步结果流;需要手动控制 AVAudioEngine 管线或自定义目录时,可用 SHSession 通过代理接收匹配与未匹配回调;SHCustomCatalog 可构建并导出/加载自定义参考签名目录,用于非商业音频、展品、播客等自有素材;SHSignatureGenerator 可从 PCM 缓冲区生成紧凑且保护隐私的音频签名,无需向服务器发送原始音频。

使用方式:使用 SHManagedSession 时遍历 managedSession.results 处理匹配与未匹配结果,调用 cancel() 停止。使用 SHSession 时在 AVAudioEngine 输入节点安装 tap,将缓冲区传给 session.matchStreamingBuffer(_:at:),并实现 didFind 与 didNotFindMatchFor 代理方法。自定义目录通过 addReferenceSignature 添加带 SHMediaItem 属性的签名,用 write(to:) 导出、add(from:) 加载。签名生成先创建 SHSignatureGenerator,读取音频文件到缓冲区后 append,再调用 signature()。

限制与注意:使用实时麦克风需在 Info.plist 声明 NSMicrophoneUsageDescription;ShazamKit 要求单声道或立体声 PCM 缓冲区,多声道需先转换;静音或无法识别时会频繁触发未匹配回调,不应视为致命错误;签名生成器调用 signature() 后即结束,后续音频段需新建实例;释放 AVAudioEngine 前必须移除输入节点 tap。审查清单包括权限声明、缓冲区格式、代理方法完整性、自定义目录加载及 tap 移除。具体环境要求与更多细节以官方资料为准,未提供的平台或收费信息暂未提供。