iOS音频播放器

iOS音频播放器是一个基于Swift的iOS模块，它提供播放控制功能。此模块是AVPlayer的包装。

项目原因

该框架的目的在于通过提供以下功能，为播放控制提供一个简单的应用程序内解决方案：

• 播放和暂停功能
• 播放器项管理
• 主播放器状态触发的通知
• 每次媒体项加载时触发的通知
• 跳过特定时间间隔的方法
• 跳转到特定偏移量的方法
• 在后台播放并从睡眠状态的SpringBoard控制

要求

• iOS 8.0+
• Xcode 8.2+

安装

手动

如果您不想使用 CocoaPods，则可以将 iOSAudioPlayer 手动集成到项目中。

嵌入式框架

• 打开终端，使用 cd 进入顶级项目目录，并运行以下命令（如果您的项目未初始化为git存储库）

$ git init

• 通过运行以下命令将 iOSAudioPlayer 作为git 子模块 添加：

$ git submodule add hhttps://github.com/3pillarlabs/ios-audio-player.git

• 打开新的 iOSAudioPlayer 文件夹，将 iOSAudioPlayer.xcodeproj 拖动到您的应用程序的Xcode项目的项目导航器中。

它应该嵌套在您的应用程序的蓝色项目图标下面。它在所有其他Xcode组之上或之下并不重要。

• 在项目导航器中选择 iOSAudioPlayer.xcodeproj 并验证部署目标与您的应用程序目标相匹配。
• 然后，在项目导航器中选择您的应用程序项目（蓝色项目图标）导航到目标配置窗口，并选择侧边栏中“目标”下方的应用程序目标。
• 在那个窗口的选项卡栏中，打开“基本”面板。
• 在“已嵌入的二进制文件”部分的 + 按钮上单击。
• 您将看到两个不同的 iOSAudioPlayer.xcodeproj 文件夹，每个文件夹中都有两个不同的版本 iOSAudioPlayer.framework 嵌套在 Products 文件夹中。

您可以选择任何一个 Products 文件夹，但您必须选择顶部或底部的哪个 iOSAudioPlayer.framework。

• 选择iOS的顶级iOSAudioPlayer.framework。

• 就是这样！

iOSAudioPlayer.framework将自动作为目标依赖项、链接框架和嵌入框架添加到复制文件构建阶段，这是您在模拟器和设备上构建所需的所有内容。

源文件

如果您希望使用传统的集成方式，可以将位于Classes目录内的所有Swift文件（Classes/*.*）直接添加到您的项目中。请注意，您将不再需要导入iOSAudioPlayer，因为实际上并没有加载框架。

用法

• 通过调用TPGAudioPlayer.sharedInstance()来使用TPGAudioPlayer类的共享实例。
• 通过调用方法来播放特定的媒体文件

public func playPauseMediaFile(audioUrl: NSURL, springboardInfo: [String : AnyObject], startTime: Double, completion: (previousItem: String?, stopTime: Double) -> ())

• 使用方法跳过特定的时间间隔

public func skipDirection(skipDirection: iOSAudioPlayer.SkipDirection, timeInterval: Double, offset: Double)

• 将播放器导航到特定的偏移量

public func seekPlayerToTime(value: Double, completion: (() -> Void)!)

• 检查当前播放项的持续时间

public var durationInSeconds: Double { get }

• 检查当前播放项在当前播放器上的进度

public var currentTimeInSeconds: Double { get }

• 监听触发特定媒体文件包加载通知

public let TPGMediaLoadedStateNotification: String

在“iOSAudioPlayer示例”项目中，您可以了解框架的使用情况。

通信

• 如果您发现了错误，请在新GitHub问题中打开一个问题github。
• 如果您有功能请求，请在新GitHub问题中打开一个问题github。
• 如果您希望做出贡献，提交一个pull request。

关于本项目

iOSAudioPlayer由3Pillar Global开发和维护。

许可证

iOSAudioPlayer可在MIT许可证下获得。有关更多信息，请参阅LICENSE文件。