Método External.changeView

[O recurso associado a esta página, Reprodutor Multimídia do Windows SDK, é um recurso herdado. Foi substituído pelo MediaPlayer. O MediaPlayer foi otimizado para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use o MediaPlayer em vez de Reprodutor Multimídia do Windows SDK, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]

Observação

Este tópico descreve a funcionalidade projetada para uso por lojas online. Não há suporte para o uso dessa funcionalidade fora do contexto de um repositório online.

O método changeView altera a exibição em Reprodutor Multimídia do Windows.

Sintaxe

External.changeView(
  LibraryLocationType,
  LibraryLocationID,
  Filter,
  ViewParams
)

Parâmetros

LibraryLocationType [in]

Uma constante de local de biblioteca que especifica o tipo da nova exibição. Por exemplo, a constante CPGenreID especifica que o novo modo de exibição mostrará um gênero específico.

LibraryLocationID [in]

Cadeia de caracteres que contém a ID do item específico a ser mostrado no novo modo de exibição. Por exemplo, se LibraryLocationType for CPGenreID, esse parâmetro especificará a ID do gênero a ser mostrada no novo modo de exibição. Essa cadeia de caracteres pode estar vazia. Consulte Observações.

Filtrar [in]

Cadeia de caracteres que contém o filtro para o novo modo de exibição. O modo de exibição será filtrado como se o usuário tivesse inserido esse texto no controle de roda de palavras do jogador. Essa cadeia de caracteres pode estar vazia.

ViewParams [in]

Cadeia de caracteres que contém parâmetros que Reprodutor Multimídia do Windows disponibiliza para a nova página de descoberta exibida com o novo modo de exibição. Esses parâmetros não são interpretados por Reprodutor Multimídia do Windows. Eles são criados pela loja online e têm significado apenas para a loja online.

Retornar valor

Esse método não retorna um valor.

Comentários

Em alguns casos, faz sentido definir o parâmetro LibraryLocationID como a cadeia de caracteres vazia. Por exemplo, se você definir o parâmetro LibraryLocationType como AllCPAlbumIDs, o novo modo de exibição representará todos os álbuns. Nenhum álbum individual será o foco da nova exibição, portanto, não é necessário fornecer uma ID de álbum no parâmetro LibraryLocationID .

O parâmetro ViewParams fornece uma maneira de uma página de descoberta se comunicar com outra página de descoberta. Quando o script em uma página de descoberta chama changeView, Reprodutor Multimídia do Windows ajusta sua interface do usuário. Esse ajuste faz com que o Player chame o método IWMPContentPartner::GetTemplate do plug-in para obter a URL de uma nova página de descoberta. A cadeia de caracteres que a página de descoberta original passa no parâmetro ViewParams não é passada para GetTemplate. No entanto, a nova página de descoberta pode recuperar a cadeia de caracteres ViewParams chamando External.viewParameters.

Requisitos

Requisito	Valor
Versão	Reprodutor Multimídia do Windows 11.
DLL	Wmp.dll

Confira também

Objeto externo para repositórios online tipo 1

External.changeViewOnlineList

External.libraryLocationID

External.libraryLocationType

External.viewParameters