适用于 iOS 的 ShazamKit 入门教程

在本教程中,您将:

  • 了解 Shazam 的识别机制。
  • 创建 DevCompanion,一个简单的 Shazam片段,与流行的、已发布的音乐和歌曲相匹配。
  • 匹配视频中的自定义音频。
  • 可见视频播放位置更改应用内容。

实例化对象是什么意思果你不是,请不要担心。只需要在笔记本电脑上播放首首歌曲,就问 Siri:“这首歌是笔记本什么本?”或下载Shazam 应用程序。

入门

适用于 iOS 的 ShazamKit 入门教程

DevCompanion 有两个视图:SwiftUI

  • 在什么?:用户可以在其中匹配流行音乐,就像 Shazam 一样。
  • 视频内容:用户可以在 raywende笔记本显卡天梯图rlich.com 上观看笔记本显卡天梯图 SwiftUI 视频课程时查看注释和其他内容。

打开MatchingHelp索引图er.swift并查看代码。这是一个空的帮助程序类,您将在其中编写 ShazamKit 识别代码。

现在不要担心其他文件。创建自定义音频体验时,您将在本教程后面看到您。现在,您将了解更多关于 Shazam 如何识别和匹配音频的信息。

注意:对于本教程,您的 Xcode 13 和运行 iOS 13 和运行 iOS 1。

您还需要一个 Appl通信地址e 开发帐通信地址是写什么地址户人员使用 ShazamKit 应用程序服务配置应用程序 ID。

了解Shazam的匹配机制

在编写代码和使用 ShazamKit API 之前,必须了通信解 Shazam 如何在幕后工作。

使索引的优缺点用 Shaza 时,可以在播放时点击显示大识别*Shazam。*立即找到该应用程序会听几首歌索引的优缺点曲,然后在您笔记本电脑开不了机的匹配项中播放歌曲信息。您可以匹配的任何部分。

这就是引擎盖下实例化对象是什么意思的内容:

  1. 该应用程序使用实例具有预定义程序的开始形式的流。
  2. Shazam 库(现在称为 ShazamKit 从应用程序展示的签名签名*)*。
  3. 然后,ShazamKit 会将这个音频签名的查询请求发送到 Shazam API。Shazam 服务将签名与 Shazam 目录中流行音乐的签名进行匹配。
  4. 如果,API 给排序的 ShazamKit 的元数据匹配返回。
  5. ShazamKit类的实例化 调用传递元数据的正确委托。
  6. 结果,由应用程序逻笔记本显卡天梯图辑来显示轨迹信息。

,您将了解有关 Sha索引符号zam 签名和目录的更多信息。

Shazam签名

Shazam通过生成高随后的部分的图创建签名,或者是雷声和识别的部分。

签名对原始音频不观通信工程看,以确保原始音频的隐私。

在此过程中,索引页是哪一页Shazam 将应用程序发送的查询签名与参考签名进行匹配。参考签名是从整首歌曲或曲目生成的。

例如,可以识别出大部分的Shazam应用程序在不同的背景下都能获得匹配。 和索引,他们因为更多的占用空间比原始音频小。

您可以在 Shazam 创始人 Avery Wang 的个人研究论文中了解更多关于 Shaza索引失效m 算法的信息。

,您将探索 Shazam 目录。

Shazam目录

如前所述,Shazam 将签笔记本插电用好还是不插电名参考签名进行匹配。

适用于 iOS 的 ShazamKit 入门教程

Shazam 目录通信人家园含几乎所有流行歌曲的参考签名和元数据。您还可以在应用程序中本笔记本插电用好还是不插电地创建自定义通信工程专业目录,为您存储音轨并参考签名和数据。您将在本教程后面创建定义目录。

理论到此为止。接下来,您将学习如何让应用识别流行音乐。

将音乐与 Shazam 的目录相匹配

Matchin通信行程卡gHelper.swift代码:

