zhuxc 0f80faa4c0 init erp_h5		7 years ago
..
README.md	0f80faa4c0 init erp_h5	7 years ago
index.md	0f80faa4c0 init erp_h5	7 years ago

cordova-plugin-media

このプラグインは、記録し、デバイス上のオーディオファイルを再生する機能を提供します。

注: 現在の実装では、メディアのキャプチャのための W3C 仕様に準拠していないとは便宜上提供されるだけです。将来の実装を最新の W3C 仕様に準拠し、現在 Api をとがめることがあります。

このプラグインでは、グローバル Media のコンストラクターを定義します。

グローバルスコープではあるがそれがないまで deviceready イベントの後です。

document.addEventListener("deviceready", onDeviceReady, false);
function onDeviceReady() {
    console.log(Media);
}

インストール

cordova plugin add cordova-plugin-media

サポートされているプラットフォーム

アンドロイド
ブラックベリー 10
iOS
Windows Phone 7 と 8
Tizen
Windows 8
Windows
ブラウザー

Windows Phone の癖

のみ 1 つのメディアファイルは、一度に再生できます。
アプリケーションと他のメディアとの対話に厳格な制限があります。詳細については、Microsoft のマニュアルを参照してください。.

メディア

var media = new Media(src, mediaSuccess, [mediaError], [mediaStatus]);

パラメーター

src: オーディオのコンテンツを含む URI。（，）
mediaSuccess: (省略可能) 後に実行するコールバックを Media 再生用に現在、レコード、または stop アクションオブジェクトが完了しました。(機能)
mediaError: (省略可能) エラーが発生した場合に実行されるコールバック。(機能)
mediaStatus: (省略可能) 状態の変化を示すために実行されるコールバック。(機能)

定数

次の定数は、mediaStatus コールバックを唯一のパラメーターとして報告されます。

Media.MEDIA_NONE = 0;
Media.MEDIA_STARTING = 1;
Media.MEDIA_RUNNING = 2;
Media.MEDIA_PAUSED = 3;
Media.MEDIA_STOPPED = 4;

メソッド

media.getCurrentPosition: オーディオファイル内の現在位置を返します。
media.getDuration: オーディオファイルの継続時間を返します。
media.play: 開始またはオーディオファイルの再生を再開します。
media.pause：オーディオファイルの再生を一時停止。
media.release: 基になるオペレーティングシステムのオーディオリソースを解放します。
media.seekTo: オーディオファイル内の位置を移動します。
media.setVolume: オーディオの再生ボリュームを設定します。
media.startRecord：オーディオファイルの録音を開始します。
media.stopRecord: オーディオファイルの録音を停止します。
media.stop: オーディオファイルの再生を停止します。

追加読み取り専用パラメーター

位置：数秒でオーディオの再生では、内の位置。
- 自動的に更新されません; のプレイ中にコール getCurrentPosition を更新します。
期間: 秒で、メディアの期間。

media.getCurrentPosition

オーディオファイル内の現在位置を返します。また、Media オブジェクトの position パラメーターを更新します。

media.getCurrentPosition(mediaSuccess, [mediaError]);

パラメーター

mediaSuccess: 秒の現在の位置を渡されるコールバック。
mediaError: (省略可能) コールバックでエラーが発生した場合に実行します。

簡単な例

// Audio player
//
var my_media = new Media(src, onSuccess, onError);

// Update media position every second
var mediaTimer = setInterval(function () {
    // get media position
    my_media.getCurrentPosition(
        // success callback
        function (position) {
            if (position > -1) {
                console.log((position) + " sec");
            }
        },
        // error callback
        function (e) {
            console.log("Error getting pos=" + e);
        }
    );
}, 1000);

media.getDuration

オーディオファイルの継続時間 (秒単位) を返します。期間は知られている、-1 の値が返されます。

media.getDuration();

簡単な例

// Audio player
//
var my_media = new Media(src, onSuccess, onError);

// Get duration
var counter = 0;
var timerDur = setInterval(function() {
    counter = counter + 100;
    if (counter > 2000) {
        clearInterval(timerDur);
    }
    var dur = my_media.getDuration();
    if (dur > 0) {
        clearInterval(timerDur);
        document.getElementById('audio_duration').innerHTML = (dur) + " sec";
    }
}, 100);

media.pause

オーディオファイルの再生を一時停止します。

