TopDMC iOS SDK 是为了愿意将 TopDMC 音乐服务集成到他们 iOS 应用程序中的开发者而设计的。

要求

此 SDK 需要iOS的部署目标为iOS 7或更高版本。以下架构得到支持：设备上的armv7、armv7s和arm64，以及iOS模拟器上的i386和x86_64。

入门

用法

1. 在 TopDMC 获取开发者账号

   如果您有一个有效的 TopDMC 开发者账号，您可能有一对 ClientID 和 AppKey。

2. 配置播放器心跳代理

   TopDMC SDK 需要跟踪您的播放状态，以确保应用程序客户端在有效地使用音乐。同时，这也有助于我们防止未经验证的第三方客户端使用您的 TopDMC 账号。

   [[TopDMC sharedInstance] setHeartBeatDelegate:self];
   

   有关心跳代理的更多信息，请检查 TopDMCClient.h 头文件

3. 注册 Open API 客户端

   您应该在 AppDelegate（或仅执行一次的地方）中使用以下代码为您的开发者账号注册 SDK。

   [[TopDMC sharedInstance] registerApp:APP_KEY clientID:CLIENT_ID];
   

4. 通过服务提供的 API 获取音乐信息。

   例如，我们可以使用 DMCTrackService 获取随机音乐

   [[DMCTrackService sharedService] getRandomTrackWithSuccess:^(DMCTrack *track) {
       NSLog("Random Track gotten: %@", track.name);
   } failure:^(NSString *error) {
       NSLog("Random Track failed: %@", errors);        
   }];
   

   我们可以通过 DMCTrackService 获取有效的音乐资源 URL，并使用您喜欢的任何流播放器播放它

   [[DMCTrackService sharedService] getTrackURLWithTrackID:track.ID bitRate:DMCTrackRate128 success:^(NSString *trackURL) {
       NSLog("%@ track url: %@", track.name, trackURL);
    } failure:^(NSString *error) {
       NSLog("get track failed: %@", error);        
    }];
   

5. 在构建设置中构建目标“其他链接标志”中添加“-ObjC”。

有关 SDK 的更多信息，请访问 WiKi(Beta)

示例

示例项目是一个简单的广播应用，它播放从 DMC 的随机音乐。您可以通过下载代码测试它，在项目根目录下运行 pod install，并在 info.plist 文件中配置您的 AppKey 和 ClientID。

联系我们

访问 https://www.topdmc.com

许可证

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