• getCurrentPosition(Function successCallback, Function errorCallback)
• getDuration()
• play(Object options)
• playBackground()
• stop()
• pause()
• release()
• setVolume(Number volume)
• startRecord()　※実装にはFileSystemAPIとの連携が必要です。
• stopRecord()　※実装にはFileSystemAPIとの連携が必要です。

メソッド説明

getCurrentPosition(Function successCallback, Function errorCallback)

現在の再生位置を取得します。

パラメータ

Return

サンプルコード

var media = new Media(src, successCallback, errorCallback, statusCallback);

// 1秒ごとに再生位置を取得
var mediaTimer = setInterval(function () {
	// get media position
	media.getCurrentPosition(
		function (position) {
			if (position > -1) {
				console.log((position) + " sec");
			}
		},
		function (e) {
			console.log("Error getting pos=" + e);
		}
	);
}, 1000);

メソッド説明

getDuration()

メディアファイルの再生時間（秒）を返します。

サンプルコード

var media = new Media(src, successCallback, errorCallback, statusCallback);

// メディアファイルの再生時間（秒）を取得
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);

メソッド説明

play(Object options)

オーディオ・ファイルを現在位置から再生開始します。

サンプルコード

function playAudio(src) {
	var media = new Media(
		src,
		function () {
			var options = {
		        route: "receiver"
		    };
			console.log("playAudio():Audio Success");
		},
		function (err) {
			console.log("playAudio():Audio Error: " + err);
		},
		function (status){
			console.log("playAudio():Audio status "+ status);
		}
	);

	/*
	 * 音の発生場所を切り替えます。
	 * speaker  : 既定。端末の下のスピーカーから音を出します。
	 * receiver : 通話用スピーカーから音を出します。
	 */
	var options = {
		route: "receiver"
	};

	// 再生
	media.play(options);
}

ビルド設定

iOSの場合は、プロジェクトのiOSアプリ設定の「音声のバックグラウンド再生」の「使用する」にチェックを入れて保存ボタンを押してください。

※機能を使用せずに「使用する」にチェックを入れている場合、リリース時にリジェクトされる可能性があります。

メソッド説明

playBackground()

通常はplay()で音声を再生しますが、playBackground()を使うと、アプリをバックグラウンドにした時も再生が継続されます。

サンプルコード

function playAudio(src) {
	var media = new Media(
		src,
		function () {
			console.log("playAudio():Audio Success");
		},
		function (err) {
			console.log("playAudio():Audio Error: " + err);
		},
		function (status){
			console.log("playAudio():Audio status "+ status);
		}
	);

	// オーディオファイルを再生
	media.playBackground();
}

メソッド説明

stop()

再生中のオーディオを停止します。

サンプルコード

function playAudio(src) {
	var media = new Media(
		src,
		function () {
			console.log("playAudio():Audio Success");
		},
		function (err) {
			console.log("playAudio():Audio Error: "+err);
		},
		function (status){
			console.log("playAudio():Audio status "+ status);
		}
	);

	media.play();

	function pauseAudio() {
		if (media) {
			media.pause();
		}
	}

	// 停止
	function stopAudio() {
		if (media) {
			media.stop();
		}
		clearInterval(mediaTimer);
		mediaTimer = null;
	}
}

メソッド説明

pause()

再生中のオーディオを一時停止します。

サンプルコード

function playAudio(src) {
	var media = new Media(src,
		function () {
			console.log("playAudio():Audio Success");
		},
		function (err) {
			console.log("playAudio():Audio Error: "+err);
		},
		function (status){
			console.log("playAudio():Audio status "+ status);
		}
	);

	media.play();

	// 一時停止
	function pauseAudio() {
		if (media) {
			media.pause();
		}
	}

	function stopAudio() {
		if (media) {
			media.stop();
		}
		clearInterval(mediaTimer);
		mediaTimer = null;
	}
}

メソッド説明

release()

ロード済みのオーディオリソースを開放します。

サンプルコード

var media = new Media(src, onSuccess, onError);

media.play();
media.stop();
media.release();

メソッド説明

setVolume(Number volume)

ボリュームをセットします。

パラメータ

サンプルコード

function playAudio(src) {
	var media = new Media(src,
		function() {
			console.log("playAudio():Audio Success");
		},
		function(err) {
			console.log("playAudio():Audio Error: "+err);
	});

	media.play();

	// 2秒後にボリュームを0にする
	setTimeout(function() {
		media.setVolume(0);
	}, 2000);

	// 5秒後にボリュームを100にする。
	setTimeout(function() {
		media.setVolume(100);
	}, 5000);
}

メソッド説明

startRecord()

音声を録音する機能です。実装にはFileSystemAPIとの連携が必要です。

サンプルコード

//オーディオ録音
var media = null;
var filepath = null;

// applican の読み込み完了まで待機
document.addEventListener("deviceready", onDeviceReady, false);
// applican 準備完了
function onDeviceReady() {
	$(function(){
		$("#start").click(function() {
			applican.requestFileSystem(LocalFileSystem.PERSISTENT, 0, requestFS, onEr
		});
		$("#stop").click(function() {
			media.stopRecord();
		});
		$("#play").click(function() {
			media.play();
		});
	});
}
// FileSystemに記録
function requestFS(fileSystem) {
	fileSystem.root.getFile("recordMedia.m4a", {create: true, exclusive:
}

function startRecord(entry) {
	// Media
	media = new Media(entry.fullPath, onSuccess, onErrorMD);
	// 録音開始
	media.startRecord();
}

function onSuccess(){
	$("#message").val("onSuccess");
}
function onErrorDR(error){
	$("#message").val("device is error\ncode: " + error.code);
}
function onErrorFS(error){
	$("#message").val("fileSystem is error\ncode: " + error.code);
}
function onErrorMD(error){
	$("#message").val("new Media() is error\ncode: " + error.code);
}

メソッド説明

stopRecord()

録音を停止する機能です。実装にはFileSystemAPIとの連携が必要です。

サンプルコード

//オーディオ録音
var media = null;
var filepath = null;

// applican の読み込み完了まで待機
document.addEventListener("deviceready", onDeviceReady, false);
// applican 準備完了
function onDeviceReady() {
	$(function(){
		$("#start").click(function() {
			applican.requestFileSystem(LocalFileSystem.PERSISTENT, 0, requestFS, onEr
		});
		$("#stop").click(function() {
			// 録音停止
			media.stopRecord();
		});
		$("#play").click(function() {
			media.play();
		});
	});
}
// FileSystemに記録
function requestFS(fileSystem) {
	fileSystem.root.getFile("recordMedia.m4a", {create: true, exclusive:
}

function startRecord(entry) {
	// Media
	media = new Media(entry.fullPath, onSuccess, onErrorMD);
	// 録音開始
	media.startRecord();
}

function onSuccess(){
	$("#message").val("onSuccess");
}
function onErrorDR(error){
	$("#message").val("device is error\ncode: " + error.code);
}
function onErrorFS(error){
	$("#message").val("fileSystem is error\ncode: " + error.code);
}
function onErrorMD(error){
	$("#message").val("new Media() is error\ncode: " + error.code);
}