media.pause();

簡単な例

// Play audio
//
function playAudio(url) {
    // Play the audio file at url
    var my_media = new Media(url,
        // success callback
        function () { console.log("playAudio():Audio Success"); },
        // error callback
        function (err) { console.log("playAudio():Audio Error: " + err); }
    );

    // Play audio
    my_media.play();

    // Pause after 10 seconds
    setTimeout(function () {
        media.pause();
    }, 10000);
}

media.play

開始またはオーディオファイルの再生を再開します。

media.play();

簡単な例

// Play audio
//
function playAudio(url) {
    // Play the audio file at url
    var my_media = new Media(url,
        // success callback
        function () {
            console.log("playAudio():Audio Success");
        },
        // error callback
        function (err) {
            console.log("playAudio():Audio Error: " + err);
        }
    );
    // Play audio
    my_media.play();
}

iOS の癖

numberOfLoops: このオプションを指定して、 play メディアファイルを再生する、例えば回数を指定する方法。
```
var myMedia = new Media("http://audio.ibeat.org/content/p1rj1s/p1rj1s_-_rockGuitar.mp3")
myMedia.play({ numberOfLoops: 2 })
```
playAudioWhenScreenIsLocked: このオプションを渡す、 play 、画面がロックされているときに再生を許可するかどうかを指定するメソッド。場合に設定されている true (既定値)、例えば、ハードウェアミュートボタンの状態は無視されます。
```
var myMedia = new Media("http://audio.ibeat.org/content/p1rj1s/p1rj1s_-_rockGuitar.mp3")
myMedia.play({ playAudioWhenScreenIsLocked : false })
```
ファイル検索の順序: iOS の検索でファイル名または単純なパスのみが提供される場合、 www ディレクトリ、ファイルをアプリケーションの documents/tmp ディレクトリ。
```
var myMedia = new Media("audio/beer.mp3")
myMedia.play()  // first looks for file in www/audio/beer.mp3 then in <application>/documents/tmp/audio/beer.mp3
```

media.release

基になるオペレーティングシステムのオーディオリソースを解放します。メディアの再生のための OpenCore インスタンスの有限な量があるので、人造人間のため特に重要です。アプリケーションが不要な Media リソースの release の関数を呼び出す必要があります。

media.release();

簡単な例

// Audio player
//
var my_media = new Media(src, onSuccess, onError);

my_media.play();
my_media.stop();
my_media.release();

media.seekTo

オーディオファイル内の現在位置を設定します。

media.seekTo(milliseconds);

パラメーター

ミリ秒単位：ミリ秒単位で、オーディオの再生位置を設定する位置。

簡単な例

// Audio player
//
var my_media = new Media(src, onSuccess, onError);
    my_media.play();
// SeekTo to 10 seconds after 5 seconds
setTimeout(function() {
    my_media.seekTo(10000);
}, 5000);

ブラックベリー 10 癖

ブラックベリー OS 5 デバイスでサポートされていません。

media.setVolume

オーディオファイルの音量を設定します。

media.setVolume(volume);

パラメーター

ボリューム: ボリュームの再生を設定します。値は 0.0 ～ 1.0 の範囲内である必要があります。

サポートされているプラットフォーム

アンドロイド
iOS

簡単な例

// Play audio
//
function playAudio(url) {
    // Play the audio file at url
    var my_media = new Media(url,
        // success callback
        function() {
            console.log("playAudio():Audio Success");
        },
        // error callback
        function(err) {
            console.log("playAudio():Audio Error: "+err);
    });

    // Play audio
    my_media.play();

    // Mute volume after 2 seconds
    setTimeout(function() {
        my_media.setVolume('0.0');
    }, 2000);

    // Set volume to 1.0 after 5 seconds
    setTimeout(function() {
        my_media.setVolume('1.0');
    }, 5000);
}

media.startRecord

オーディオファイルの録音を開始します。

media.startRecord();

サポートされているプラットフォーム

アンドロイド
iOS
Windows Phone 7 と 8
Windows

簡単な例

// Record audio
//
function recordAudio() {
    var src = "myrecording.mp3";
    var mediaRec = new Media(src,
        // success callback
        function() {
            console.log("recordAudio():Audio Success");
        },

        // error callback
        function(err) {
            console.log("recordAudio():Audio Error: "+ err.code);
        });

    // Record audio
    mediaRec.startRecord();
}