导入AVFAudio
进口基金会导入
ShazamKit
类MatchingHelper : NSObject {变量
  会话:SHSessionAu
  私有 audioEngine =  AV
  私有 var matchHandler: (( SHMatchedMediaItem ?, Error ?) -> Void ) ?
  init ( matchHandler  handler : (( SHMatchedMediaItem ?, Error ?) -> Void ) ? ) {
    matchHandler =处理程序
  }
}

它是一个控制麦克风并使用 ShazamKit 识别实例化一个对象可以使用什么命令音频的辅助类。在顶部,您可以看到导入 ShazamKit 的代码以及AVFAudio.您需要 AVFAud通信技术io 才能使用麦克风和捕获音频。

MatchingHelpe笔记本电脑r也是子类NSObject,因为任何符合S实例化是什么意思HSessionDelegate.

看一下MatchingHelper的属性:

  • session:您将用于与 Shazam 服务通信的 ShazamK笔记本插电用好还是不插电it 会话。
  • audioEngineAVAudioEngine实例化一个对象可以使用什么命令将用于笔记本电脑开不了机从麦克风捕获音频的实例。
  • matchHandler:应用程序视图将实现的处理程序块。它在识别过程完实例化和初始化的区别成时调用。

初始化程序确保mat通信工程chH实例化对象andler在您创建类的实例时设置。

在初始化器下面添加以下方法:索引图

func  match ( catalog : SHCustomCatalog ? =  nil ) throws {
   // 1. 实例化 SHSession 
  if  let catalog = catalog {
    session =  SHSession(目录:目录)
  }其他{
    会话=  SHSession ()
  }
  // 2. 设置 SHSession 委托
  会话? .delegate = 自我
  // 3. 准备捕获音频
  let audioFormat =  AVAudioFormat (
    standardFormatWithSampleRate:
      audioEngine.inputNode.outputFormat(forBus: 0 ).sampleRate,
    渠道:1)
  audioEngine.inputNode.installTap(
    总线上: 0 ,
    缓冲区大小:2048,
    格式:音频格式
  ) { [ weak session] buffer, audioTime in  
    // 回调捕获的音频缓冲区
    会话?.matchStreamingBuffer(缓冲区,在:audioTime)
  }
  // 4. 使用 AVAudioEngine 开始捕获音频
  try  AVAudioSession .sharedInstance().setCategory(.record)
   AVAudioSession .sharedInstance()
    .requestRecordPermission { [弱 自我]守卫成功
        成功,
        让 self  =  self 
      else { return }
      试试? 自.audioEngine.start()
    }
}

match(catalog:)是应用程序代码的其余部分将用于使用 ShazamKit 识别音频的方法。SHCustomCatalog如果要与自定义目录匹配,它需要一个可选的类型参数。

看看每一步:

  1. 首先,SHSession如果您使用自定义目录,则创建一个目录并将其传递给它。

    SHSession如果您不提供目录,则默认为 Shazam 目录,该实例化对象目录适用于应用程序的第一部分。

  2. 您设置SHSes通信工程sion委托,稍后您将实现它。

  3. 您调用AVAudioEngine‘sAVAudioNode.installTap(onBus:bufferSize:format:block:)实例化和初始化的区别,这是一种准备音频输入节点索引失效的几种情况的方法。索引是什么意思在传递捕获的音频缓冲区的回调中,您调用SHSession.match通信工程Strea索引图mingBuffer通信地址是写什么地址(_:at:).这会将缓冲区中的音频转换为通信工程 Shazam 签名,并与所选目录中的参考签名进行匹配。

  4. 通信大数据行程卡AVAudioSession类别或模式设置为录制。AVAudio笔记本电脑开不了机Session然后,您在应用程序第一次运行时通过调用’srequestRecordPermission(_:)向用户询问麦克风权限来请求麦克风录音权限。

    索引超出矩阵维度后,您通过调用 开始录制AVAudioEngine.start()

注意NSMicrophoneUsageDescrip索引图tion已经在项目的Info.plist 中设置。

matchStreamingBuffer(_:at:)处理捕获音频并将其通信人家园传递给 ShazamKit。或者,您可以使用SHSignatureGenerator生成签名对象并将其传递给matchofSHSession。但是,matchStreamingBuffer(_:at:)实例化是什么意思它适用于连续音频,因此适合您的用例。

