Panoramica dei metadati del servizio

Avviso di deprecazione di MBAE

Importante

A partire da Windows 10 versione 1803, l'esperienza dell'app MBAE viene sostituita da un'app UWP mo. Per altre informazioni sulle app UWP MO, vedi App UWP per dispositivi mobili a banda larga.

È possibile creare e inviare un pacchetto di metadati del servizio per creare un'esperienza integrata in modo approfondito con Windows. Quando Windows rileva l'hardware mobile broadband corrispondente al pacchetto di metadati del servizio dell'operatore, scarica automaticamente i metadati del servizio e l'app mobile broadband specificata.

I metadati del servizio contengono le informazioni che descrivono un servizio, tra cui:

• Nome del provider di servizi

• Una o più categorie di servizi

• Informazioni specifiche della banda larga per dispositivi mobili

• App Mobile Broadband

• Profili mobile broadband

• Certificati attendibili per il provisioning di XML

• Elemento DeviceNotificationHandler

• Elemento PrivilegedApplications

Le informazioni nei metadati vengono usate per personalizzare gli aspetti del Windows 8, Windows 8.1 e Windows 10'esperienza utente e fornire l'integrazione con un'app mobile broadband, nota in precedenza come app per gli operatori mobili.

Un pacchetto di metadati del servizio è costituito da più documenti XML archiviati all'interno di un file con estensione devicemetadata-ms. Ogni documento specifica vari componenti degli attributi del servizio. Questi documenti XML forniscono a Windows Gestione connessioni personalizzazioni che appaiono all'utente, nonché informazioni sulla configurazione di rete.

Per informazioni di riferimento sui documenti XML in un pacchetto di metadati del servizio, vedere Informazioni di riferimento sullo schema del pacchetto di metadati del servizio.

Contenuto dei metadati del servizio

Il riepilogo seguente descrive alcuni dei campi più interessanti contenuti e definiti all'interno di un pacchetto di metadati del servizio:

• ID hardware
  Per una rete GSM, è possibile inviare un pacchetto di metadati che descrive gli intervalli IMSI o ICCID in base ai quali si desidera che il pacchetto di metadati del servizio corrisponda. Se si è un MVNO, è possibile specificare uno o più intervalli di ID IMSI o SIM ICC di cui è stato eseguito il lease da un MNO. Per una rete CDMA, è possibile inviare un pacchetto usando l'ID provider (SID/NID) o il nome del provider. Gli ID hardware corrispondono all'elemento HardwareID nello schema del pacchetto di metadati del servizio. Per altre informazioni su come pianificare gli intervalli HWID (Hardware Identification) per gli scenari MNO e MVNO, vedere Delivering experiences for MVNOs

• Numero di servizio
  ID univoco per il provider di servizi mobile broadband. Questo GUID viene usato anche per identificare l'operatore quando si usano i metadati di provisioning dell'account. Se si aggiorna il pacchetto di metadati del dispositivo, questo GUID deve rimanere invariato. Il numero di servizio corrisponde all'elemento ServiceNumber nello schema del pacchetto di metadati del servizio.

• Logo dell'operatore Logo personalizzato visualizzato in Windows Gestione connessioni accanto alla voce di rete. Il logo è nascosto quando l'utente si trova in una rete mobile. Il logo dell'operatore corrisponde all'elemento ServiceIconFile nello schema del pacchetto di metadati del servizio. Per altre informazioni sui requisiti del logo, vedere Requisiti dell'icona del servizio.

  Importante

  In Windows 10, versione 1709 e successive, questo campo è stato sostituito dalla personalizzazione tramite COSA. I campi in COSA per la personalizzazione sono descritti in Pianificazione dell'invio del database COSA/APN desktop. Se hai come destinazione le versioni di Windows prima di Windows 10, versione 1709, creerai comunque un pacchetto di metadati come descritto in questa sezione. Per altre informazioni su COSA, vedere Panoramica di COSA.

• App Mobile Broadband
  Un'app per dispositivi UWP scaricata e applicata automaticamente al computer. Questa app può offrire esperienze chiave come l'acquisto di piani, l'utilizzo dei dati e la guida e il supporto e può evidenziare i servizi a valore aggiunto.

• Profilo di acquisto MB
  Profilo di acquisto usato per stabilire una connettività limitata per l'acquisto di una sottoscrizione.

  Se si è un operatore GSM che dispone di un solo APN di acquisto per tutti i sottoscrittori, è possibile utilizzare i metadati del servizio per effettuare il provisioning nel computer. Se si dispone di più APN di acquisto, è consigliabile usare i metadati di provisioning dell'account per impostare l'APN di acquisto appropriato. In alternativa, non è possibile eseguire alcuna operazione e usare le voci archiviate nel database APN per fornire informazioni sulla connettività APN.

