Método External.changeViewOnlineList

[La característica asociada a esta página, Reproductor multimedia de Windows SDK, es una característica heredada. Se ha reemplazado por MediaPlayer. MediaPlayer se ha optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer en lugar de Reproductor multimedia de Windows SDK, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.

Nota:

En este tema se describe la funcionalidad diseñada para su uso por las tiendas en línea. No se admite el uso de esta funcionalidad fuera del contexto de una tienda en línea.

El método changeViewOnlineList cambia la vista en Reproductor multimedia de Windows para mostrar una lista generada dinámicamente por la tienda en línea.

Sintaxis

External.changeViewOnlineList(
  LibraryLocationType,
  LibraryLocationID,
  Params,
  FriendlyName,
  ListType,
  ViewMode
)

Parámetros

LibraryLocationType [in]

Constante de ubicación de biblioteca que especifica el tipo de la nueva vista. Por ejemplo, la constante CPGenreID especifica que la nueva vista mostrará un género determinado.

LibraryLocationID [in]

Cadena que contiene el identificador del elemento específico que se va a mostrar en la nueva vista. Por ejemplo, si LibraryLocationType es CPGenreID, este parámetro especifica el identificador del género que se va a mostrar en la nueva vista. Esta cadena puede estar vacía.

Parámetros [in]

Cadena que contiene parámetros que Reproductor multimedia de Windows pasa al complemento de la tienda en línea llamando a IWMPContentPartner::GetTemplate. Estos parámetros no se interpretan mediante Reproductor multimedia de Windows. Son creados por la tienda en línea y tienen significado solo para la tienda en línea. Esta cadena puede estar vacía.

FriendlyName [in]

Cadena que contiene un nombre descriptivo, que se va a mostrar mediante Reproductor multimedia de Windows, para la lista dinámica.

ListType [in]

Constante de ubicación de biblioteca que especifica el tipo de los elementos de la lista generada dinámicamente. Por ejemplo, si el valor de este parámetro es CPTrackID, la lista dinámica contendrá pistas.

ViewMode [in]

Cadena que especifica el modo que Reproductor multimedia de Windows usará para mostrar la lista dinámica. El autor de la llamada debe establecer este parámetro en uno de los siguientes valores, que se definen en contentpartner.h:

ViewModeReport

ViewModeDetails

ViewModeIcon

ViewModeTile

ViewModeOrderedList

Valor devuelto

Este método no devuelve ningún valor.

Observaciones

Cuando el script en una página de detección llama a changeViewOnlineList, Reproductor multimedia de Windows pasa algunos de los parámetros a lo largo de los métodos IWMPContentPartner::GetListContents e IWMPContentPartner::GetTemplate, que implementa el complemento de la tienda en línea. En la tabla siguiente se muestra la correspondencia entre los parámetros de los tres métodos.

parámetro changeViewOnlineList	Parámetro GetListContents	Parámetro GetTemplate
LocationType	ubicación	ubicación
LocationID	pContext	pContext
Params	bstrParams	bstrViewParams
ListType	bstrListType	no aplicable

Dado que la tienda en línea implementa los tres métodos que se muestran en la tabla anterior, tiene cierta flexibilidad en el uso de los parámetros. La idea es que proporcione información suficiente para GetListContents para determinar qué lista debe recuperar y para que GetTemplate determine qué página de detección debe mostrarse a continuación. En los ejemplos siguientes se muestran dos posibilidades.

Ejemplo 1: Una lista dinámica que se encuentra en el catálogo de la tienda en línea

Supongamos que quiere que el complemento obtenga el contenido de la lista dinámica que tiene un identificador de 6 en el catálogo de la tienda en línea. Supongamos que la lista 6 es una lista de pistas. Puede proporcionar el complemento con suficiente información realizando la siguiente llamada.

external.changeViewOnlineList(
   "CPListID", 6, "", 
   "Songs for Today", "CPTrackID", "ViewModeDetails");

Tenga en cuenta que el parámetro Params está vacío; el complemento tiene suficiente información en los demás parámetros.

Ejemplo 2: Una lista dinámica que no está en el catálogo de la tienda en línea

Supongamos que desea que el complemento obtenga el contenido de una lista dinámica que no está en el catálogo de la tienda en línea. Quizás haya decidido tener una lista dinámica que incluya canciones seleccionada por un artista en particular. Supongamos que el artista tiene un identificador de 2 en el catálogo de la tienda en línea. Puede realizar la siguiente llamada.

external.changeViewOnlineList(
   "CPArtistID", 2, "songs picked by Sally", 
   "Sally Picks", "CPTrackID", "ViewModeDetails");

Tenga en cuenta que los parámetros LocationType y LocationID no especifican la lista. En su lugar, el parámetro Params especifica la lista. Los parámetros LocationType y LocationID se pasan a IWMPContentPartner::GetListContents, pero en este caso , GetListContents pueden omitirlos. Los parámetros LocationType y LocationID también se pasan a IWMPContentPartner::GetTemplate, que pueden usarlos para determinar qué página de detección debe mostrarse con la lista dinámica.

Requisitos

Requisito	Value
Versión	Reproductor de Windows Media 11
Archivo DLL	Wmp.dll

Consulte también

Objeto externo para tiendas en línea de tipo 1

IWMPContentPartner::GetListContents

IWMPContentPartnerCallback::AddListContents

IWMPContentPartner::GetTemplate

Ubicación y elemento seleccionado