接下来,您将实现 Shazam实例化对象 Session 委托。

探索 ShazamKit 会话

在连接 UI 之前还有两个步骤。首先,您需要实施SHSessionDelegate以处理匹配的成通信行程卡功和失败。

在Ma索引超出了数组界限什么意思tchingHelper.swift的末尾添加以下类扩展:

扩展 MatchingHelper : SHSessionDelegate {
   func  session ( _  session : SHSession , didFind  match : SHMatch ) {
     DispatchQueue .main.async { [ weak  self ] in 
      guard  let  self  =  self  else {
         return
      }
      if  let handler =  self .matchHandler {
        handler(match.mediaItems.first, nil )
         // 停止捕获音频
      }
    }
  }
}  

在此扩展中,您实现SHSessionDelegate.当录制的签名与目录实例化对象中的歌曲匹配时 SHSession调用。session(_:didFind:)它有两个参数:S笔记HSession调用它的来源和一个SHMatch包含结果的对象。

在这里,您检查是否matchHandle笔记本电脑什么牌子好r已设置,并通过以下参数调用它:

  • SHMatchedMediaItem返回mediaItems的第一个SHMatch:如果查询签名匹配目录中的多首歌曲,ShazamKit 可能会返回多个通信行程卡匹配项。匹配按匹配质量排序,第一个具有最高质量。
  • 错误类型:由于这是成功的,因此您实例化对象传递nil

在下一节中,您将在 SwiftUI 中实现此处理程序块。

紧随其后session(_:didFind:),添加:

func  session (
   _session  : SHSession , 
   didNotFindMatchFor签名: SHSignature , 
   error :错误?_ 
) {
  DispatchQueue .main.async { [ weak  self ] in 
    guard  let  self  =  self  else {
       return
    }
    if  let handler =  self .matchHandler {
      handler( nil , error)
       // 停止捕获音频
    }                          
  }
}

session(_:didNotFindMatchFor:error:)``SHSession是当目录中没有与查询签名匹配的歌曲或发生阻止匹配的错误时调用的委托方通信技术法。它返回第通信地址三个参数中发生的错误,或者nil如果查询签索引页是哪一页名在 Shazam 目录中没有匹配项。与您在 中所做的类似session(_:didFind:),您调用相同的处理程序块并传入错误。

最后,为了遵守 Apple 的麦克风使用指南并保护用户隐私,您需要在调用两个委托方法中实例化的任何一个时停止捕获音频。

match(catalog:)在 的主体之后添加以下笔记本电脑排名前十方法Ma通信地址是写什么地址tchingHelper

函数 停止监听(){
  音频引擎.stop()
  audioEngine.inputNode.removeTap(onBus: 0 )
}

然后,调用stopListening()索引超出了数组界限什么意思上面的两个委托方法。替换以下注释:笔记

// 停止捕获音频

和:

自我.stopListening()

接下来,您将显示匹配结果。

显示匹配的乐曲

Shazam 克隆的最后一部分是 UI。打开SongMatchView.swift并检查画布中的预览:

适用于 iOS 的 ShazamKit 入门教程

视图由两部分组成。带有圆形绿色方块的顶部是您将显示实例化一个对象可以使用什么命令歌曲信息的地方。底部有启动匹配过程的匹配按钮。

首先,你需要索引超出矩阵维度一个M实例化一个对象可以使用什么命令atchHelper对象。在 顶部SongM笔记本电脑排名前十atchView,添加:

@State  var matcher:MatchingHelper?

然后,在视图的末尾stru通信地址ct,紧随其后body,添加:

func  songMatched(项目:SHMatchedMediaItem?,错误:错误?){
  isListening =  false
  如果错误!=  nil {
    status =  "无法匹配音频:(" 
    print ( String (描述: error.debugDescription))
  }其他{
    status =  "歌曲匹配!" 
    print ( "找到歌曲!" )
    标题=项目?。标题
    副标题=项目?。字幕
    艺术家=物品?。艺术家
    coverUrl =项目?.artworkURL
  }
}

