Acesso à biblioteca

[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.]

As propriedades e os métodos do modelo de objeto Reprodutor Multimídia do Windows que acessam a biblioteca exigem acesso somente leitura ou leitura/gravação ao banco de dados. A biblioteca contém informações que alguns usuários desejam manter privadas e que devem ser acessadas ou alteradas apenas com seu consentimento.

Para Reprodutor Multimídia do Windows Série 9 ou posterior, você pode determinar programaticamente o nível de acesso. Para determinar o nível atual de acesso concedido ao seu código, recupere as Configurações. propriedade mediaAccessRights . Essa propriedade retorna "none", "read" ou "full" (leitura/gravação). Para solicitar direitos de acesso específicos, chame as Configurações. método requestMediaAccessRights , passando um parâmetro que especifica o nível que você está solicitando. O método exibe uma mensagem para o usuário explicando o nível de acesso solicitado e retorna um valor booliano que indica se o acesso foi concedido.

Determinados direitos de acesso são concedidos automaticamente, dependendo de onde seu código está sendo executado em relação ao computador do usuário.

  • Se sua página da Web ou programa estiver localizado no computador do usuário, os direitos de acesso completo serão concedidos por padrão.

  • As páginas da Web têm acesso de leitura ao Player. currentMedia, Player. currentPlaylist e Mídia. sourceURL quando a página da Web está localizada em uma zona de segurança de Explorer da Internet que é igual ou menos restrita do que a zona de segurança do item de mídia ou playlist.

    Variando do menos restrito ao mais restrito, as zonas de segurança são a zona Confiável (incluindo o computador local do usuário), a zona de intranet local , a zona da Internet e a zona Restrita .

    Por exemplo, uma página da Web na zona da intranet local tem direitos de acesso total ao Player. currentMedia quando o item de mídia correspondente está na intranet local ou na Internet, mas os direitos de acesso devem ser solicitados para itens de mídia localizados no computador local de um usuário ou em um site na zona Confiável .

Você deve testar seu aplicativo baseado na Web ou no Windows em todas as zonas de segurança que ele pode encontrar. O aplicativo deve ser projetado para lidar com a negação de uma solicitação de acesso corretamente.

Reprodutor Multimídia do Windows versões do modelo de objeto anteriores à série Reprodutor Multimídia do Windows 9 não incluem mediaAccessRights ou requestMediaAccessRights. Essas versões anteriores do Reprodutor Multimídia do Windows permitem que o usuário defina níveis de acesso usando a caixa de diálogo Opções.

Objeto Settings

Trabalhando com a biblioteca