Considerazioni e best practice

Per utilizzare TVSDK nel modo più efficace, è necessario considerare alcuni dettagli del suo funzionamento e seguire alcune best practice.

Considerazioni

Quando si utilizza TVSDK, tenere presenti le seguenti informazioni:

L’API TVSDK è implementata in Java.
Adobe Primetime al momento non funziona sugli emulatori Android.

Per il test è necessario utilizzare dispositivi reali.
La riproduzione è supportata solo per contenuti HTTP Live Streaming (HLS).
Il contenuto video principale può essere multiplexato (flussi video e audio nella stessa rappresentazione) o non multiplexato (flussi video e audio in rappresentazioni separate).
Attualmente, devi eseguire la maggior parte delle operazioni API TVSDK sul thread dell’interfaccia utente, che è il thread Android principale.

Le operazioni eseguite correttamente sul thread principale possono generare un errore e uscire quando vengono eseguite su un thread in background.
La riproduzione video richiede l'Adobe del motore video (AVE). Questo influisce su come e quando è possibile accedere alle risorse multimediali:
- I sottotitoli codificati sono supportati nella misura fornita da AVE.
- A seconda della precisione del codificatore, la durata effettiva dei file multimediali codificati potrebbe essere diversa dalle durate registrate nel manifesto della risorsa del flusso.
  
  Non esiste un modo affidabile per risincronizzare tra la timeline virtuale ideale e la timeline effettiva del playout. Il tracciamento dell’avanzamento della riproduzione del flusso per la gestione degli annunci e Video Analytics deve utilizzare il tempo di riproduzione effettivo, pertanto la generazione di rapporti e il comportamento dell’interfaccia utente potrebbero non tenere traccia con precisione del contenuto multimediale e pubblicitario.
- Al nome dell’agente utente in ingresso per tutte le richieste multimediali provenienti da TVSDK su questa piattaforma viene assegnato il seguente pattern di stringa:
```
"Adobe Primetime/" + originalUserAgent
```
  Tutte le chiamate relative agli annunci utilizzano l’agente utente predefinito Android o l’agente utente personalizzato, se impostato durante la configurazione dei metadati di inserimento di annunci.

Best practice

Di seguito sono riportate le procedure consigliate per TVSDK:

Utilizza la versione 3.0 o successiva di HLS per i contenuti del programma.
Esegui la maggior parte delle operazioni TVSDK sul thread principale (UI), non sui thread in background.
Per TVSDK 3.0 per Android, la risoluzione degli annunci lenti è attivata per impostazione predefinita.

Per i contenuti senza pre-roll o mid-roll, puoi utilizzare AdvertisingMetadata.setPreroll(false) per accelerare il caricamento dei contenuti.