Acquisto di contenuti multimediali

[La funzionalità associata a questa pagina, Lettore multimediale Windows SDK, è una funzionalità legacy. È stato sostituito da MediaPlayer. MediaPlayer è stato ottimizzato per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer invece di Lettore multimediale Windows SDK, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

Quando Lettore multimediale Windows visualizza contenuto musicale nella visualizzazione albero della libreria, l'interfaccia utente include elementi che l'utente può fare clic per acquistare il contenuto. Ad esempio, l'utente potrebbe fare clic su un pulsante per acquistare una singola canzone o per acquistare un intero album.

Se il negozio online attivo è un negozio di tipo 1, Lettore multimediale Windows ha accesso a tracce, album e prezzi di listino nel catalogo del negozio online. Tali prezzi nel catalogo sono stringhe che hanno un formato compreso solo dal negozio online. Lettore multimediale Windows non interpreta le stringhe di prezzo, ma le visualizza semplicemente in elementi dell'interfaccia utente come i pulsanti Acquista.

Quando Lettore multimediale Windows configura un acquisto per un set di elementi multimediali, passa gli ID e i prezzi degli elementi multimediali al plug-in del partner contenuto chiamando IWMPContentPartner::CanBuySilent. A questo punto, il plug-in può controllare i prezzi forniti dal lettore. Questi sono i prezzi che l'utente prevede di pagare; ovvero i prezzi visualizzati dall'utente dal lettore. In base agli ID multimediali e ai prezzi forniti dal lettore, il plug-in calcola un prezzo totale, che restituisce al lettore nel parametro bstrTotalPrice . I prezzi che il giocatore passa a CanBuySilent forniscono il plug-in con informazioni, ma non obbligano il plug-in a restituire un determinato prezzo totale. Il plug-in può calcolare il prezzo totale come si vede adatta.

Oltre a calcolare il prezzo totale di un acquisto, CanBuySilent determina se la borsa può procedere in silenzio; ovvero, senza visualizzare una finestra di dialogo. Se CanBuySilent restituisce True, Lettore multimediale Windows semplicemente modifica il testo sul pulsante Acquista per richiedere all'utente di confermare l'acquisto. Se CanBuySilent restituisce False, Lettore multimediale Windows visualizza una finestra di dialogo che richiede all'utente di confermare l'acquisto. La finestra di dialogo fornisce all'utente informazioni che riepiloga l'acquisto come il numero di album, il numero di tracce singole e il prezzo totale (come restituito dal plug-in).

Dopo che l'utente conferma l'acquisto, il giocatore chiama IWMPContentPartner::Buy. Questa chiamata al metodo fornisce il plug-in con lo stesso elenco di contenitori di contenuto di CanBuySilent. Quando si chiama Buy, Lettore multimediale Windows fornisce anche un cookie (semplicemente un valore DWORD, univoco per la sessione) che il plug-in può usare per identificare la transazione. Al termine della transazione, il plug-in deve chiamare IWMPContentPartnerCallback::BuyComplete, passando il valore del cookie originale per il parametro dwBuyCookie , per notificare al Lettore che la transazione è stata completata.

Argomenti correlati

Guida alla programmazione per gli archivi online di tipo 1