すべてのプロダクト
Search
ドキュメントセンター

SuperApp:ビデオ

最終更新日:Apr 21, 2026

本ドキュメントでは、H5 アプリおよびミニアプリを開発するための WVVideo モジュールの JSAPI について説明します。これらの JSAPI を使用すると、アルバムからのビデオ選択、カメラでのビデオ録画、オンラインビデオのローカルアルバムへの保存が可能になります。

WVVideo.chooseVideo

説明

この API は、WindVane for Android 1.0.3.4 以降でのみ利用可能です。

ビデオを録画するか、デバイスのアルバムからビデオを選択します。

入力パラメーター

  • [string] mode: ビデオのソース。 新しいビデオを録画する場合は 'camera'、アルバムから選択する場合は 'video'、ユーザーが決定する場合は 'both' に設定します。 デフォルト値: 'both'

  • [boolean] compatible: (オプション) ミニアプリが表示された後に API が呼び出される場合は、このパラメーターを true に設定します。

コールバックパラメーター

成功コールバック関数は、次のパラメーターを含むオブジェクトを受け取ります:

  • [string] path: ビデオのファイルパス。

  • [string] fileSize: ビデオのファイルサイズ。

  • [string] duration: ビデオの再生時間。

  • [string] width: ビデオの幅。

  • [string] height: ビデオの高さ。

失敗コールバック関数は、次のパラメーターを含むオブジェクトを受け取ります:

  • [string] msg: エラーメッセージ。

イベント

WVVideo.Event.chooseVideoSuccess

イベントパラメーター:

  • [string] path: ビデオのファイルパス。

  • [string] fileSize: ビデオのファイルサイズ。

  • [string] duration: ビデオの再生時間。

  • [string] width: ビデオの幅。

  • [string] height: ビデオの高さ。

WVVideo.Event.chooseVideoFailed

イベントパラメーター:

  • [string] msg: エラーメッセージ。

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

説明

この API は、WindVane for Android 1.0.3.4 以降でのみ利用可能です。

オンラインビデオをローカルアルバムに保存します。

入力パラメーター

  • [string] url: オンラインビデオのダウンロード URL。 注意: URL はダウンロード可能である必要があり、HTTP または HTTPS プロトコルを使用する必要があります。

コールバックパラメーター

成功コールバックのパラメーター:

  • なし。

失敗コールバックのパラメーター:

  • [string] msg: エラーメッセージ。

イベント

WVVideo.Event.saveVideoSuccess

イベントパラメーター:

  • なし。

WVVideo.Event.saveVideoFailed

イベントパラメーター:

  • [string] msg: エラーメッセージ。

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));
});