FeedMedia
介绍
Feed.fm 是一项服务,允许您在移动应用程序中添加流行音乐。该仓库中的 SDK 为您提供了简单的 UI 组件,您可以根据需要对其进行修改或直接在应用程序中使用。
要报告错误或提问,请发送电子邮件至 [email protected]。
安装
您不需要下载此仓库 - 您可以使用 SPM 将其添加到您的应用程序中。
Swift 包管理器
从 Xcode 12 开始,您可以使用 Swift 包管理器 将 Feed 媒体添加到您的项目中。
- 选择“文件”>“Swift 包”>“添加包依赖项”。在“选择包仓库”对话框中输入
https://github.com/feedfm/iOS-SDK
。 - 在下一页中,指定版本解析规则为“升至下一个主要版本”,其最早版本为“5.0.0”。
- 在 Xcode 检出源并解析版本之后,您可以选择“FeedMedia”库并将其添加到您的应用程序目标中。
CocoaPod
您希望在 Podfile 中像以下这样添加 pod 'FeedMedia', '~> 5.1':
target 'MyApp' do
pod 'FeedMedia', '~> 5.1'
end
然后在您的终端中或在 CocoaPods.app 中运行 pod install。
或者,为了进行一次测试运行,运行以下命令
pod try FeedMedia
没有包管理器?没问题!
如果想在没有 spm 的情况下将此库集成到您的应用程序中,请执行以下操作:
- 克隆此存储库,并将 FeedMedia.xcframeworks 文件夹拖入项目中的“框架和库”部分。就是这样!
入门指南
SDK 围绕一个唯一实例的 FMAudioPlayer
类,该类有简单的方法来控制音乐播放(播放、暂停、跳过)。FMAudioPlayer 维护一个 FMStation 对象的列表(stationList),其中之一始终被视为活动站(activeStation)。一旦开始播放音乐,就会有当前歌曲(currentSong)。
典型的初始化和设置如下:
尽早地在您的应用生命周期中调用
[FMAudioPlayer setclientToken:@"demo" secret:@"demo"]
来异步连接到feed.fm服务器,验证客户端是否位于可以合法播放音乐的位置,然后检索可用的音乐电台列表。
您可以使用一些样本凭据来帮助测试您的应用。以下字符串可用于token和secret以获得期望的行为
‘demo’ - 3个简单的电台,没有跳过限制
‘badgeo’ - feed.fm将此客户端视为从美国以外地区访问
‘counting’ - 一个电台,只播放语音说出的0到9的数值的极短音频片段
要收到音乐可用或不可用的通知,使用whenAvailable:notAvailable:方法调用,它在音乐被认为可用或不可用时保证仅调用其参数之一
FMAudioPlayer *player = [FMAudioPlayer sharedPlayer];
[player whenAvailable:^{
NSLog(@"music is available!");
// .. do something, now that you know music is available
// set player settings
player.crossfadeInEnabled = true;
player.secondsOfCrossfade = 4;
[player play];
} notAvailable: ^{
NSLog(@"music is not available!");
// .. do something, like leave music button hidden
}];
// Set Notifications for ex to listen for player events
[[NSNotificationCenter defaultCenter] addObserver:self selector:@selector(stateDidChange:) name:FMAudioPlayerPlaybackStateDidChangeNotification object:[FMAudioPlayer sharedPlayer]];
了解更多!
在demo.Feed.fm找到SDK的Appledocs。
创建自定义音乐电台需要在Feed.fm上创建账户,但您可以使用包含的demo凭据在此处测试我们的样本应用。您还可以查看我们完全预构建的音乐播放器RadioPlayer和Radioplayer 2,它们位于GitHub上并使用此库。
问题所在!
如果您发现了一个问题,请发送电子邮件到[email protected],详细描述您的问题以及任何可用于帮助我们重现问题的信息。
作者
授权协议
FeedMedia遵循MIT协议。更多信息请查看LICENSE.md文件。