Utilizzare l'SDK IMA DAI su iOS

Riprodurre live streaming registrati con l'API Video Stitcher di Google Cloud

Questa guida mostra come utilizzare l'SDK IMA DAI per iOS per richiedere e riprodurre un live streaming per un evento registrato con l'API Video Stitcher di Google Cloud e come inserire un'interruzione pubblicitaria durante la riproduzione.

Questa guida espande l'esempio di base della guida introduttiva per IMA DAI.

Per informazioni sull'integrazione con altre piattaforme o sull'utilizzo degli SDK IMA lato client, consulta SDK Interactive Media Ads.

Se vuoi visualizzare o seguire un'integrazione di esempio completata, scarica l'esempio di strumento di stitching video di Cloud per Objective-C o Swift.

Configura un progetto Google Cloud

Inserisci le seguenti variabili da utilizzare nell'SDK IMA:

Località
La regione Google Cloud in cui è stata creata la configurazione live: LOCATION
Numero progetto
Il numero del progetto Google Cloud che utilizza l'API Video Stitcher:PROJECT_NUMBER
Token OAuth

Token OAuth di breve durata di un account di servizio con il ruolo utente Video Stitcher: 

OAUTH_TOKEN

Scopri di più sulla creazione di credenziali di breve durata per gli account di servizio. Il token OAuth può essere riutilizzato in più richieste purché non sia scaduto.

Codice di rete

Il codice di rete Ad Manager per richiedere gli annunci: NETWORK_CODE

ID configurazione live
L'ID di configurazione live che hai specificato durante la creazione dell'evento di live streaming: LIVE_CONFIG_ID
Chiave asset personalizzata
La chiave asset personalizzata di Ad Manager generata durante la creazione di una configurazione per un evento di live streaming con l'API Video Stitcher: CUSTOM_ASSET_KEY

Contesto utente
Il contesto utente per il monitoraggio delle richieste. Può essere nil. Per impostazione predefinita, in questa guida è nil.

Scarica e prepara l'esempio di base

Scarica gli esempi di IMA DAI per iOS ed estrai l'esempio di base in una nuova cartella. Questo esempio è un progetto Xcode che si basa su Cocoapods per caricare l'SDK IMA.

Per preparare l'esecuzione dell'esempio, assicurati che CocoaPods sia installato, quindi apri la cartella dell'esempio di base nel terminale ed esegui il seguente comando:

pod install --repo-update

Al termine del comando, nella cartella del progetto viene visualizzato un file denominato BasicExample.xcworkspace. Apri questo file in Xcode ed esegui l'esempio per assicurarti che il video di test e gli annunci vengano riprodotti come previsto.

Richiedi un live streaming

Per sostituire lo stream di esempio con il tuo live streaming, devi utilizzare la classe IMAVideoStitcherLiveStreamRequest che crea automaticamente una sessione di annunci con Google Ad Manager. Puoi utilizzare l'interfaccia utente di Google Ad Manager per individuare le sessioni DAI generate a scopo di monitoraggio e debug.

Nell'esempio esistente sono presenti esempi di richiesta di uno stream VOD o di un live streaming dai server DAI di Google. Per far funzionare l'esempio con l'API Video Stitcher di Google Cloud, dovrai sostituire la funzione requestStream corrente con una che utilizza la classe IMAVideoStitcherLiveStreamRequest:

ViewController.m

#import <GoogleInteractiveMediaAds/GoogleInteractiveMediaAds.h>

/// Fallback URL in case something goes wrong in loading the stream. If all goes well,
/// this will not be used.
static NSString *const kTestAppContentUrl_M3U8 =
    @"//devimages.apple.com/iphone/samples/bipbop/bipbopall.m3u8";


static NSString *const kLiveConfigID = @"LIVE_CONFIG_ID";
static NSString *const kLocation = @"LOCATION";
static NSString *const kProjectNumber = @"PROJECT_NUMBER";
static NSString *const kOAuthToken = @"OAUTH_TOKEN";
static NSString *const kNetworkCode = @"NETWORK_CODE";
static NSString *const kCustomAssetKey = @"CUSTOM_ASSET_KEY";


