TVSDK應用程式中的Apple FairPlay

若要在TVSDK應用程式中實作FairPlay串流，您需要編寫資源載入器，將授權取得要求傳送至FairPlay串流伺服器。

資源載入程式碼負責以下任務：

1. 決定要在何處傳送授權取得要求。
2. 格式化請求。
3. 提供必要的資訊給伺服器，讓伺服器可決定是否允許要求。

例如，如果您使用由ExpressPlay提供支援的Adobe的Primetime Cloud DRM，您的資源載入器會將要求傳送至：

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

「資源載入器」會格式化請求，並附加ExpressPlay Token，以授權播放至URL。 在取得ExpressPlay Token時，有幾個選項需要考慮。 這些選項取決於您封裝內容的方式。

當您封裝內容時，封裝程式會在您的M3U8資訊清單中插入skd: URL。 在skd:項目之後，您可將任何資料放入資訊清單中。 您可以在應用程式碼中使用此資料來完成上述工作。 例如，您可以使用skd:{content_id}，讓您的應用程式可以判斷所播放內容的ID，並請求該特定內容的Token。 例如，您也可以使用skd:{entitlement_server_url}?cid={content_id}，讓您的應用程式不需要硬式編碼權益伺服器URL。

當播放開始時，如果您已透過其他頻道瞭解內容ID，則可能不需要skd: URL中的任何資訊。 第二個範例是測試您設定的理想解決方案，但您也可以在生產環境中使用它。

您的內容是使用skd:通訊協定取得，但您的授權要求使用https:。 處理這些通訊協定的最常用選項是：

• 端對端播放的初始測試封 裝內容時，請選取 skd: URL。在測試您的應用程式時，請手動從ExpressPlay取得授權，並在載入器中硬式編碼授權(https: URL)和內容URL。

  例如：

  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}";
  

• 大多數其 他案例在封裝內容時，請選取唯 skd: 一代表內容ID的URL。在您的載入器中，剖析skd: URL，將它傳送至您的伺服器以取得Token，然後使用產生的Token做為URL。

  例如：

  - (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;
  
  }
  

在TVSDK應用程式中啟用Apple FairPlay

您可以在TVSDK應用程式中實作Apple FairPlay串流（Apple的DRM解決方案）。

1. 實施PTAVAssetResourceLoaderDelegate以建立FairPlay客戶資源載入器。 如需詳細資訊，請參閱TVSDK應用程式中的Apple FairPlay。

   注意

   請確定您遵循​FairPlay串流程式指南(FairPlayStreaming_PG.pdf)中的指示，此指示包含在FairPlay Server SDK中，以開發FPS-Aware App)。

   方法resourceLoader:shouldWaitForLoadingOfRequestedResource等效於AVAssetResourceLoaderDelegate中的內容。

   注意

   在ExpressPlay授權伺服器案例中，若要播放內容，請將ExpressPlay FairPlay伺服器授權要求URL中的URL配置從skd://變更為https://（或https://）。

2. 使用registerPTAVAssetResourceLoader註冊​FairPlay​客戶資源載入器。

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

   注意

   如果您自行編寫FairPlay授權伺服器，或您使用協力廠商FairPlay授權伺服器，請洽詢您的授權伺服器廠商，以判斷您的授權伺服器URL、格式設定及任何其他需求。