Introduzione
Questa documentazione offre una panoramica delle chiamate API JavaScript disponibili per recuperare dati specifici
memorizzati sul dispositivo QL Player.
Illustriamo e commentiamo le varie chiamate di funzione del player gestite dalla Player JavaScript API.
1. Il codice sorgente:
<html> <head> <script> // Get Feeds from SDK setTimeout(function(){ var feeds = window.parent.PlayerSDK.getXMLFeeds(); var result = ''; for (var i = 0; feeds && i < feeds.length; i++) { result += feeds[i].Name + ';'; } document.getElementById('feeds').innerHTML = '<h1>List of feeds</h1><p>' + result + '</p>'; }, 1000); // Get Feeds and Display Feed Details setTimeout(function(){ var feeds = window.parent.PlayerSDK.getXMLFeeds(); var firstFeed = feeds && feeds.length > 0 ? feeds[0] : {}; var result = ''; for (var i = 0; firstFeed && firstFeed.Rows && i < firstFeed.Rows.length; i++) { for (var key in firstFeed.Rows[i]) { result += '<p>' + firstFeed.Rows[i][key] + '</p>'; } } document.getElementById('feeds-details').innerHTML = '<h1>First feed details</h1><p>' + result + '</p>'; }, 1000); // Get Tags from SDK setTimeout(function(){ var tags = window.parent.PlayerSDK.getTagsPlayer(); var result = ''; for (var i = 0; tags && i < tags.length; i++) { result += tags[i].Name + ';'; } document.getElementById('tags').innerHTML = '<h1>List of tags</h1><p>' + result + '</p>'; }, 1000); // Get Player Data from SDK setTimeout(function(){ var playerData = window.parent.PlayerSDK.getPlayerData(); var result = ''; for (var key in playerData) { result += key + ': ' + playerData[key] + '; '; } document.getElementById('player-properties').innerHTML = '<h1>List of Player properties</h1><p>' + result + '</p>'; }, 1000); // Get Player Variables from SDK setTimeout(function(){ var variables = window.parent.PlayerSDK.getPlayerVariables(); var result = ''; for (var i = 0; variables && i < variables.length; i++) { result += variables[i].Index + ": " + variables[i].Key + ": " + variables[i].Value + '; '; } document.getElementById('player-variables').innerHTML = '<h1>List of Player Variables</h1><p>' + result + '</p>'; }, 1000); </script> </head> <body> <div id='player-properties'></div> <div id='tags'></div> <div id='player-variables'></div> <div id='feeds'></div> <div id='feeds-details'></div> </body> </html> 2. Funzioni per recuperare i feed:
2.1 getXMLFeeds():
Descrizione: recupera l'elenco dei feed memorizzati in locale.
Restituisce: un array di oggetti feed, ognuno con il nome (Name) del feed.
Esempio d'uso:
var feeds = window.parent.PlayerSDK.getXMLFeeds(); 2.2 Mostrare i nomi dei feed:
Descrizione: mostra i nomi di tutti i feed recuperati dai dati memorizzati.
Esempio d'uso:
var result = ''; for (var i = 0; feeds && i < feeds.length; i++) { result += feeds[i].Name + ';'; } document.getElementById('feeds').innerHTML = '<h1>List of feeds</h1><p>' + result + '</p>'; 2.3 Recuperare i dettagli di un feed:
Descrizione: recupera e mostra i dettagli del primo feed recuperato dai dati memorizzati.
Esempio d'uso:
var result = ''; for (var i = 0; firstFeed && firstFeed.Rows && i < firstFeed.Rows.length; i++) { for(var key in firstFeed.Rows[i]){ result += '<p>' + firstFeed.Rows[i][key] + '</p>'; } } document.getElementById('feeds-details').innerHTML = '<h1>First feed details</h1><p>' + result + '</p>';\ 3. Funzioni per recuperare i tag:
3.1 getTagsPlayer():
Descrizione: recupera l'elenco dei tag assegnati al dispositivo player.
Restituisce: un array di oggetti tag, ognuno con il nome (Name) del tag.
Esempio d'uso:
var tags = window.parent.PlayerSDK.getTagsPlayer(); 3.2 Mostrare i nomi dei tag:
Descrizione: mostra i nomi di tutti i tag recuperati dai dati memorizzati.
Esempio d'uso:
var result = ''; for (var i = 0; tags && i < tags.length; i++) { result += tags[i].Name + ';'; } document.getElementById('tags').innerHTML = '<h1>List of tags</h1><p>' + result + '</p>'; 4. Funzioni per recuperare le proprietà del player:
4.1 getPlayerData():
Descrizione: recupera tutte le informazioni sul dispositivo player, tra cui:
serialNumber, version, mediaPlayerSerial, architecture, deviceName, firmwareVersion, model, osVersion, processor,
macAddress, ip, resolution { width: SystemUtils.getScreenWidth(), height: SystemUtils.getScreenHeight() }, address,
city, company, country, groupName, mobile, name, state, telephone, timeZone, zip.
Restituisce: un oggetto playerData con le proprietà del player.
Esempio d'uso:
var playerData = window.parent.PlayerSDK.getPlayerData(); 4.2 Mostrare le proprietà del player:
Descrizione: mostra nomi e valori di tutte le proprietà del player recuperate dalla SDK.
Esempio d'uso:
var result = ''; for (var key in playerData) { result += key + ': ' + playerData[key] + '; '; } document.getElementById('player-properties').innerHTML = '<h1>List of Player properties</h1><p>' + result + '</p>'; 5.1 getPlayerVariables():
Descrizione: recupera l'elenco delle variabili assegnate al dispositivo player.
Restituisce: un array di oggetti variabile, ognuno con:
- Index (numero)
- Key (stringa)
- Value (stringa)
Esempio d'uso:
var variables = window.parent.PlayerSDK.getPlayerVariables(); 5.2 Mostrare le coppie chiave/valore delle variabili del player:
Descrizione: mostra l'elenco delle variabili definite per il player.
Esempio d'uso:
var result = ''; for (var i = 0; variables && i < variables.length; i++) { result += variables[i].Index + ': ' + variables[i].Key + ': ' + variables[i].Value + '; '; } document.getElementById('player-variables').innerHTML = '<h1>List of Player Variables</h1><p>' + result + '</p>'; 6. Esempio di file HTML ZIP da caricare direttamente nel CMS
È disponibile un file HTML ZIP completo, pronto da caricare nel CMS. Questo file HTML mostra tutte le informazioni descritte sopra in modo chiaro e strutturato. È ideale per il debug o per i test.
Link per il download: Panoramica della Player SDK – pronta per il caricamento nel CMS
Fonte: articolo originale Navori (EN), aggiornato il 18/12/2025. Traduzione ENYCS.