Apple FairPlay en aplicaciones TVSDK

Para implementar la transmisión de FairPlay en la aplicación TVSDK, debe escribir un cargador de recursos que envíe una solicitud de adquisición de licencia a su servidor de transmisión de FairPlay.

El código del cargador de recursos es responsable de las siguientes tareas:

  1. Determine dónde enviar la solicitud de adquisición de licencia.
  2. Formatee la solicitud.
  3. Proporcione la información necesaria al servidor para que este pueda decidir si la solicitud debe estar permitida.

Por ejemplo, si utiliza el DRM de Primetime Cloud de Adobe con tecnología ExpressPlay, el cargador de recursos envía la solicitud a:

https://fp-gen.service.expressplay.com

El cargador de recursos da formato a la solicitud y adjunta un token ExpressPlay que autoriza la reproducción a la dirección URL. Al adquirir el token ExpressPlay, hay varias opciones que se deben tener en cuenta. Estas opciones están determinadas por la forma en que empaquetó el contenido.

Cuando empaqueta el contenido, el empaquetador inserta skd: URL en el manifiesto M3U8. Después de la entrada skd:, puede colocar cualquier dato en el manifiesto. Puede utilizar estos datos en el código de la aplicación para completar las tareas que se enumeran arriba. Por ejemplo, puede utilizar skd:{content_id} para que la aplicación pueda determinar el ID del contenido que se está reproduciendo y solicitar un token para ese contenido específico. También puede, por ejemplo, utilizar skd:{entitlement_server_url}?cid={content_id}, para que la aplicación no tenga que tener la URL del servidor de derechos codificada.

Es posible que no necesite información en la dirección URL skd: si, al iniciarse la reproducción, ya conoce el ID de contenido a través de otros canales. El segundo ejemplo es una solución ideal para probar la configuración, pero también puede utilizarla en un entorno de producción.

CONSEJO

Usted determina el formato de skd:.