Android の癖

Android 端末適応型マルチレート形式にオーディオを録音します。指定したファイルは、 *.amr*拡張子で終わる必要があります。
メディアオブジェクトが生きている間、ハードウェアのボリュームコントロールは有線メディアボリュームまで。一度 release() それと呼ばれるオブジェクトには最後に作成したメディア、ボリュームコントロールのデフォルトの動作に戻ります。コントロールは、すべてのメディアオブジェクトをリリースこれとしてページナビゲーションにもリセットされます。

iOS の癖

iOS の種類*.wav*と返しますエラー場合は、ファイル名拡張子がファイルをレコードのみが修正されません。
記録は、アプリケーションの配置の完全なパスを指定しない場合 documents/tmp ディレクトリ。これを介してアクセスすることができます、 File API を使用して LocalFileSystem.TEMPORARY 。記録時に指定された任意のサブディレクトリに存在する必要があります。
ファイルを記録し、再生することができますドキュメント URI を使用して。
```
var myMedia = new Media("documents://beer.mp3")
```

Windows の癖

Windows デバイスで使用できる MP3、M4A、WMA 形式は、オーディオを記録しました。しかしほとんどの場合は不可能だ MP3 エンコーダーがWindows Phone に付属していないので、 *8.1 の Windows Phone*デバイスでオーディオ録音の MP3 を使用するには.
完全なパスを指定しない場合、記録は AppData/temp ディレクトリに配置されます。これを介してアクセスすることができます、 ファイル API を使用してください。 LocalFileSystem.TEMPORARY または ' ms appdata: temp////' URI。
記録時に指定された任意のサブディレクトリに存在する必要があります。

Tizen の癖

Tizen のデバイスでサポートされていません。

media.stop

オーディオファイルの再生を停止します。

media.stop();

簡単な例

// Play audio
//
function playAudio(url) {
    // Play the audio file at url
    var my_media = new Media(url,
        // success callback
        function() {
            console.log("playAudio():Audio Success");
        },
        // error callback
        function(err) {
            console.log("playAudio():Audio Error: "+err);
        }
    );

    // Play audio
    my_media.play();

    // Pause after 10 seconds
    setTimeout(function() {
        my_media.stop();
    }, 10000);
}

media.stopRecord

オーディオファイルの録音を停止します。

media.stopRecord();

サポートされているプラットフォーム

アンドロイド
iOS
Windows Phone 7 と 8
Windows

簡単な例

// Record audio
//
function recordAudio() {
    var src = "myrecording.mp3";
    var mediaRec = new Media(src,
        // success callback
        function() {
            console.log("recordAudio():Audio Success");
        },

        // error callback
        function(err) {
            console.log("recordAudio():Audio Error: "+ err.code);
        }
    );

    // Record audio
    mediaRec.startRecord();

    // Stop recording after 10 seconds
    setTimeout(function() {
        mediaRec.stopRecord();
    }, 10000);
}

Tizen の癖

Tizen のデバイスでサポートされていません。

MediaError

MediaError オブジェクトにエラーが発生したときに mediaError コールバック関数に返されます。

プロパティ

コード: 次のいずれかの定義済みのエラーコード。
メッセージ: エラーの詳細を説明するエラーメッセージ。

定数

MediaError.MEDIA_ERR_ABORTED= 1
MediaError.MEDIA_ERR_NETWORK= 2
MediaError.MEDIA_ERR_DECODE= 3
MediaError.MEDIA_ERR_NONE_SUPPORTED= 4

README.md

cordova-plugin-media

インストール

サポートされているプラットフォーム

Windows Phone の癖

メディア

パラメーター

定数

メソッド

追加読み取り専用パラメーター

media.getCurrentPosition

パラメーター

簡単な例

media.getDuration

簡単な例

media.pause

簡単な例

media.play

簡単な例

iOS の癖

media.release

簡単な例

media.seekTo

パラメーター

簡単な例

ブラックベリー 10 癖

media.setVolume

パラメーター

サポートされているプラットフォーム

簡単な例

media.startRecord

サポートされているプラットフォーム

簡単な例

Android の癖

iOS の癖

Windows の癖

Tizen の癖

media.stop

簡単な例

media.stopRecord

サポートされているプラットフォーム

簡単な例

Tizen の癖

MediaError

プロパティ

定数