songMatched(item:error:)``MatchingHelper是完成匹配时调用的方法。它:

  • 设置isListeningfalse。因此,UI 会更新以向用户显示应用程序不再记录并隐藏活动指示器。
  • 检查error参数。如果它笔记本插电用好还是不插电不是 nil,则存在错误,因此它会更新用户看到的状态并将错误记录到控制台。
  • 如果没有错误,它索引超出了数组界限什么意思会告诉用户它找到了匹配项并使索引图用歌曲元数据笔记本更新其他属性。

SHMatchedMediaItem是 的子类SHMediaItem。它为匹配的项目通信地址继承媒体项目的元数据属性,例如歌曲的标题艺术家流派艺术品 URL视频 URL笔记本电脑排名前十 它还具有特定于匹配项的其他属性,例如frequencySkSwiftUIew匹配音频和查询音频之间的频率差异。

接下来,在 末尾NavigationView,添加:

.onAppear {
  如果匹配器==  nil {
    matcher =  MatchingHelper (matchHandler: songMatched)
  }
}
.onDisappear {
  isListening = 假
  匹配器?.stopListening()
  状态=  ""
}

在这里,您实例化Ma通信人家园tchHelper视图出现时刚刚添加的传递处理通信人家园程序。当视图消失时,例如,当您切换到另一个选项卡时,您可以通通信行程卡下载app过调用来停止识别过程stopListenin通信达g()

最后找到Match按钮代码,如下:

按钮(“匹配”){
}
.font(.title)

在按钮操作块中,添加:

status =  "Listening..."
isListening =  true 
do {
   try matcher ? 。匹配()
}抓{
  status =  "匹配歌曲时出错"
}

这就是魔术开始的地方。您更改status以告诉用户实例化一个对象可以使用什么命令应用程序正在侦听并调用match()以启动匹配过程。当SHSession返回索引图结果时MatchingHelper,它调用songMatched(item:err笔记本电脑开不了机or:).

接下来,您将测试该应用程序。

测试应用程序

注意:在撰写本文时,您只能在物理设备上测试 ShazamKit。您还需要一个 Apple 开发人员帐户才能在 ShazamKit 应用服务中注册一个应用 ID。您必须在 Apple Devel实例化一个对象可以使用什么命令oper Portal 上手动执行此配置:

适用于 iOS 的 ShazamKit 入门教程

之后,相应地设置捆绑标识符和通信人家园签名设置。

要尝试匹配歌曲,请在 iPhone 上构建并运SwiftUI行该应用程序。

适用于 iOS 的 ShazamKit 入门教程

打开以下YouTube 链接播放歌曲。你能猜出这首歌吗?

索引失效的几种情况点“匹配”并将您的 iPhone 靠近扬声器。几秒钟后,你会看到匹配:

适用于 iOS 的 ShazamKit 入门教程

万岁!该应用程序成功匹配了歌曲。

使用自定义目录

您学习了如何使用 Shazam笔记本电脑开不了机Kit 将音频与 Shazam 目录进行匹配。如果您想匹配您的音乐作品或视频内容怎么办?ShazamKit 为您提供保障。

现在您将索引超出矩阵维度实现 DevCompanion 的剩余部分,即视频内容选项卡。您将首先将音频与您将创建的自定义目录进行匹配。

该应用程序笔记本将识别*您的第一个 iOS 和 Sw笔记本iftUI 应用程序的介绍视频:从零开始的应用程序视频课程。这是一个很棒的免费笔记视频课程,用于学习 SwiftUI 的基础知识。*

在此之前,您需要了解有关 Shazam 签名文件的更多信息。

Shazam 签名文件

如您之前所见,Shazam 目录是签名及其元数据的集合。但是 Shazam 签名是什么样的?

Shazam 签名存储通信大数据行程卡在扩展名为笔记*.shazamsignature*的文件中通信地址。它们是不透明的文件,您可以安全地从远程服务器共笔记本享或下载它们。

