Lisa testing pulling in plugins for plugin: cordova-plugin-media (10f54381) · Commits · codevise / cordova-plugin-media

doc/ja/index.md

0 → 100644

+488 −0

Changes for doc/ja/index.md: 488 added lines, 0 removed lines.
Original line number	Diff line number	Diff line
		<!---
		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.
		-->

		# org.apache.cordova.media

		This plugin provides the ability to record and play back audio files on a device.

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

		## インストール

		cordova plugin add org.apache.cordova.media


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

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

		## Windows Phone の癖

		* のみ 1 つのメディアファイルは、一度に再生できます。

		* アプリケーションと他のメディアとの対話に厳格な制限があります。 [詳細については、Microsoft のマニュアル][1]を参照してください。.

		[1]: http://msdn.microsoft.com/en-us/library/windowsphone/develop/hh184838(v=vs.92).aspx

		## メディア

		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

		Returns the current position within an audio file. Also updates the `Media` object's `position` parameter.

		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

		Returns the duration of an audio file in seconds. If the duration is unknown, it returns a value of -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

		基になるオペレーティングシステムのオーディオリソースを解放します。 This is particularly important for Android, since there are a finite amount of OpenCore instances for media playback. アプリケーションを呼び出す必要があります、 `release` 任意の関数 `Media` は、もはや必要なリソースです。

		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 8

		### 簡単な例

		// 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拡張子で終わる必要があります。

		### iOS の癖

		* iOS の種類.wavと返しますエラー場合は、ファイル名拡張子がファイルをレコードのみが修正されません。

		* 記録は、アプリケーションの配置の完全なパスを指定しない場合 `documents/tmp` ディレクトリ。これを介してアクセスすることができます、 `File` API を使用して `LocalFileSystem.TEMPORARY` 。記録時に指定された任意のサブディレクトリに存在する必要があります。

		* ファイルを記録し、再生することができますドキュメント URI を使用して。

		var myMedia = new Media("documents://beer.mp3")


		### 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 8

		### 簡単な例

		// 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

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

		### プロパティ

		* コード: 次のいずれかの定義済みのエラーコード。

		* メッセージ: エラーの詳細を説明するエラーメッセージ。

		### 定数

		* `MediaError.MEDIA_ERR_ABORTED`
		* `MediaError.MEDIA_ERR_NETWORK`
		* `MediaError.MEDIA_ERR_DECODE`
		* `MediaError.MEDIA_ERR_NONE_SUPPORTED`
		No newline at end of file