Início automático com a Reprodução Automática (HTML)

[ Este artigo destina-se aos desenvolvedores do Windows 8.x e do Windows Phone 8.x que escrevem aplicativos do Windows Runtime. Se você estiver desenvolvendo para o Windows 10, consulte documentação mais recente]

Finalidade

Você pode usar a Reprodução Automática para fornecer seu aplicativo como uma opção quando o usuário conectar um dispositivo ao computador. Isso inclui dispositivos sem volume, como uma câmera ou um player de mídia, ou dispositivos com volume, como pen drives, cartões de memória ou DVDs. Você também pode usar a Reprodução Automática para oferecer seu aplicativo como uma opção quando os usuários compartilharem arquivos entre dois computadores usando a proximidade (toque).

Nesta seção

Tópico	Descrição
Início rápido: registrar um aplicativo para conteúdo de Reprodução Automática	Você pode registrar aplicativos como opções de eventos de conteúdo de Reprodução Automática. Os eventos de conteúdo de Reprodução Automática ocorrem quando um dispositivo de volume, como um cartão de memória de câmera, um pen drive ou DVD, é inserido no computador.
Início rápido: registrar um aplicativo para um dispositivo de Reprodução Automática	Você pode registrar aplicativos como opções de eventos de dispositivo de Reprodução Automática. Os eventos de dispositivo de Reprodução Automática são gerados quando um dispositivo é conectado a um computador.
Início rápido: configurar armazenamento removível como dispositivo de Reprodução Automática	Você pode identificar um dispositivo de volume, como um cartão de memória ou pen drive, como um dispositivo de Reprodução Automática quando o dispositivo de volume é conectado a um computador. Isso é especialmente útil quando você quer associar um aplicativo específico para Reprodução Automática para apresentar ao usuário do seu dispositivo de volume.

 

Audiência de desenvolvedores

Os desenvolvedores usam a Reprodução Automática quando criam aplicativos que respondem a uma conexão de dispositivo iniciada pelo usuário. Você pode usar a Reprodução Automática para executar uma ação em nome do usuário, oferecendo um manipulador para um dispositivo específico. Quando um usuário conecta um dispositivo, a Reprodução Automática determina o tipo de dispositivo e gera ou um evento de dispositivo para dispositivos de não volume, ou um evento de conteúdo para dispositivos de volume. Você pode se registrar para o evento correspondente ao seu aplicativo adicionando uma Declaração no manifesto do aplicativo para o tipo específico de evento. Depois que o aplicativo é criado e implantado, a Reprodução Automática reconhece a respectiva declaração. Em seguida, a Reprodução Automática a inclui na lista de possíveis ações que o usuário pode executar para responder a esse evento. Um exemplo é fornecido em Guia de início rápido: registrar um aplicativo para conteúdo de Reprodução Automática.

Também é possível executar uma ação quando o usuário tiver recebido arquivos compartilhados usando proximidade (toque). Nesse caso, os arquivos são colocados em uma pasta temporária no computador de destino e a Reprodução Automática gera um evento de conteúdo com base no tipo dos arquivos compartilhados.

Observação  Se você é um fabricante de dispositivo e deseja associar um aplicativo de dispositivo da Windows Store como um manipulador de Reprodução Automática para seu dispositivo, é possível identificar o aplicativo nos metadados do dispositivo. Para saber mais, veja Reprodução Automática para aplicativos de dispositivo da Windows Store.

 

Eventos de Reprodução Automática

O sistema de Reprodução Automática permite que os aplicativos se registrem para uma ampla variedade de eventos de chegada de dispositivo e volume (disco). Para registrar eventos de conteúdo da Reprodução Automática, é necessário habilitar o recurso Armazenamento removível no manifesto do seu pacote. Essa tabela mostra os eventos para os quais você pode se registrar e quando eles são gerado.