• Profilo Internet MB
  Ogni sottoscrizione mobile broadband può avere un profilo predefinito usato per connettersi all'operatore di rete home. Windows Gestione connessioni usa questo profilo per la connessione automatica alla rete.

  Se si è un operatore GSM che dispone di un solo APN Internet per tutti i sottoscrittori, è possibile utilizzare i metadati del servizio per effettuare il provisioning del computer. Se si dispone di più APN Internet, è consigliabile usare i metadati di provisioning degli account per impostare l'APN Internet appropriato. In alternativa, non è possibile eseguire alcuna operazione e usare le voci archiviate nel database APN per fornire informazioni sulla connettività APN.

• Dati del certificato
  Informazioni sul certificato usate per il provisioning. Sono inclusi il nome dell'autorità di certificazione e il nome del soggetto. Queste informazioni vengono usate per garantire che le operazioni di provisioning degli account avviate da un sito Web vengano rilasciate da un operatore attendibile.

• Nome dell'operatore personalizzato
  Il dispositivo mobile broadband fornisce in genere il nome dell'operatore, visualizzato in Windows Gestione connessioni. È possibile eseguire l'override di questo nome specificando un nome personalizzato nei metadati. Questo nome viene visualizzato solo se l'utente si trova in una rete domestica e non si trova in una rete mobile. Un nome di rete mobile visualizzato si basa sulle informazioni ricevute dal dispositivo. Corrisponde all'elemento ServiceProvider nello schema dei metadati del pacchetto del servizio.

  Importante

  In Windows 10 versione 1709 e successive questo campo è stato sostituito dalla personalizzazione tramite COSA. I campi in COSA per la personalizzazione sono descritti in Pianificazione dell'invio del database COSA/APN desktop. Se hai come destinazione le versioni di Windows prima di Windows 10, versione 1709, creerai comunque un pacchetto di metadati come descritto in questa sezione. Per altre informazioni su COSA, vedere Panoramica di COSA.

• Gestore delle notifiche del dispositivo
  In generale, un'app deve essere eseguita dall'utente almeno una volta prima di poter registrare gli elementi di lavoro con System Event Broker. Tuttavia, le app mobile broadband potrebbero dover ricevere eventi importanti prima che l'utente possa eseguire l'app. È possibile specificare l'elemento DeviceNotificationHandler nei metadati del servizio, che Windows userà per registrare alcuni eventi critici. Per altre informazioni sulle notifiche SMS, vedere Delivering experiences for MVNOs .For more information about SMS notifications, see Delivering experiences for MVNOs.

• Elenco di app con privilegi con accesso alle interfacce con restrizioni mobile broadband
  Le API e le interfacce Mobile Broadband (incluso Provisioning account e SMS) sono limitate e disponibili solo per le app mobile broadband. Un elenco di app con privilegi che hanno accesso a queste API con privilegi può essere specificato nel pacchetto di metadati del servizio nell'elemento PrivilegedApplications . Le app con privilegi possono essere di debug o di test delle app; non devono essere distribuiti tramite Microsoft Store.

Struttura del pacchetto di metadati del servizio

I componenti di un pacchetto di metadati del servizio vengono archiviati in un file CAB compresso e devono avere un'estensione di file con estensione devicemetadata-ms. I pacchetti di metadati del servizio usano questa estensione di file perché usano la stessa piattaforma sottostante dei pacchetti di metadati del dispositivo. Prima di creare il file .devicemetadata-ms , è prima necessario creare un identificatore univoco globale (GUID) per il pacchetto di metadati. È quindi necessario usare la convenzione di denominazione seguente quando si crea il file .devicemetadata-ms: <GUID.devicemetadata-ms>.

Nota Anche se l'estensione di file CAB consueta è .cab, l'estensione di file per un file del pacchetto di metadati del servizio deve essere .devicemetadata-ms. Questo è destinato a sottolineare il fatto che gli utenti finali non devono decomprimere o modificare questi pacchetti.

Esistono due tipi di pacchetti di metadati del servizio: un unico pacchetto di metadati del servizio delle impostazioni locali e un pacchetto di metadati del servizio di più impostazioni locali.

Pacchetto di metadati del servizio impostazioni locali singolo

Le risorse localizzabili nel pacchetto di metadati del servizio sono il nome dell'operatore visualizzato in Windows Gestione connessioni e l'icona del servizio visualizzata accanto. Se non è necessario localizzare il nome o modificare l'icona in base alle informazioni sulle impostazioni locali del PC, creare un unico pacchetto di metadati del servizio locale. Indipendentemente dalle impostazioni locali utilizzate dall'utente nel PC, otterrà il nome dell'operatore e l'icona del servizio definiti nel pacchetto dei metadati del servizio delle impostazioni locali singolo.

Un singolo pacchetto di metadati del servizio locale deve avere la struttura di file seguente:

Alcune considerazioni per un singolo pacchetto di metadati delle impostazioni locali:

