license: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the “License”); you may not use this file except in compliance with the License. You may obtain a copy of the License at

       http://www.apache.org/licenses/LICENSE-2.0

     Unless required by applicable law or agreed to in writing,
     software distributed under the License is distributed on an
     "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
     KIND, either express or implied.  See the License for the
     specific language governing permissions and limitations
     under the License.

media.getCurrentPosition

オーディオファイル内の現在の再生位置を返します。

media.getCurrentPosition(mediaSuccess, [mediaError]);

パラメーター

mediaSuccess: 現在再生位置とともに呼ばれるコールバック関数を表します
mediaError: (オプション) エラー発生時に呼ばれるコールバック関数を表します

概要

media.getCurrentPosition 関数は Media オブジェクトのオーディオファイルの現在再生位置を返す非同期関数です。 Media オブジェクト内の position パラメーターの値も更新します。

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

Android
BlackBerry WebWorks (OS 5.0 以上)
iOS
Windows Phone 7 (Mango)

使用例

// オーディオプレイヤー
//
var my_media = new Media(src, onSuccess, onError);

// メディアの再生位置を一秒ごとに更新
var mediaTimer = setInterval(function() {
        // 再生位置を取得
        my_media.getCurrentPosition(
            // 呼び出し成功
            function(position) {
            if (position > -1) {
            console.log((position) + " sec");
            }
            },
            // 呼び出し失敗
            function(e) {
                console.log("Error getting pos=" + e);
            }
        );
    }, 1000);

詳細な使用例

    <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
                  "http://www.w3.org/TR/html4/strict.dtd">
    <html>
      <head>
        <title>メディアの使用例</title>

        <script type="text/javascript" charset="utf-8" src="cordova-1.9.0.js"></script>
        <script type="text/javascript" charset="utf-8">

        // Cordova の読み込み完了まで待機
        //
        document.addEventListener("deviceready", onDeviceReady, false);

        // Cordova 準備完了
        //
        function onDeviceReady() {
            playAudio("http://audio.ibeat.org/content/p1rj1s/p1rj1s_-_rockGuitar.mp3");
        }

        // オーディオプレイヤー
        //
        var my_media = null;
        var mediaTimer = null;

        // オーディオ再生
        //
        function playAudio(src) {
            // src から Media オブジェクトを作成
            my_media = new Media(src, onSuccess, onError);

            // オーディオ再生
            my_media.play();

            // my_media の再生位置を一秒ごとに更新
            if (mediaTimer == null) {
                mediaTimer = setInterval(function() {
                    // my_media の再生位置を取得
                    my_media.getCurrentPosition(
                        // 呼び出し成功
                        function(position) {
                            if (position > -1) {
                                setAudioPosition((position) + " sec");
                            }
                        },
                        // 呼び出し失敗
                        function(e) {
                            console.log("Error getting pos=" + e);
                            setAudioPosition("Error: " + e);
                        }
                    );
                }, 1000);
            }
        }

        // オーディオ一時停止
        //
        function pauseAudio() {
            if (my_media) {
                my_media.pause();
            }
        }

        // オーディオ停止
        //
        function stopAudio() {
            if (my_media) {
                my_media.stop();
            }
            clearInterval(mediaTimer);
            mediaTimer = null;
        }

        // 成功時のコールバック関数
        //
        function onSuccess() {
            console.log("playAudio():Audio Success");
        }

        // エラー時のコールバック関数
        //
        function onError(error) {
            alert('コード: '        + error.code    + '\n' +
                  'メッセージ: '    + error.message + '\n');
        }

        // 再生位置をセット
        //
        function setAudioPosition(position) {
            document.getElementById('audio_position').innerHTML = position;
        }

        </script>
      </head>
      <body>
        <a href="#" class="btn large" onclick="playAudio('http://audio.ibeat.org/content/p1rj1s/p1rj1s_-_rockGuitar.mp3');">再生</a>
        <a href="#" class="btn large" onclick="pauseAudio();">一時停止</a>
        <a href="#" class="btn large" onclick="stopAudio();">停止</a>
        <p id="audio_position"></p>
      </body>
    </html>