Tutorial

録音したオーディオ、撮影した動画・写真を取得するには

録音したオーディオ、撮影した動画・写真を取得するにはJavaScriptを記述します。
CaptureAPIと呼称します。

動画撮影のサンプルコード

applican.capture.captureVideo(captureVideoSuccess, captureVideoError);

function captureVideoSuccess(mediaFiles){
	var dump = "";
	for (i=0, len=mediaFiles.length; i<len; i++) {
		dump += mediaFiles[i].fullPath+"\n";
	}
	alert(dump);
}
function captureVideoError(err){
	alert(err.code+", "+err.message);
}

解説

1. オーディオ録音(Androidのみ)

applican.capture.captureAudio([成功時のコールバック], [失敗時のコールバック]);

2. 動画撮影

applican.capture.captureVideo([成功時のコールバック], [失敗時のコールバック]);

3. 写真撮影

applican.capture.captureImage([成功時のコールバック], [失敗時のコールバック]);

各CaptureAPIは、端末のネイティブの録音・撮影機能を起動してキャプチャーを行います。成功時のコールバックへは、取得ファイルの情報が配列形式で渡されます。

  • ※ 制限事項
    • ・オーディオ録音はiOSでは未対応です
    • ・各APIのオプションパラメータには未対応です。(最大録音時間等)
    • ・各APIで一度に取得できるコンテンツは1つです。

成功時のコールバックの引数は以下のオブジェクト形式の結果が渡されます。

パラメータ名 説明
name パス情報を含まないファイルの名前を表します。
fullPath ファイルの名前を含むフルパスを表します。
type ファイルの mime type を表します。
lastModifiedDate ファイルの最終更新日時を表します。 (Date)
size ファイルのサイズをバイトで表します。

エラーコード

パラメータ名 説明
CaptureError.CAPTURE_INTERNAL_ERR カメラまたはマイクが画像または音のキャプチャーに失敗した場合。
CaptureError.CAPTURE_APPLICATION_BUSY カメラアプリまたはオーディオ録音アプリが現在他のキャプチャーリクエストを扱っている場合。
CaptureError.CAPTURE_INVALID_ARGUMENT API の使用方法が不正であった場合 (例: limit パラメーターの値が1未満である) 。
CaptureError.CAPTURE_NO_MEDIA_FILES ユーザーが何もキャプチャーせずにカメラアプリやオーディオ録音アプリを終了した場合。
CaptureError.CAPTURE_NOT_SUPPORTED キャプチャー操作のリクエストがサポートされていない場合。
会員登録(無料)はこちらから