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 | キャプチャー操作のリクエストがサポートされていない場合。 |