El contenido se obtiene mediante el protocolo skd:, pero la solicitud de licencia utiliza https:. Las opciones más comunes para tratar con estos protocolos son:

  • Prueba inicial de la reproducción de extremo a extremoAl empaquetar el contenido, seleccione una skd: URL. Al probar la aplicación, adquiera manualmente una licencia de ExpressPlay y codifique la licencia (una URL https:) y la URL de contenido en el cargador.

    Por ejemplo:

    NSString* const PLAYLIST_URL =  
      @"https://{your_content_URL}/{your_manifest}.m3u8"; 
    NSString* const EXPRESSPLAY_TOKEN =  
      @"https://fp.service.expressplay.com:80/hms/fp/rights/? 
        ExpressPlayToken={copy_your_token_to_here}";
    
  • La mayoría de los demás casosAl empaquetar el contenido, seleccione una skd: URL que represente de forma exclusiva el ID del contenido. En el cargador, analice la dirección URL skd:, envíela al servidor para adquirir un token y utilice el token resultante como dirección URL.

    Por ejemplo:

    - (BOOL)resourceLoader:(AVAssetResourceLoader *)resourceLoader  
          shouldWaitForLoadingOfRequestedResource:(AVAssetResourceLoadingRequest *)loadingRequest { 
        NSURL *url = [[loadingRequest request] URL]; 
        if (![[url scheme] isEqual:@"skd"]) 
            return NO; 
    
        NSString *strUrl = [url absoluteString]; 
        NSLog(@"url is: %@", strUrl); 
    
        strUrl = [strUrl stringByReplacingOccurrencesOfString:@"skd://" withString:@"https://"]; 
    
        NSData *assetId; 
    
        NSData *requestBytes; 
        NSError* error = nil; 
        BOOL handled = NO; 
    
        NSData  *responseData = nil; 
    
        assetId = getMyAssetIdentifierFromURL(url); 
    
        /* Usecase 1: "On Premise Fairplay Server" 
         * Set the strUrl to the OnPremise Fairplay Server Url. The OnPremise Fairplay  
         * Server Url is either hardcoded in the App or derived from strUrl. 
         */ 
    #if 0  
        // Insert your use case 1 codes here: 
        // strUrl = getOnPremiseServerUrl(strUrl, assetId); 
    #endif // 
    
        /* Usecase 2: The strUrl is the entitlement server. 
         * Send assetId to the entitlement server; if the user is allowed to playback  
         * the content, the entitlement server will send back an ExpressPlay Token Url. 
         */ 
    
    #if 0 
        // The hardcoded SEES server: 
        strUrl = @"https://10.0.248.85:8080/sees/SEESServlet"; 
    
        // You can use the following code to simulate a device binding entitlement  
        // request:  
        // First, invoke getExpressPlayTokenUrlFromEntilementServer with  
        // bEnforceDeviceID set to false. When you play the content, the device_id  
        // will be registered on the ExpressPlay Server.  Now change code to set  
        // bEnforceDeviceID to true, and rerun the program. The ExpressPlay token  
        // sent back by the SEES server will be device bound. 
    
        // The strUrl returned below is the ExpressPlay Token URL. 
        strUrl = getExpressPlayTokenUrlFromEntilementServer(strUrl, assetId, true, &error); 
    #endif 
    
        /* Usecase 3: The strUrl is already the ExpressPlay Token Url. 
         */ 
    
        // Read in the certificate 
        NSLog(@"Get Application Certificate"); 
        NSString* certPath = [[NSBundle mainBundle] pathForResource:@"my_certificate.cer"  
                                                             ofType:nil]; 
    
        NSData *appCert = [NSData dataWithContentsOfFile:certPath]; 
    
        // To create the request blob for the server: 
        requestBytes = [loadingRequest streamingContentKeyRequestDataForApp: appCert 
                                                          contentIdentifier:assetId  
                                                                    options:nil  
                                                                      error:&error]; 
        if (requestBytes == nil) { 
            NSLog(@"Error creating server request: %@", error); 
            return false; 
        } 
        // Per the specification, send requestBytes along with the assetId to the Key 
        // Server and obtain the response. 
        NSError *err; 
    
        responseData = getCKCFromExpressPlayService( strUrl, requestBytes, assetId, &err); 
    
        if (responseData != nil) { 
            NSLog(@"Get response data: "); 
            [loadingRequest finishLoadingWithResponse:nil  
                                                 data:(NSData *)responseData 
                                             redirect:nil]; 
        } 
        else { 
            [loadingRequest finishLoadingWithError:err]; 
            NSLog(@"bad key response"); 
        } 
        handled = YES; 
    bail: 
        return handled; 
    
    }
    

Habilitar Apple FairPlay en aplicaciones TVSDK

Puede implementar Apple FairPlay Streaming, que es la solución DRM de Apple, en sus aplicaciones TVSDK.

  1. Cree su cargador de recursos del cliente de FairPlay implementando PTAVAssetResourceLoaderDelegate.

    Para obtener más información, consulte Apple FairPlay en aplicaciones TVSDK.

    NOTA

    Asegúrese de seguir las instrucciones de la FairPlay Streaming Program Guide ( FairPlayStreaming_PG.pdf), que se incluye en el SDK de FairPlay Server para el desarrollo de una aplicación compatible con FPS).

    El método resourceLoader:shouldWaitForLoadingOfRequestedResource es equivalente a lo que se encuentra en AVAssetResourceLoaderDelegate.

    IMPORTANTE

    En el caso del servidor de licencias ExpressPlay, para reproducir contenido, cambie el esquema URL de la solicitud de licencia del servidor ExpressPlay FairPlay de skd:// a https:// (o https://).

  2. Registre el FairPlay Customer Resource Loader con registerPTAVAssetResourceLoader.

    PTFairPlayResourceLoader *resourceLoader =  
      [[PTFairPlayResourceLoader new] autorelease];  
    [[PTDefaultMediaPlayerClientFactory defaultFactory]  
      registerPTAVAssetResourceLoader:resourceLoader];
    

Si escribió su propio servidor de licencias de FairPlay o está utilizando un servidor de licencias de terceros de FairPlay, consulte con el proveedor del servidor de licencias para determinar la URL, el formato y cualquier otro requisito del servidor de licencias.

En esta página

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now