Condividi tramite

Operazioni SMS MB

  • Articolo

In questo argomento vengono descritte le operazioni per configurare, leggere/ricevere, inviare ed eliminare messaggi usando le funzionalità di Servizio messaggi brevi (SMS) di un dispositivo MB.

Il supporto SMS è obbligatorio. I driver Miniport devono impostare i flag di funzionalità di invio e ricezione SMS appropriati supportati durante l'elaborazione di richieste di query OID_WWAN_DEVICE_CAPS nel membro WwanSmsCaps della struttura WWAN_DEVICE_CAPS . Se i driver miniport non supportano SMS, devono specificare WWAN_SMS_CAPS_NONE e restituire WWAN_STATUS_SMS_UNKNOWN_ERROR per tutti gli ID correlati a SMS.

I driver Miniport devono elaborare solo le operazioni SMS dopo OID_WWAN_READY_INFO restituisce WwanReadyStateInitialize come stato pronto per il dispositivo. I driver Miniport devono elaborare alcune operazioni SMS, ad esempio l'invio di un messaggio SMS, solo dopo la registrazione del dispositivo in una rete provider (anche se non necessariamente la registrazione del servizio dati).

Il servizio MB non distingue tra diversi archivi messaggi disponibili nel dispositivo. Pertanto, i driver miniport devono gestire tutti gli archivi messaggi e proiettare un singolo archivio messaggi virtuale accessibile tramite un indice virtuale. Ad esempio, se il dispositivo ha tre archivi messaggi, il driver miniport deve gestirli collettivamente e presentarli come un singolo archivio messaggi al servizio.

Il modello di driver MB supporta le operazioni SMS seguenti:

  • Configurazione SMS

  • Leggere SMS

  • Invia SMS

  • Eliminare SMS

È consigliabile che i driver miniport supportino la configurazione SMS, la lettura, l'invio e l'eliminazione, nonché la notifica all'utente di qualsiasi nuovo messaggio SMS ricevuto da un dispositivo.

Per altre informazioni sulle operazioni SMS, vedere OID_WWAN_SMS_CONFIGURATION, OID_WWAN_SMS_READ, OID_WWAN_SMS_SEND, OID_WWAN_SMS_DELETEeOID_WWAN_SMS_STATUS.

Servizi e driver pertinenti

SmsRouterSvc.dll - Servizio che interagisce con WwanSvc per gestire l'invio e la ricezione di immagini

MbSmsApi.dll - Implementazione dell'API SMS WinRT

UT_SmsRouter.dll : viene eseguito l'onboarding in Test di dispositivi reali

Architettura/flussi SMS

Diagramma blocchi SMS

Diagramma che mostra il flusso dell'architettura SMS.

Registrazione app SMS

Diagramma che mostra il processo di registrazione delle app SMS.

Invia SMS

Diagramma che mostra il processo di invio SMS.

Messaggio di ricezione API

Diagramma che mostra il processo di ricezione del messaggio dell'API.

Ciclo di vita dell'app

Diagramma che mostra il ciclo di vita dell'app SMS.

Ciclo di vita del servizio

Diagramma che mostra il ciclo di vita del servizio.

Test

Test SMS automatizzati

I test seguenti vengono automatizzati e inseriti nel file RI-TP. Vengono eseguiti ogni giorno e dovrebbero passare il 100%.

  • MobilebroadbandExperience\SmsApi

  • MobilebroadbandExperience\SMSCDMA

  • MobilebroadbandExperience\SMSDecodingTests

  • MobilebroadbandExperience\SMSEncodingTests

  • WWAN\SMS\Service\UnitTests

SmsApi I test hanno versioni diverse eseguite su desktop e onecoreuap. Desktop usa ancora vnelib.dll (versione C++) perché la parte CDMA di SMS non viene ancora portata in vnelibrary.dll (versione C#). Di conseguenza, sono disponibili due versioni degli elenchi di test funzionali.

Test di Hardware Lab Kit (HLK)

Questi sono tutti i test HLK attualmente disponibili correlati a MB-SMS:

Esecuzione test

Tramite netsh è possibile eseguire gli elenchi di test e i test HLK. Per altre informazioni sull'uso dello strumento netsh, vedere l'installazione di netsh mbn e netsh mbn test.

netsh mbn test feature=sms testpath="C:\data\test\bin" taefpath="C:\data\test\bin" param="AccessString=internet"

I log possono essere raccolti e decodificati usando queste istruzioni: MB Collection Log.

Messaggi speciali

Messaggi dell'operatore

Gli operatori possono effettuare il provisioning dei dispositivi per gestire messaggi specifici in precedenza. Questa funzionalità non è più disponibile, ma la funzionalità non è stata ancora rimossa. Il codice ProvisioningEngine elabora le notifiche dell'operatore. Per altre informazioni, vedere Notifiche degli operatori e eventi dell'operatore.

Messaggi di trasmissione

Per altre informazioni sugli avvisi di emergenza tramite SMS, vedere SmsBroadcastMessage e SmsBroadcastType.

Funzionalità UWP per SMS

Legacy SMS API

Esistono due API SMS legacy, sms e smsSend.

API SMS più recente

  • Messaggistica cellulare

Per altre informazioni, vedere SMS UWP.