曝光

• 特性
• 许可证
• 要求
• 安装
• 入门指南
• 文档
  • 身份验证最佳实践
  • 请求回放权限
  • 内容发现
  • 分析交付
  • 错误处理和响应验证
  • Firebase 登录
• 发行说明
• 升级指南

特性

• 资产搜索
• 身份验证
• 回放权限请求
• 下载权限请求
• EPG 发现
• 分析丢失
• 服务器时间同步
• 轮播图集成
• 动态客户配置
• 带自动补全的内容搜索

要求

• iOS 9.0+

• tvOS 10.0+

• Swift 4.0+

• Xcode 9.0+

• 框架依赖

安装

Swift 包管理器

Swift 包管理器是一个用于自动分发 Swift 代码的工具，并集成到 Swift 编译器中。一旦您设置好 Swift 包，将 iOSClientExposure 添加为依赖项就像将其添加到 Package.swift 的依赖项值中一样简单。

dependencies: [
    .package(url: "https://github.com/EricssonBroadcastServices/iOSClientExposure", from: "3.4.0")
]

Carthage

Carthage 是一个去中心化的依赖项管理器，它在不干扰您的 Xcode 项目设置的情况下构建您的依赖图。通过 fastlane 也可实现 CI 集成。

通过执行以下命令使用 Homebrew 安装 Carthage

$ brew update
$ brew install carthage

一旦 Carthage 已安装，您需要创建一个 Cartfile，它指定了您的依赖项。有关 Cartfile 及由 Carthage 创建的其他对象的详细信息，请参阅 artifacts 文档。

github "EricssonBroadcastServices/iOSClientExposure"

运行 carthage update 将获取您的依赖项并将它们放置在 /Carthage/Checkouts 中。您可以构建 .framework 并将其拖放到您的 Xcode 或将获取的项目附加到您的 Xcode workspace。

最后，请确保将 .framework 添加到您的目标 General -> Embedded Binaries 部分。

CocoaPods

CocoaPods 是 Cocoa 项目的依赖项管理器。有关使用和安装说明，请访问其网站。要使用 CocoaPods 将 iOSClientExposure 集成到您的 Xcode 项目中，请将其指定在您的 Podfile 中

pod 'iOSClientExposure', '~>  3.4.0'

入门指南

Exposure 提供了与 EMP Exposure Layer 的无缝集成，并使客户端应用程序能够快速访问功能，如 身份验证、权限请求 和 EPG。

EMP Exposure Layer 有三个至关重要的重要概念。

• 环境 描述了针对特定客户的 曝光 环境
• SessionToken 代表一个已验证的用户会话
• 资产 ID 是系统中媒体资产的唯一标识符。

与 EMP Exposure layer 任何交互的基本构建块是 环境。此 struct 详细说明了发出请求所需的针对特定客户的信息。

除了环境Environment外，访问大多数功能还需要有效的SessionToken。该令牌在通过Authenticate端点成功认证后返回。处理用户认证的方法有几个，如下所述。

Authenticate(environment: exposureEnv)
    .login(username: someUser,
           password: somePassword)
           
Authenticate(environment: exposureEnv)
    .anonymous()

最后，资产 ID 指的是唯一的媒体资产，可能表示诸如 电视剧、电影、电视频道 或 片段 这样的事物。客户端应用在引用 EMP 系统 中的媒体时应使用此 ID。

发行说明

特定版本的更改可以在CHANGELOG中找到。

升级指南

从一个版本升级到另一个版本的程序取决于您的客户端应用程序选择如何集成Exposure。

版本之间的主要更改将以特殊的升级指南进行记录。

Carthage

通过运行带有相关选项的carthage update来更新您的依赖项，例如--use-submodules，具体取决于您的项目设置。有关使用Carthage进行依赖项管理的更多信息，请参阅他们的文档或运行carthage help。