探索采用 Apple Music API 的目录

♪播放重低音音乐♪ ♪ 嗨 欢迎参加WWDC 2021 我是MusicKit工程师 葛兰塞福特 在过去几年 我们改善了开发者从Apple Music 提取更新、更多数据的能力 今天很高兴能向各位 介绍一下这些改善 在这部影片 我们会介绍 API的搜寻功能 请求数据的新方式 通过相关来源、延伸属性 和关联浏览请求 显示相对应的信息 最后我们看一些排行榜API的改良 在介绍搜寻功能的改良之前 快速讲一下目前的/search/hints端点 现在你可能已经是用这个端点 提取搜寻关键词的建议列表 比如 这些词汇可能是你输入 “taylor”会跑出的结果 这边跟大家介绍用 /search/suggestions端点 取代原本的/search/hints端点 这个端点会连到 和/search/hints端点一样的词汇 只要注明kinds=terms 即可请求 不过 你会发现这个端点的回应 有一点不一样 建议结果指的是它们的种类 会符合请求注明的种类 也跟原本搜索查询用的 词汇有所区别 跟显示给用户的词汇不同 更重要的是 这个端点现在可以 连结最佳建议的搜寻结果 增强预先输入结果 只需要注明kinds=topResults 就能做出请求 也能显示你可能有兴趣提取的 一些来源类型 topResults种类的来源 可以在内容密钥底下找到 要注意的是 从这个端点取得的资料 跟你从一般搜寻得到的结果 可能会有非常大的差异 因为这项响应要求的是速度大于广度 所以说 这项功能并不是要取代 原本一般的/search端点 而是作为一种辅助 在讲解如何修改来源之前 我想再介绍一次 来源是什么 给那些不太熟悉的朋友知道 所有来源都有所谓的“来源识别” 是在API里面查找来源 所需要的最小信息量 来源识别包括来源的ID 来源的类型和href 完整的来源呈现 会包含来源的属性 例如它的名称和可能的关联 是否曾被include参数请求过 关联是相关来源的集合 例如一首歌的类型或一份歌单的音轨 接下来 我想介绍相关来源的概念 用relate请求的关联 跟用include请求的关联不一样 他们只会跑回 前面列出有关联的来源 它们的来源识别 这表示跟关联相关 可以产生更快的响应 在你只需要找到来源参考的时候 你可以用相关查询参数relate关联 并用你的目标来源类型去分类 再附上你想要它跑回来的 关联名称清单 比如 在/search /suggestions端点 你可能决定当使用者选了一首歌 你想要它跳出那首歌的专辑页面 这样的话 你只需要那张专辑的href 就能导到页面 我们就注明relate=albums 就可以取得数据 这样做之后 我们会看到歌曲结果 回应的内容有包括来源识别 对应个别的专辑 所以relate在我们想快速参考到 附加关联内容时很好用 但若我们想要更了解 已经取回的源数据该怎么办？ 如先前所说 每个来源都有一组默认属性 诸如名称、原图等等 但来源也可能有延伸属性 延伸属性可能计算起来麻烦 或是不那么重要 所以如果包含在预设里 可能会明显拖累响应时间 或膨胀对象模型 跟我们刚看的relate请求参数类似 你可以通过延伸查询参数 请求来源的延伸属性 用来源类型分类它 并附上你想要的 属性名称列表 建立在我们的/suggestions要求 我们可能决定这些歌曲结果 还要能让使用者可以 连到该名艺人在Apple Music的页面 要满足这个 你可以直接在你的请求附上 extend=artistUrl 确实 在这么做之后 我们能看到回应中的歌曲来源 现在包含了artistUrl这个属性 现在我想介绍关联检视表的概念 跟关联相比 检视表跟来源的藕接又更松散 它们未必像关联一样 呈现来源的基准真相 所以检视表就很适合 驱动产品页面的体验 比如像专辑页面 比较之下 关联就比较适合用在 例如说 搜寻结果页面 另外 检视表也有属性 譬如标题 就跟数据一样 检视表的请求 也只能通过直接提取来源 有两种不同的方式 可以提取它们 可以用检视表请求参数 并注明一份清单 或是通过/view/ 放在请求路径的来源ID后 这边我们有一个例子 纳入最佳歌曲检视表的艺人来源 看起来是这样 还有纳入最佳音乐录像带 或是艺人单曲特定来源种类的 支持检视表全清单 也可以在官方的Apple Music API 里面找到 最后我们来看一下排行榜API的更新 现在 Apple Music支持的播放列表 包括全球排行、商店 还有特定城市榜单 使用者可以将这些榜单播放列表 加到数据库里面 数据库会自动更新 这些可从/charts端点直接提取 只需注明types=playlists 并用“with”请求参数 看你想要的是 dailyGlobalTopCharts、cityCharts 或是两者都要 这边我们有一个用这些请求参数 跑出来的榜单响应可以参考 总的来说 我们今天讲解了 搜寻功能和榜单端点的改良 并了解一些按照请求 提取数据来源的新方法 如果想了解更多Apple Music的API 我很推荐今年的讲座里面 关于Apple Music API上的内容 如何交叉参考 或是2017年介绍MusicKit的影片 里面谈到一些API的核心概念 而且都很详细 感谢你收看今天这个讲座 希望你喜欢今年的WWDC ♪