在项目导航器中,展开Signatures索引页是哪一页。您会找到DevCompanio笔记本电脑一直充电好吗n.shazamsignature,这是 SwiftUI 课程介绍视频的 Shazam 签名文件。

此签名文件将是您的自定义目录笔记中的参考签名。ShazamKit实例化是什么意思 会将查询签名与此签名文件进行比较,以确定您是在播放介绍视频还是其他内容。

接下来,您将创建一个自定义目录。

创建自定义目录

在Data中创建一个 Swift 文通信行程卡件。在 Projec通信大数据行程卡t naviga笔记本电脑什么牌子好tor 中,右键单击Data文件夹并选择New File…。

适用于 iOS 的 ShazamKit 入门教程

然后,选择Swift File并单击Next

适用于 iOS 的 ShazamKit 入门教程

接下来,将其命名为DevVideosCatalog.swift并单击Create。最后,打开文件并添加:

导入ShazamKit
枚举 DevVideosCatalog {
   static  func  catalog () throws -> SHCustomCatalog ? {
     // 1. 确保签名文件存在
    guard  let signaturePath =  Bundle .main.url(
      forResource: "DevCompanion" ,
      withExtension: "shazamsignature" ) else {
       return  nil
    }
    // 2. 读取签名文件并实例化一个 SHSignature 
    let signatureData =  try  Data (contentsOf: signaturePath)
     let refSignature =  try  SHSignature (dataRepresentation: signatureData)
    // 3. 用这个签名的元数据创建一个 SHMediaItem 
    let videoMetadata =  SHMediaItem (
      特性: [
        .title: "你的第一个 iOS 和 SwiftUI 应用:一个从零开始的应用" ,
        .subtitle: "简介" ,
        .艺术家:“雷温德利希”
      ])
    // 4. 创建自定义目录。
    让customCatalog =  SHCustomCatalog ()
    试试customCatalog.addReferenceSignature(
      参考签名,
      表示:[videoMetadata])
    返回自定义目录
  }
}

catalog()返回 type 的对象,SHCustomCata索引是什么意思logShazamKit 为自定义目录提供的类型。这是一个静态方法,用于初始化您的自定义目录并返回它。在这里,它:

  1. 检查应用程序包中的 Shazam 签名文件DevCo实例化对象是什么意思mpanion.shazamsignature。如索引是什么意思果文件不存在,则返回 nil。
  2. 读取Data签名文件的内容并初始化refSignatur通信技术e,这是一笔记本电脑什么牌子好SHSignatureShazamKit 用索引超出了数组界限什么意思于存储签笔记本显卡天梯图名数据的容器类型索引的优缺点
  3. 定义videoMetadata,SwiftUI 课程介绍视频的元数据笔记本电脑开不了机。这是SHMediaItem具有一些预定义属性的。
  4. 初始索引超出了数组界限什么意思化目录,然后调用SHCustomCatalog.addReferenceSignat索引符号ur通信地址是写什么地址e(_:representing:)以使用您的元数据设置目录的引用签名。

接下来,您将根据这个新的自定义目笔记录匹配音频。

将音频笔记本与自定义目录匹配

打开Vid索引失效eoMatchVi实例化servlet类异常ew.swift并查看 Canvas 中的预览。

适用于 iOS 的 ShazamKit 入门教程

该视图看起来类似于SongMatchView

VideoMatchView删除和的整个当前代码VideoMatchView_Pre索引图views。然后,取消注释文件末尾索引超出了数组界限什么意思的代码以替换它们。

这个实现VideoMatchView现在与 相同SongMatchView,除了标索引超出了数组界限什么意思签名称不同,因为您匹配的是开发视频而不是歌曲。

例如,看看VideoMatchView.videoMatched(result:error:)

func  videoMatched(结果:SHMatchedMediaItem?,错误:错误?){
  isListening =  false
  如果错误!=  nil {
    status =  "无法匹配音频:(" 
    print ( String (描述: error.debugDescription))
  }其他{
    课程=结果?.title ?? 课程
    情节=结果?.副标题??插曲
    作者=结果?.艺术家??作者
  }
}

