Todos os produtos
Search
Central de documentação

SuperApp:Video

Última atualização: Jun 29, 2026

O módulo WVVideo fornece JSAPIs para gravar vídeos, selecionar vídeos do álbum do dispositivo ou salvar vídeos online no álbum local em aplicativos H5 e miniapps.

WVVideo.chooseVideo

Nota

Esta API está disponível apenas no WindVane para Android 1.0.3.4 ou superior.

Grava um vídeo com a câmera ou selecione um existente no álbum do dispositivo.

Parâmetros de entrada

  • [string] mode: Origem do vídeo. Valores válidos: 'camera' (gravar novo vídeo), 'video' (selecione do álbum) e 'both' (permitir escolha pelo usuário). Padrão: 'both'.

  • [boolean] compatible: Opcional. Defina como true se a chamada da API ocorrer após a abertura de um miniapp.

Parâmetros de callback

Em caso de sucesso, o callback recebe um objeto com os seguintes campos:

  • [string] path: Caminho do arquivo do vídeo selecionado ou gravado.

  • [string] fileSize: Tamanho do arquivo de vídeo.

  • [string] duration: Duração do vídeo.

  • [string] width: Largura do vídeo.

  • [string] height: Altura do vídeo.

Em caso de falha, o callback recebe um objeto com o seguinte campo:

  • [string] msg: Mensagem de erro que descreve o motivo da falha na operação.

Eventos

WVVideo.Event.chooseVideoSuccess

Parâmetros do evento:

  • [string] path: Caminho do arquivo do vídeo selecionado ou gravado.

  • [string] fileSize: Tamanho do arquivo de vídeo.

  • [string] duration: Duração do vídeo.

  • [string] width: Largura do vídeo.

  • [string] height: Altura do vídeo.

WVVideo.Event.chooseVideoFailed

Parâmetros do evento:

  • [string] msg: Mensagem de erro que descreve o motivo da falha na operação.

document.addEventListener('WVVideo.Event.chooseVideoSuccess', function (e) {
        alert('event chooseVideoSuccess: ' + JSON.stringify(e.param));
});
document.addEventListener('WVVideo.Event.chooseVideoFailed', function (e) {
        alert('event chooseVideoFailed: ' + JSON.stringify(e.param));
});

var params = {
  mode: 'both'
};
window.WindVane.call('WVVideo', 'chooseVideo', params, function(e) {
        alert('success: ' + JSON.stringify(e));
}, function(e) {
        alert('failure: ' + JSON.stringify(e));
});

WVVideo.saveVideoToPhotosAlbum

Nota

Esta API está disponível apenas no WindVane para Android 1.0.3.4 ou superior.

Salva um vídeo online no álbum local.

Parâmetros de entrada

  • [string] url: URL de baixe do vídeo online. Deve ser uma URL HTTP ou HTTPS diretamente acessível para baixe.

Parâmetros de callback

Em caso de sucesso, o callback não recebe parâmetros.

  • Nenhum.

Em caso de falha, o callback recebe um objeto com o seguinte campo:

  • [string] msg: Mensagem de erro que descreve o motivo da falha na operação.

Eventos

WVVideo.Event.saveVideoSuccess

Parâmetros do evento:

  • Nenhum.

WVVideo.Event.saveVideoFailed

Parâmetros do evento:

  • [string] msg: Mensagem de erro que descreve o motivo da falha na operação.

document.addEventListener('WVVideo.Event.saveVideoSuccess', function (e) {
        alert('event saveVideoSuccess: ' + JSON.stringify(e.param));
});
document.addEventListener('WVVideo.Event.saveVideoFailed', function (e) {
        alert('event saveVideoFailed: ' + JSON.stringify(e.param));
});

var params = {
  url: 'http://xxxx'
};
window.WindVane.call('WVVideo', 'saveVideoToPhotosAlbum', params, function(e) {
        alert('success: ' + JSON.stringify(e));
}, function(e) {
        alert('failure: ' + JSON.stringify(e));
});