• Il file icona può avere qualsiasi nome di file. Tuttavia, i singoli documenti XML devono essere denominati PackageInfo.xml, ServiceInfo.xml, WindowsInfo.xmle SoftwareInfo.xml.

• Il nome del file MobileBroadbandInfo.xml è definito nel ServiceInfo.xml. È consigliabile usare i nomi elencati in questo documento per tale file.

• Il file .devicemetadata-ms non può includere "{" o "}" nel nome. Il GUID per ogni nome file del pacchetto di metadati deve essere univoco. Quando si crea un pacchetto di metadati del servizio nuovo o modificato, è necessario creare un nuovo GUID, anche se le modifiche sono minori.

• Windows riconosce i pacchetti di metadati del servizio con estensione devicemetadata-ms.

Struttura del pacchetto di metadati del servizio impostazioni locali multiple

Un pacchetto di metadati del servizio supporta più file di impostazioni locali in un unico pacchetto. Se si supportano più impostazioni locali per il servizio, è possibile inserire più file delle impostazioni locali in un unico pacchetto di metadati del servizio.

È possibile usare un pacchetto di metadati del servizio locale multipli se si desidera visualizzare un nome localizzato per il servizio in Windows Gestione connessioni elenco di rete o per visualizzare un logo diverso in Windows Gestione connessioni per la rete. Windows visualizzerà il nome e il logo di rete localizzati in base alla lingua preferita del sistema, in genere configurata durante l'installazione di Windows. Anche se la lingua dell'utente corrente è diversa dalla lingua preferita dal sistema, l'icona e il nome di rete verranno sempre visualizzati nella lingua preferita dal sistema. Se il pacchetto di metadati del servizio non include impostazioni locali, viene visualizzata la descrizione indipendente dalla lingua dalla radice del pacchetto di metadati del servizio. Per la maggior parte degli utenti la lingua corrispondente alla lingua preferita dal sistema.

Un pacchetto di metadati del servizio locale multiplo deve avere la struttura di file seguente:

Alcune considerazioni per un pacchetto di metadati delle impostazioni locali multipli:

• Creare una cartella del nome delle impostazioni locali in ogni cartella e inserire il file XML o il file pertinente nella cartella dei nomi delle impostazioni locali.

• È comunque necessario avere il file XML di primo livello e i file pertinenti, ad esempio il file icona, al livello superiore di ogni cartella. Ciò fornisce un meccanismo di fallback quando le impostazioni locali non sono incluse nel pacchetto di metadati del servizio.

• Assicurarsi che tutti i file obbligatori e i campi all'interno di tali file vengano compilati completamente all'interno di ogni cartella specifica delle impostazioni locali creata. Oltre al contenuto nel livello principale di ogni cartella. Ad esempio, l'elemento ServiceNumber in ServiceInfo.xml deve essere compilato e duplicato nella cartella di primo livello e in ogni cartella specifica delle impostazioni locali creata. Se non si esegue questa operazione, si verificheranno errori.

• Il documento XML SoftwareInformation non supporta più impostazioni locali perché non è possibile specificare file di SoftwareInfo.xml diversi per impostazioni locali.

Invio e manutenzione dei metadati del servizio

Per altre informazioni su come inviare pacchetti di metadati del servizio al dashboard di Windows Dev Center - Hardware, vedere Guida per gli sviluppatori per la creazione di metadati del servizio.

È importante mantenere aggiornati i pacchetti di metadati in termini di come vengono descritti e quali valori IMSI e ICCID o CDMA Provider Name o SID corrispondono. Ciò può richiedere a MNO o MVNO di implementare un nuovo flusso di lavoro che fa parte dell'acquisizione sim o dispositivo per tenere traccia di nuovi ordini di SIM e MNO o MVNO a cui vengono forniti tali ID O IMSI.

È consigliabile evitare di apportare modifiche frequenti ai metadati del servizio riservando intervalli ICCID o IMSI (o NOME SIM/provider CDMA) per L'MNO e MVNO in anticipo, in modo che quando vengono acquistate nuove MACCHINE VIRTUALI (o dispositivi CDMA), vengono già contabilizzate nel pacchetto di metadati del servizio.

Se è necessario aggiornare gli identificatori del servizio registrati nel dashboard hardware di Windows Dev Center, vedere Aggiornamenti della proprietà dell'identificatore del servizio.

Gli aggiornamenti dei metadati vengono applicati automaticamente in base alla logica di Windows interna (in genere ogni otto giorni) quando Windows esegue una query WMIS se dispone di aggiornamenti dei metadati aggiornati.

L'app deve essere progettata per gestire una versione precedente dei metadati a cui fa riferimento, fino a quando non vengono applicati i metadati più recenti al sistema.

La progettazione dell'esperienza utente di un'app mobile broadband fornisce linee guida su come progettare l'esperienza utente per risolvere i casi di errore comuni, ad esempio quando il dispositivo è mancante o non riconosciuto.