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

README.md

cordova-plugin-media

Build Status

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

: 現在の実装では、メディアのキャプチャのための 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 の癖

メディア

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