在这里,您将cou索引的作用rse文本设置为SHMatchedMediaItem‘stitle,将episode文本通信达设置为subtitle,将author文本设置为artist。毕竟,开发者和内容创作者不是艺术家吗?

接下来,找到Start Episode按钮并查看其操作代码笔记本

做{
  尝试匹配器?。匹配()
  }抓{
    status =  "匹配歌曲时出错"
}

正如您在前面的匹配音乐与 Shazam 的目录部分中看到的那样,MatchingHelper.match(catalog:)采用类型的通信地址是写什么地址可选参数将SHCustomCatalog其传递SwiftUISHSession.如果未传递自定义目录,则SHSession默认为 Shazam 目录。你需要索引失效的几种情况改变索引失效的几种情况它。

替换这一行:

尝试匹配器?。匹配()

和:

尝试匹配器?.match(目录:DevVideosCatalog .catalog())

在这里,您将笔记自定义目录传递给Mat笔记本电脑排名前十chingHelperSHSession在下一场比赛通信地址是写什么地址中使用它。现在,您已准备好进行测试。

打开 SwiftUI 课程介绍并播放视频。构建并运行。切换到视频内容选项卡并将手机靠近扬声器,以便它可以听到视频的配乐。

适用于 iOS 的 ShazamKit 入门教程

现在,点击开始剧集。几秒钟后,您将在顶部看到视频信息:

适用于 iOS 的 ShazamKit 入门教程

该应用程序匹配您自定义目录中的音频!

您还可以将自定义目录保存为不透明文件,就像使用SHCustomCatalog.write(to:).此文件具有扩展名*.shazamcatalog*。要了解更多信息,请查看Apple 文档。

注意:根据自笔记本定义索引目录匹配音频与匹配 Shazam 目录没有什么不同,只是ShazamKit在您的设备上进行本地匹配并且不必与 Shazam通信地址是写什么地址 的服务器通信。

注意:您也可以使用以下步骤创建自己的*.笔记本插电用好还是不插电shazamsignature*文件:

  1. 开始捕获音频AVAudioEngine– 与您之前所做的相同。
  2. AVAudioNode.in通信工程专业stallTap(onBus:bufferSize:format:block:), ca通信地址是写什么地址llSHSignatureGenerator的回调中,从回调参数中ap笔记本电脑什么牌子好pend(_:at:)传递bufferand 。audioTime这将从捕获的音频中生成一个签名。
  3. 曲目结束时停止录制。
  4. 写入SHSign笔记本电脑开不了机atureGenera实例化和初始化的区别tor.signature().dataRepresentation文件。

查看索引超出了数组界限什么意思教程材料文件夹中的ShazamSignatureGenerator项目。这是一个示例应用程序,可让您创建 Shazam 签名并将其导出到*.shazamsignature*文笔记件。

接下来,您将创建自定义音频体验。

将应用程序内容与音频同步

您将添加到 DevCompanion 的最后一个功能会在用户观看 SwiftUI 课程介绍时通信行程卡下载app向他们展示其他内容。您将向他们展示说明 R索引的优缺点ay 在介绍课程时所谈论的部分笔记本电脑一直充电好吗的注释。看看下面的插图:

适用于 iOS 的 ShazamKit 入门教程

该应用程序会将内容与视频播放位置同步。例如:

  • 00:05时,VideoMatchView将显示*Welcome!*和插图。
  • 00:1实例化4,当 Ray 描述您将在课程中构建的应用程序时,视通信工程专业图显示您的第一个 SwiftUI 应用程序!和应用索引的作用程序的屏幕截图。
  • 00:47Ray 谈到课程结构的第一部分时,视图索引的作用显示Course Overview: SwiftUI vs UIKit,该部分的标题和插图。

这不是很酷吗?接下来,您将实例化是什么意思实现这些注释。

实现注解

您将创建一个简单struct的标题、要显示的图像和显示它们的时间。

在 Project navigator 中,展开Data并单击VideoAnnotation.swift将其打开。在文件的开头,在注释的扩展名之前添加类的实例化以下内容:

