KeySystemConfiguration

public class KeySystemConfiguration : NSObject, Codable

Key system configuration.

  • Specifies the URL of the licensing server.

    Declaration

    Swift

    public var licenseAcquisitionURL: URL?

  • Specifies the URL of the FairPlay certificate server.

    Declaration

    Swift

    public var certificateURL: URL?

  • Specifies the license type.

    Declaration

    Swift

    public var licenseType: LicenseType?

  • Optionally specifies request headers that should be sent with any license requests to the DRM server. This is a plain object where the keys of the object are header names and corresponding values are header values.

    Declaration

    Swift

    public var headers: [String : String]?

  • Record of query parameters for the licence acquisition request. Each entry contains a query parameter name with associated value.

    Declaration

    Swift

    public let queryParameters: Dictionary<String, String>?

  • The DRM certificate as raw bytes: the FairPlay application certificate (DER encoded), or the Widevine service certificate (SignedDrmCertificate bytes) used when casting.

    Remark

    • When a non-empty certificate is provided it is used directly and no request is sent to certificateURL, so the ContentProtectionIntegration.onCertificateRequest and onCertificateResponse handlers are not called.
    • When nil or empty, the certificate is fetched from certificateURL.
    • In serialized form (e.g. on a TypedSource sent to a Chromecast receiver) the certificate is represented as a standard-Base64-encoded string.

    Declaration

    Swift

    public var certificate: Data?

  • Constructs a KeySystemConfiguration.

    Declaration

    Swift

    public init(licenseAcquisitionURL: String? = nil, certificateURL: String? = nil, licenseType: LicenseType? = nil, headers: [String : String]? = nil, queryParameters: Dictionary<String, String>? = nil, certificate: Data? = nil)

    Parameters

    licenseAcquisitionURL

    The URL of the licensing server, defaults to nil.
    certificateURL

    The URL of the certificate server, defaults to nil.
    licenseType

    The type of license, defaults to nil.
    queryParameters

    record of query parameters for the licence acquisition request. Each entry contains a query parameter name with associated value.
    certificate

    The DRM certificate as raw bytes (DER-encoded FairPlay application certificate, or Widevine service certificate), defaults to nil. When provided, no request is sent to certificateURL.