Cenário	Evento	Descrição
Usando fotos em uma câmera	WPD\ImageSource	Acionado para câmeras identificadas como Dispositivos Portáteis do Windows que oferecem o recurso ImageSource.
Usar música em um reprodutor de áudio	WPD\AudioSource	Acionado para controladores de mídia identificados como Dispositivos Portáteis do Windows que oferecem o recurso ImageSource.
Usar vídeos em uma câmera de vídeo	WPD\VideoSource	Acionado para câmeras de vídeo identificadas como Dispositivos Portáteis do Windows que oferecem o recurso VideoSource.
Acessar uma unidade flash conectada ou um disco rígido externo	StorageOnArrival	Gerado quando uma unidade de disco ou volume é conectada ao computador.   Caso a unidade de disco ou volume contenha uma pasta DCIM, AVCHD ou PRIVATE\ACHD na raiz do disco, o evento ShowPicturesOnArrival é gerado.
Usar fotos de armazenamento de massa (herdado)	ShowPicturesOnArrival	Gerado quando a unidade de disco ou volume contém uma pasta DCIM, AVCHD ou PRIVATE\ACHD na raiz do disco. Se o usuário tiver habilitado a opção Escolher o que fazer com cada tipo de mídia no Painel de Controle de Reprodução Automática, a Reprodução Automática examinará o volume conectado ao computador para determinar o tipo de conteúdo no disco. Se forem encontradas imagens, ShowPicturesOnArrival será gerado.
Receber fotos com compartilhamento de proximidade (tocar e enviar)	ShowPicturesOnArrival	Quando os usuários enviam conteúdo usando proximidade (tocar e enviar), a Reprodução Automática examina os arquivos compartilhados para determinar o tipo de conteúdo. Se são encontradas imagens, ShowPicturesOnArrival é acionado.
Usar música de armazenamento de massa (herdado)	PlayMusicFilesOnArrival	Se o usuário tiver habilitado a opção Escolher o que fazer com cada tipo de mídia no Painel de Controle de Reprodução Automática, a Reprodução Automática examinará o volume conectado ao computador para determinar o tipo de conteúdo no disco.  Quando são encontrados arquivos de música, PlayMusicFilesOnArrival é gerado.
Receber música com compartilhamento de proximidade (tocar e enviar)	PlayMusicFilesOnArrival	Quando os usuários enviam conteúdo usando proximidade (tocar e enviar), a Reprodução Automática examina os arquivos compartilhados para determinar o tipo de conteúdo. Se são encontrados arquivos de música, PlayMusicFilesOnArrival é acionado.
Usando vídeos de armazenamento em massa (legado)	PlayVideoFilesOnArrival	Se o usuário tiver habilitado a opção Escolher o que fazer com cada tipo de mídia no Painel de Controle de Reprodução Automática, a Reprodução Automática examinará o volume conectado ao computador para determinar o tipo de conteúdo no disco. Quando são encontrados arquivos de vídeo, PlayVideoFilesOnArrival é gerado.
Receber vídeos com compartilhamento de proximidade (tocar e enviar)	PlayVideoFilesOnArrival	Quando os usuários enviam conteúdo usando proximidade (tocar e enviar), a Reprodução Automática examina os arquivos compartilhados para determinar o tipo de conteúdo. Se são encontrados arquivos de vídeo, PlayVideoFilesOnArrival é acionado.
Manipular conjuntos de arquivos mistos em um dispositivo conectado	MixedContentOnArrival	Se o usuário tiver habilitado a opção Escolher o que fazer com cada tipo de mídia no Painel de Controle de Reprodução Automática, a Reprodução Automática examinará o volume conectado ao computador para determinar o tipo de conteúdo no disco. Caso nenhum tipo de conteúdo específico seja encontrado (por exemplo, imagens), MixedContentOnArrival é gerado.
Manipular conjuntos de arquivos mistos com compartilhamento de proximidade (tocar e enviar)	MixedContentOnArrival	Quando os usuários enviam conteúdo usando proximidade (tocar e enviar), a Reprodução Automática examina os arquivos compartilhados para determinar o tipo de conteúdo. Se nenhum tipo específico de conteúdo (por exemplo, imagens) é encontrado, MixedContentOnArrival é acionado.
Manipule vídeo de mídia óptica	PlayDVDMovieOnArrival PlayBluRayOnArrival PlayVideoCDMovieOnArrival PlaySuperVideoCDMovieOnArrival
Manipule música de mídia óptica	PlayCDAudioOnArrival PlayDVDAudioOnArrival
Reproduza discos aprimorados	PlayEnhancedCDOnArrival PlayEnhancedDVDOnArrival
Manipule discos ópticos graváveis	HandleCDBurningOnArrival HandleDVDBurningOnArrival HandleBDBurningOnArrival
Manipule a conexão de qualquer outro dispositivo ou volume	UnknownContentOnArrival	Erguido para todos eventos caso o conteúdo encontrado não corresponda a qualquer evento de conteúdo da Reprodução Automática. O uso desse evento não é recomendado. Você só deve registrar o seu aplicativo para os eventos de Reprodução Automática específicos que ele possa manipular.

 

Você pode especificar que a Reprodução Automática deve gerar um evento de Reprodução Automática personalizado usando a entrada CustomEvent no arquivo autorun.inf para um volume. Para saber mais, veja Entradas de Autorun.inf.

Você pode registrar seu aplicativo como um manipulador de eventos de Conteúdo de Reprodução Automática ou de Dispositivo de Reprodução Automática adicionando uma extensão ao arquivo package.appxmanifest de seu aplicativo. Se você utiliza o Microsoft Visual Studio, pode adicionar uma declaração de Conteúdo de Reprodução Automática ou Dispositivo de Reprodução Automática à guia Declarações. Um exemplo é fornecido em Guia de início rápido: registrar um aplicativo para conteúdo de Reprodução Automática. Se estiver editando o arquivo package.appxmanifest diretamente em seu aplicativo, adicione um elemento Extension ao seu manifesto do pacote que especifique windows.autoPlayContent ou windows.autoPlayDevice como a Category. Por exemplo, a entrada a seguir no manifesto do pacote adiciona uma extensão de Conteúdo de Reprodução Automática para registrar o aplicativo como um manipulador do evento ShowPicturesOnArrival.

  <Applications>
    <Application Id="AutoPlayHandlerSample.App">
      <Extensions>
        <Extension Category="windows.autoPlayContent">
          <AutoPlayContent>
            <LaunchAction Verb="show" ActionDisplayName="Show Pictures" 
                          ContentEvent="ShowPicturesOnArrival" />
          </AutoPlayContent>
        </Extension>
      </Extensions>
    </Application>
  </Applications>