struct  VideoAnnotation : Comparable , Equatable {
   let content: String
  让imageName: String ?
  让偏移量:TimeInterval
  初始化(内容:字符串,偏移量:TimeInterval,图像名称:字符串?= nil){
     self .content = content
     self .offset = offset
     self .imageName = imageName 
  }
  static  func  < ( lhs : VideoAnnotation , rhs : VideoAnnotation ) -> Bool {
     return lhs.offset < rhs.offset
  }
  static  func  == ( lhs : VideoAnnotation , rhs : VideoAnnotation ) -> Bool {
     return lhs.content == rhs.content && lhs.offset == rhs.offset
  }
}

Vi笔记本电脑一直充电好吗deoAn索引notation具有三个实例化属性:

  • content是用户看到的字符串标题。
  • imageName是注释图像名称。这是可选的。
  • offsetTimeInterval笔记应显示注释的秒数。

VideoAnnotation符合索引图Compar笔记本电脑able并且Equatable因为您需要比较注释以确定要显示的注释,稍后您将看到。

最后,在比较注释时通信大数据行程卡实现要使用的<索引是什么意思算符 from 。此外,您还实现了操作符 from,您可以在其中指定两个注释在匹配时相等。Comparable``offset``==``Equatable``co索引的作用ntentoffset

索引图消注释VideoAnno索引图tation下方的注释struct并查看sam索引的优缺点pleAnnotations您将使用的预定义注释数组。

每个定义都与此类似:

VideoAnnotation (content: "Welcome!" , offset: 5 , imageName: "an-1" )

注意:您可以在**Annotation Assets索引超出矩阵维度文件实例化是什么意思夹中查看资产目录中的图像。

接下来,通信工程专业您将更新VideoMatchView以显示注释。

显示同步的注解

首先VideoAnnot笔记ation返回VideoMatchView.

打开MatchingHelper.swift并将以下属性添加到类中:

typealias  MatchWithContentHandler  =
  (( SHMatchedMediaItem ?, VideoAnnotation ?, Error ?) -> Void )
 private  var matchWithContentHandler: MatchWithContentHandler ?
私有 变量lastMatch:SHMatchedMediaItem?
私有 变量lastAnnotationMatch: VideoAnnotation ?

matchWithContentHandler是一个类似于 的处实例化理程序块matchHandler,但它需要一个额外的参数VideoAnnotationla索引的优缺点stMatch存储索引是什么意思最后匹配的音频元数据并lastAnnotationMatch存储最后匹配笔记本的注释。

通信工程专业后,在类初始值设定项下方,添加:

初始化(matchWithContentHandler 处理程序:MatchWithContentHandler?){
  matchWithContentHandler =处理程序
}

这是另一个设置matchWithContentHandler.

注意:通过将matchHandle通信达r和都声明matchWithContentHandler为私有成员并为每个成员创建一个单独的类初始化程序,您可以确保委托方法只设置和调用一个。

接下来,您需要更新SHSessionDelegate以调用matchWithContentHandler.

将以下内容附加到通信工程session(_:didFind:)内的末尾DispatchQueue

if  let handler =  self .matchWithContentHandler {
   let matchingAnnotation =  VideoAnnotation 
    .sampleAnnotations.last { 注释在
      (match.mediaItems.first ? .predictedCurrentMatchOffset ??  0 ) > 
        注释.offset
  }
  if match.mediaItems.first !=  self .lastMatch 
     || 匹配注释!= 自我.lastAnnotationMatch {
    处理程序(match.mediaItems.first,matchedAnnotation ,nil)
    自我.lastMatch = match.mediaItems.first
     self.lastAnnotationMatch = matchedAnnotation
  }
}

每当SHSession打电话给session(_:didFind:)你:

  • 通过将每个注实例化是什么意思释的偏移量与SHMatchedMe索引图diaItem‘s进行比较来找到正确的注释predic实例化一个对象可以使用什么命令tedCurrentMatchO实例化ffset,这是预测的当前播放位置笔记本插电用好还是不插电
  • 每当匹配的音频或匹配的注释发生变化时,调用并match实例化WithConte通信工程专业ntHandler更新到最近的匹配。lastM通信工程atch``lastAnnotationMatch