@interface ViewController () <IMAAdsLoaderDelegate, IMAStreamManagerDelegate>
...
- (void)requestStream {
  // Create an ad display container for ad rendering.
  IMAAdDisplayContainer *adDisplayContainer =
      [[IMAAdDisplayContainer alloc] initWithAdContainer:self.videoView
                                          viewController:self
                                          companionSlots:nil];
  // Create an IMAAVPlayerVideoDisplay to give the SDK access to your video player.
  IMAAVPlayerVideoDisplay *imaVideoDisplay =
      [[IMAAVPlayerVideoDisplay alloc] initWithAVPlayer:self.contentPlayer];


  IMAVideoStitcherLiveStreamRequest *streamRequest =
      [[IMAVideoStitcherLiveStreamRequest alloc] initWithLiveStreamEventID:kLiveConfigID
                                                                    region:kLocation
                                                             projectNumber:kProjectNumber
                                                                OAuthToken:kOAuthToken
                                                               networkCode:kNetworkCode
                                                            customAssetKey:kCustomAssetKey
                                                        adDisplayContainer:adDisplayContainer
                                                              videoDisplay:imaVideoDisplay
                                                               userContext:nil
                                                               videoStitcherSessionOptions:nil];

  [self.adsLoader requestStreamWithRequest:streamRequest];
}

(Facoltativo) Aggiungi opzioni della sessione di streaming

Personalizza la richiesta di stream aggiungendo opzioni di sessione per sostituire la configurazione predefinita dell'API Video Stitcher di Cloud compilando il videoStitcherSessionOptions parametro in IMAVideoStitcherLiveStreamRequest. Se fornisci un'opzione non riconosciuta, l'API Video Stitcher di Cloud risponderà con un errore HTTP 400. Per assistenza, consulta la guida alla risoluzione dei problemi.

Ad esempio, puoi sostituire le opzioni del manifest con il seguente snippet di codice, che richiede due manifest di stream con rendering ordinati dal bitrate più basso a quello più alto.

Objective-C

 // Define session options JSON string.
 // The following session options are examples. Use session options
 // that are compatible with your video stream.
 NSString *sessionOptionsStr =
   @"{"
   "  \"manifestOptions\": {"
   "    \"bitrateOrder\": \"ascending\""
   "  }"
   "}";
 // convert JSON NSString to NSDictionary
 NSData *sessionOptionsData = [sessionOptionsStr dataUsingEncoding:NSUTF8StringEncoding];
 NSError *error = nil;
 NSDictionary *sessionOptions = [NSJSONSerialization
                       JSONObjectWithData:sessionOptionsData
                       options:0
                       error:&error];
 // make stream request
 IMAVideoStitcherLiveStreamRequest *streamRequest =
     [[IMAVideoStitcherLiveStreamRequest alloc] initWithLiveStreamEventID:kLiveConfigID
                                                                   region:kLocation
                                                           projectNumber:kProjectNumber
                                                               OAuthToken:kOAuthToken
                                                             networkCode:kNetworkCode
                                                           customAssetKey:kCustomAssetKey
                                                       adDisplayContainer:adDisplayContainer
                                                             videoDisplay:imaVideoDisplay
                                                             userContext:nil
                                             videoStitcherSessionOptions:sessionOptions];
 [self.adsLoader requestStreamWithRequest:streamRequest];

Swift

 // Define session options JSON string.
 // The following session options are examples. Use session options
 // that are compatible with your video stream.
 let sessionOptionsStr = """
     {
       "manifestOptions": {
         "bitrateOrder": "ascending"
       }
     }
     """
 // convert JSON string to dictionary
 guard let sessionOptionsData = sessionOptionsStr.data(using: .utf8, allowLossyConversion: false) else { return nil }
 let sessionOptions = try? JSONSerialization.jsonObject(with: sessionOptionsData, options: .mutableContainers)
 // make stream request
 let streamRequest = IMAVideoStitcherLiveStreamRequest(
   liveStreamEventID:ViewController.liveConfigID
   region:ViewController.location
   projectNumber:ViewController.projectNumber
   OAuthToken:ViewController.oAuthToken
   networkCode:ViewController.networkCode
   customAssetKey:ViewController.customAssetKey
   adDisplayContainer:adDisplayContainer
   videoDisplay:imaVideoDisplay
   userContext:nil
   videoStitcherSessionOptions:sessionOptions)
 adsLoader?.requestStream(with: streamRequest)

Esegui il progetto, quindi puoi richiedere e riprodurre il tuo live streaming personalizzato.

Inserisci un'interruzione pubblicitaria

L'API Video Stitcher di Google Cloud inserisce gli annunci recuperati dal tag annuncio per ogni interruzione pubblicitaria. Le interruzioni pubblicitarie sono indicate nel manifest utilizzando gli indicatori di annunci. Gli indicatori di annunci vengono inseriti dal codificatore di live streaming.

L'annuncio viene riprodotto immediatamente dopo l'inserimento dell'interruzione pubblicitaria.

Libera spazio

Ora che hai ospitato correttamente un live streaming utilizzando l'API Video Stitcher di Google Cloud e l'hai richiesto utilizzando l'SDK IMA DAI per iOS, è importante liberare spazio per tutte le risorse di pubblicazione.

Segui la guida alla pulizia del live streaming per rimuovere eventuali risorse e asset non necessari.

Indietro
HTML5
Avanti
Roku