SuperAPI AI 工具集

axiom-shazamkit

通用与其它

查看项目

更新于 10-16 08:34

技能介绍

用途:为应用加入音频识别能力,包括 Shazam 曲库识曲、自定义音频目录匹配、第二屏同步,以及管理用户的 Shazam 曲库。

主要能力:iOS 17+ 的 SHManagedSession 负责录音、格式转换与匹配,支持单次匹配与连续匹配,并可用 prepare() 预录以降低首次识别延迟;其状态为 .idle、.prerecording、.matching,并符合 Observable 以便 SwiftUI 自动刷新。iOS 15–16 或需要缓冲区级控制时使用 SHSession 配合 AVAudioEngine,也可直接匹配预生成签名。自定义目录通过 SHSignatureGenerator、SHCustomCatalog、SHMediaItem 构建,支持 timeRanges 定时媒体项与 frequencySkewRanges 区分相似音频,可用 shazam 命令行工具批量生成签名与目录。SHLibrary(iOS 17+)可读写删用户曲库,SHMediaLibrary(iOS 15+)仅支持写入。

使用方式:Shazam 曲库匹配需在 App ID 的 App Services 中启用 ShazamKit,并在 Info.plist 添加 NSMicrophoneUsageDescription;自定义目录匹配无需启用该服务,但仍需麦克风说明。签名可保存为 .shazamsignature,目录保存为 .shazamcatalog。

限制:单一会话只能针对一个目录,同时匹配两个目录需建立两个会话。每个媒体资源只生成一个签名,用定时媒体项而非切分音频。不在时间范围内的媒体项不会返回。曲库写入应事先告知用户。本页资料未提供价格、平台版本以外的收费与效果信息。