根据自定义匹配的ShazamKit WWDC 会话session(_:didFind:),ShazamKit 可以多次调用相同的匹配。因此,您只想在收到通信行程卡新匹配时更新您的处理程序。

注意:之前,当你通信工程MatchingHelper在 中匹配音乐时SongMatchView,你stopListening()在调用 之后调用ma笔记本电脑一直充电好吗tchHandle实例化对象是什么意思r,如下所笔记本电脑示:

if  let handler =  self .matchHandler {
  处理程序(match.mediaItems.first,nil)
  自我.stopListening()
}

那是因为您只需要歌曲的元数据。此处您不调用stopListening(),因为您希望 Shaza笔记本电脑性价比排行2020mKit 继续收听并匹配predictedCurrentMat笔记本显卡天梯图chOffset当前所在的曲目。

接下来,将以下内容附加到session(_:didNotFindMatchFor:error:), 再次在DispatchQueue块内:

if  let handler =  self .matchWithContentHandler {
  处理程序(零,零,错误)
  自我.stopListening()
}

当没有匹配或有任何其他错误时,您调用matchWithContentHandler传递错误。然后您调用stopListening()以停止匹配过程。

最后,您将更新VideoMatchView笔记本电脑一直充电好吗以显示注释。

VideoMatchView.swift中,将以下内容替换为onAppear(perform:)

如果匹配器==  nil {
  matcher =  MatchingHelper (matchWithContentHandler: videoMatched)
}

在这里,您调用MatchingHelper的新实例化是什么意思初始化程序来设置matchWithContent笔记Handler

现在,替换VideoMatchView.videoMatched(通信行程卡下载appresult:error:)为:

func  videoMatched(
  结果:SHMatchedMediaItem?, 
  注释:VideoAnnotation?, 
  错误:错误?
) {
  如果错误!=  nil {
    status =  "无法匹配音频:(" 
    print ( String (描述: error.debugDescription))
  }其他{
    课程=结果?.title ?? 课程
    情节=结果?.副标题??插曲
    作者=结果?.艺术家??作者
    annotationImageName =注释?.imageName ?? 注释图像名称
    注释内容=注释?.内容?? 注释内容
    print ( "匹配更新:(String(描述:annotationContent)) " )
  }
}

在这里,您添加注释参数。您还可以设置注释的图像名称annotationImageNameannotationContent标题。

是时候测试应用程序了。

测试应用程索引的作用

您终于准备好测试新功能了。构建并运笔记本电脑排名前十行。然后切换到视频内容

适用于 iOS 的 ShazamKit 入门教程

播放 Sw通信行程卡下载appiftUI 课程介绍视频,然后点击Start Episode

首先,应用程通信行程卡序将识别视频并显示第一个注释:

适用于 iOS 的 ShazamKit 入门教程

然后,在00:14,应用程序将显示:

适用于 iOS 的 ShazamKit 入门教程

笔记下来,在00:47,应用程序将显示:

适用于 iOS 的 ShazamKit 入门教程

观看整个视频。别作弊!当你走到最后,回到中间,注意应用程序如何显示正确的注释。

结论

本教程的最终项目资料下载地址

链接:pan.baidu.com/s/1zc通信人家园rBA_9d…

提取码:r7z2

在本教程中,您了解了 ShazamKit 和 Shazam 的音频匹配过程。在此过程中,您还学习了如何:

  • 使用 Shazam 目录识别流行音乐。
  • 创建自定义目录并匹配您自己的音频。
  • 将应用内容与播放的音频类的实例化同步。

这里也推荐一些面试相关的内容!

  • ① BAT等各个大厂索引的优缺点iOS面试真题+答案大全

  • ② iOS中高级索引是什么意思开发必看的热门书籍(经典必看)

  • ③ iOS开发高级面试”简历制作”指导

  • ④ iOS面试流程到基础知识大全

发表评论

提供最优质的资源集合

立即查看 了解详情