2 * Copyright (C) 2008 The Android Open Source Project
4 * Licensed under the Apache License, Version 2.0 (the "License");
5 * you may not use this file except in compliance with the License.
6 * You may obtain a copy of the License at
8 * http://www.apache.org/licenses/LICENSE-2.0
10 * Unless required by applicable law or agreed to in writing, software
11 * distributed under the License is distributed on an "AS IS" BASIS,
12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 * See the License for the specific language governing permissions and
14 * limitations under the License.
24 //#define LOG_NDEBUG 0
25 #define LOG_TAG "MediaRecorderJNI"
26 #include <utils/Log.h>
28 #include <gui/Surface.h>
29 #include <camera/Camera.h>
30 #include <media/mediarecorder.h>
31 #include <media/stagefright/PersistentSurface.h>
32 #include <utils/threads.h>
34 #include <ScopedUtfChars.h>
38 #include "android_runtime/AndroidRuntime.h"
40 #include <system/audio.h>
41 #include <android_runtime/android_view_Surface.h>
43 // ----------------------------------------------------------------------------
45 using namespace android;
47 // ----------------------------------------------------------------------------
49 // helper function to extract a native Camera object from a Camera Java object
50 extern sp<Camera> get_native_camera(JNIEnv *env, jobject thiz, struct JNICameraContext** context);
51 extern sp<PersistentSurface>
52 android_media_MediaCodec_getPersistentInputSurface(JNIEnv* env, jobject object);
60 static fields_t fields;
64 // ----------------------------------------------------------------------------
65 // ref-counted object for callbacks
66 class JNIMediaRecorderListener: public MediaRecorderListener
69 JNIMediaRecorderListener(JNIEnv* env, jobject thiz, jobject weak_thiz);
70 ~JNIMediaRecorderListener();
71 void notify(int msg, int ext1, int ext2);
73 JNIMediaRecorderListener();
74 jclass mClass; // Reference to MediaRecorder class
75 jobject mObject; // Weak ref to MediaRecorder Java object to call on
78 JNIMediaRecorderListener::JNIMediaRecorderListener(JNIEnv* env, jobject thiz, jobject weak_thiz)
81 // Hold onto the MediaRecorder class for use in calling the static method
82 // that posts events to the application thread.
83 jclass clazz = env->GetObjectClass(thiz);
85 ALOGE("Can't find android/media/MediaRecorder");
86 jniThrowException(env, "java/lang/Exception", NULL);
89 mClass = (jclass)env->NewGlobalRef(clazz);
91 // We use a weak reference so the MediaRecorder object can be garbage collected.
92 // The reference is only used as a proxy for callbacks.
93 mObject = env->NewGlobalRef(weak_thiz);
96 JNIMediaRecorderListener::~JNIMediaRecorderListener()
98 // remove global references
99 JNIEnv *env = AndroidRuntime::getJNIEnv();
100 env->DeleteGlobalRef(mObject);
101 env->DeleteGlobalRef(mClass);
104 void JNIMediaRecorderListener::notify(int msg, int ext1, int ext2)
106 ALOGV("JNIMediaRecorderListener::notify");
108 JNIEnv *env = AndroidRuntime::getJNIEnv();
109 env->CallStaticVoidMethod(mClass, fields.post_event, mObject, msg, ext1, ext2, NULL);
112 // ----------------------------------------------------------------------------
114 static sp<Surface> get_surface(JNIEnv* env, jobject clazz)
116 ALOGV("get_surface");
117 return android_view_Surface_getSurface(env, clazz);
120 static sp<PersistentSurface> get_persistentSurface(JNIEnv* env, jobject object)
122 ALOGV("get_persistentSurface");
123 return android_media_MediaCodec_getPersistentInputSurface(env, object);
126 // Returns true if it throws an exception.
127 static bool process_media_recorder_call(JNIEnv *env, status_t opStatus, const char* exception, const char* message)
129 ALOGV("process_media_recorder_call");
130 if (opStatus == (status_t)INVALID_OPERATION) {
131 jniThrowException(env, "java/lang/IllegalStateException", NULL);
133 } else if (opStatus != (status_t)OK) {
134 jniThrowException(env, exception, message);
140 static sp<MediaRecorder> getMediaRecorder(JNIEnv* env, jobject thiz)
142 Mutex::Autolock l(sLock);
143 MediaRecorder* const p = (MediaRecorder*)env->GetLongField(thiz, fields.context);
144 return sp<MediaRecorder>(p);
147 static sp<MediaRecorder> setMediaRecorder(JNIEnv* env, jobject thiz, const sp<MediaRecorder>& recorder)
149 Mutex::Autolock l(sLock);
150 sp<MediaRecorder> old = (MediaRecorder*)env->GetLongField(thiz, fields.context);
151 if (recorder.get()) {
152 recorder->incStrong(thiz);
155 old->decStrong(thiz);
157 env->SetLongField(thiz, fields.context, (jlong)recorder.get());
162 static void android_media_MediaRecorder_setCamera(JNIEnv* env, jobject thiz, jobject camera)
164 // we should not pass a null camera to get_native_camera() call.
165 if (camera == NULL) {
166 jniThrowNullPointerException(env, "camera object is a NULL pointer");
169 sp<Camera> c = get_native_camera(env, camera, NULL);
171 // get_native_camera will throw an exception in this case
174 sp<MediaRecorder> mr = getMediaRecorder(env, thiz);
175 process_media_recorder_call(env, mr->setCamera(c->remote(), c->getRecordingProxy()),
176 "java/lang/RuntimeException", "setCamera failed.");
180 android_media_MediaRecorder_setVideoSource(JNIEnv *env, jobject thiz, jint vs)
182 ALOGV("setVideoSource(%d)", vs);
183 if (vs < VIDEO_SOURCE_DEFAULT || vs >= VIDEO_SOURCE_LIST_END) {
184 jniThrowException(env, "java/lang/IllegalArgumentException", "Invalid video source");
187 sp<MediaRecorder> mr = getMediaRecorder(env, thiz);
188 process_media_recorder_call(env, mr->setVideoSource(vs), "java/lang/RuntimeException", "setVideoSource failed.");
192 android_media_MediaRecorder_setAudioSource(JNIEnv *env, jobject thiz, jint as)
194 ALOGV("setAudioSource(%d)", as);
195 if (as < AUDIO_SOURCE_DEFAULT ||
196 (as >= AUDIO_SOURCE_CNT && as != AUDIO_SOURCE_FM_TUNER)) {
197 jniThrowException(env, "java/lang/IllegalArgumentException", "Invalid audio source");
201 sp<MediaRecorder> mr = getMediaRecorder(env, thiz);
202 process_media_recorder_call(env, mr->setAudioSource(as), "java/lang/RuntimeException", "setAudioSource failed.");
206 android_media_MediaRecorder_setOutputFormat(JNIEnv *env, jobject thiz, jint of)
208 ALOGV("setOutputFormat(%d)", of);
209 if (of < OUTPUT_FORMAT_DEFAULT || of >= OUTPUT_FORMAT_LIST_END) {
210 jniThrowException(env, "java/lang/IllegalArgumentException", "Invalid output format");
213 sp<MediaRecorder> mr = getMediaRecorder(env, thiz);
214 process_media_recorder_call(env, mr->setOutputFormat(of), "java/lang/RuntimeException", "setOutputFormat failed.");
218 android_media_MediaRecorder_setVideoEncoder(JNIEnv *env, jobject thiz, jint ve)
220 ALOGV("setVideoEncoder(%d)", ve);
221 if (ve < VIDEO_ENCODER_DEFAULT || ve >= VIDEO_ENCODER_LIST_END) {
222 jniThrowException(env, "java/lang/IllegalArgumentException", "Invalid video encoder");
225 sp<MediaRecorder> mr = getMediaRecorder(env, thiz);
226 process_media_recorder_call(env, mr->setVideoEncoder(ve), "java/lang/RuntimeException", "setVideoEncoder failed.");
230 android_media_MediaRecorder_setAudioEncoder(JNIEnv *env, jobject thiz, jint ae)
232 ALOGV("setAudioEncoder(%d)", ae);
233 if (ae < AUDIO_ENCODER_DEFAULT || ae >= AUDIO_ENCODER_LIST_END) {
234 jniThrowException(env, "java/lang/IllegalArgumentException", "Invalid audio encoder");
237 sp<MediaRecorder> mr = getMediaRecorder(env, thiz);
238 process_media_recorder_call(env, mr->setAudioEncoder(ae), "java/lang/RuntimeException", "setAudioEncoder failed.");
242 android_media_MediaRecorder_setParameter(JNIEnv *env, jobject thiz, jstring params)
244 ALOGV("setParameter()");
247 ALOGE("Invalid or empty params string. This parameter will be ignored.");
251 sp<MediaRecorder> mr = getMediaRecorder(env, thiz);
253 const char* params8 = env->GetStringUTFChars(params, NULL);
256 ALOGE("Failed to covert jstring to String8. This parameter will be ignored.");
260 process_media_recorder_call(env, mr->setParameters(String8(params8)), "java/lang/RuntimeException", "setParameter failed.");
261 env->ReleaseStringUTFChars(params,params8);
265 android_media_MediaRecorder_setOutputFileFD(JNIEnv *env, jobject thiz, jobject fileDescriptor, jlong offset, jlong length)
267 ALOGV("setOutputFile");
268 if (fileDescriptor == NULL) {
269 jniThrowException(env, "java/lang/IllegalArgumentException", NULL);
272 int fd = jniGetFDFromFileDescriptor(env, fileDescriptor);
273 sp<MediaRecorder> mr = getMediaRecorder(env, thiz);
274 status_t opStatus = mr->setOutputFile(fd, offset, length);
275 process_media_recorder_call(env, opStatus, "java/io/IOException", "setOutputFile failed.");
279 android_media_MediaRecorder_setVideoSize(JNIEnv *env, jobject thiz, jint width, jint height)
281 ALOGV("setVideoSize(%d, %d)", width, height);
282 sp<MediaRecorder> mr = getMediaRecorder(env, thiz);
284 if (width <= 0 || height <= 0) {
285 jniThrowException(env, "java/lang/IllegalArgumentException", "invalid video size");
288 process_media_recorder_call(env, mr->setVideoSize(width, height), "java/lang/RuntimeException", "setVideoSize failed.");
292 android_media_MediaRecorder_setVideoFrameRate(JNIEnv *env, jobject thiz, jint rate)
294 ALOGV("setVideoFrameRate(%d)", rate);
296 jniThrowException(env, "java/lang/IllegalArgumentException", "invalid frame rate");
299 sp<MediaRecorder> mr = getMediaRecorder(env, thiz);
300 process_media_recorder_call(env, mr->setVideoFrameRate(rate), "java/lang/RuntimeException", "setVideoFrameRate failed.");
304 android_media_MediaRecorder_setMaxDuration(JNIEnv *env, jobject thiz, jint max_duration_ms)
306 ALOGV("setMaxDuration(%d)", max_duration_ms);
307 sp<MediaRecorder> mr = getMediaRecorder(env, thiz);
310 sprintf(params, "max-duration=%d", max_duration_ms);
312 process_media_recorder_call(env, mr->setParameters(String8(params)), "java/lang/RuntimeException", "setMaxDuration failed.");
316 android_media_MediaRecorder_setMaxFileSize(
317 JNIEnv *env, jobject thiz, jlong max_filesize_bytes)
319 ALOGV("setMaxFileSize(%lld)", (long long)max_filesize_bytes);
320 sp<MediaRecorder> mr = getMediaRecorder(env, thiz);
323 sprintf(params, "max-filesize=%" PRId64, max_filesize_bytes);
325 process_media_recorder_call(env, mr->setParameters(String8(params)), "java/lang/RuntimeException", "setMaxFileSize failed.");
329 android_media_MediaRecorder_prepare(JNIEnv *env, jobject thiz)
332 sp<MediaRecorder> mr = getMediaRecorder(env, thiz);
334 jobject surface = env->GetObjectField(thiz, fields.surface);
335 if (surface != NULL) {
336 const sp<Surface> native_surface = get_surface(env, surface);
338 // The application may misbehave and
339 // the preview surface becomes unavailable
340 if (native_surface.get() == 0) {
341 ALOGE("Application lost the surface");
342 jniThrowException(env, "java/io/IOException", "invalid preview surface");
346 ALOGI("prepare: surface=%p", native_surface.get());
347 if (process_media_recorder_call(env, mr->setPreviewSurface(native_surface->getIGraphicBufferProducer()), "java/lang/RuntimeException", "setPreviewSurface failed.")) {
351 process_media_recorder_call(env, mr->prepare(), "java/io/IOException", "prepare failed.");
355 android_media_MediaRecorder_native_getMaxAmplitude(JNIEnv *env, jobject thiz)
357 ALOGV("getMaxAmplitude");
358 sp<MediaRecorder> mr = getMediaRecorder(env, thiz);
360 process_media_recorder_call(env, mr->getMaxAmplitude(&result), "java/lang/RuntimeException", "getMaxAmplitude failed.");
361 return (jint) result;
365 android_media_MediaRecorder_getSurface(JNIEnv *env, jobject thiz)
368 sp<MediaRecorder> mr = getMediaRecorder(env, thiz);
370 sp<IGraphicBufferProducer> bufferProducer = mr->querySurfaceMediaSourceFromMediaServer();
371 if (bufferProducer == NULL) {
374 "java/lang/IllegalStateException",
375 "failed to get surface");
379 // Wrap the IGBP in a Java-language Surface.
380 return android_view_Surface_createFromIGraphicBufferProducer(env,
385 android_media_MediaRecorder_start(JNIEnv *env, jobject thiz)
388 sp<MediaRecorder> mr = getMediaRecorder(env, thiz);
389 process_media_recorder_call(env, mr->start(), "java/lang/RuntimeException", "start failed.");
393 android_media_MediaRecorder_stop(JNIEnv *env, jobject thiz)
396 sp<MediaRecorder> mr = getMediaRecorder(env, thiz);
397 process_media_recorder_call(env, mr->stop(), "java/lang/RuntimeException", "stop failed.");
401 android_media_MediaRecorder_pause(JNIEnv *env, jobject thiz)
404 sp<MediaRecorder> mr = getMediaRecorder(env, thiz);
405 process_media_recorder_call(env, mr->pause(), "java/lang/RuntimeException", "pause failed.");
409 android_media_MediaRecorder_resume(JNIEnv *env, jobject thiz)
412 sp<MediaRecorder> mr = getMediaRecorder(env, thiz);
413 process_media_recorder_call(env, mr->resume(), "java/lang/RuntimeException", "resume failed.");
417 android_media_MediaRecorder_native_reset(JNIEnv *env, jobject thiz)
419 ALOGV("native_reset");
420 sp<MediaRecorder> mr = getMediaRecorder(env, thiz);
421 process_media_recorder_call(env, mr->reset(), "java/lang/RuntimeException", "native_reset failed.");
425 android_media_MediaRecorder_release(JNIEnv *env, jobject thiz)
428 sp<MediaRecorder> mr = setMediaRecorder(env, thiz, 0);
430 mr->setListener(NULL);
435 // This function gets some field IDs, which in turn causes class initialization.
436 // It is called from a static block in MediaRecorder, which won't run until the
437 // first time an instance of this class is used.
439 android_media_MediaRecorder_native_init(JNIEnv *env)
443 clazz = env->FindClass("android/media/MediaRecorder");
448 fields.context = env->GetFieldID(clazz, "mNativeContext", "J");
449 if (fields.context == NULL) {
453 fields.surface = env->GetFieldID(clazz, "mSurface", "Landroid/view/Surface;");
454 if (fields.surface == NULL) {
458 jclass surface = env->FindClass("android/view/Surface");
459 if (surface == NULL) {
463 fields.post_event = env->GetStaticMethodID(clazz, "postEventFromNative",
464 "(Ljava/lang/Object;IIILjava/lang/Object;)V");
465 if (fields.post_event == NULL) {
472 android_media_MediaRecorder_native_setup(JNIEnv *env, jobject thiz, jobject weak_this,
473 jstring packageName, jstring opPackageName)
477 ScopedUtfChars opPackageNameStr(env, opPackageName);
479 sp<MediaRecorder> mr = new MediaRecorder(String16(opPackageNameStr.c_str()));
481 jniThrowException(env, "java/lang/RuntimeException", "Out of memory");
484 if (mr->initCheck() != NO_ERROR) {
485 jniThrowException(env, "java/lang/RuntimeException", "Unable to initialize media recorder");
489 // create new listener and give it to MediaRecorder
490 sp<JNIMediaRecorderListener> listener = new JNIMediaRecorderListener(env, thiz, weak_this);
491 mr->setListener(listener);
493 // Convert client name jstring to String16
494 const char16_t *rawClientName = reinterpret_cast<const char16_t*>(
495 env->GetStringChars(packageName, NULL));
496 jsize rawClientNameLen = env->GetStringLength(packageName);
497 String16 clientName(rawClientName, rawClientNameLen);
498 env->ReleaseStringChars(packageName,
499 reinterpret_cast<const jchar*>(rawClientName));
501 // pass client package name for permissions tracking
502 mr->setClientName(clientName);
504 setMediaRecorder(env, thiz, mr);
508 android_media_MediaRecorder_native_finalize(JNIEnv *env, jobject thiz)
511 android_media_MediaRecorder_release(env, thiz);
514 void android_media_MediaRecorder_setInputSurface(
515 JNIEnv* env, jobject thiz, jobject object) {
516 ALOGV("android_media_MediaRecorder_setInputSurface");
518 sp<MediaRecorder> mr = getMediaRecorder(env, thiz);
520 sp<PersistentSurface> persistentSurface = get_persistentSurface(env, object);
522 process_media_recorder_call(env, mr->setInputSurface(persistentSurface),
523 "java/lang/IllegalArgumentException", "native_setInputSurface failed.");
526 // ----------------------------------------------------------------------------
528 static const JNINativeMethod gMethods[] = {
529 {"setCamera", "(Landroid/hardware/Camera;)V", (void *)android_media_MediaRecorder_setCamera},
530 {"setVideoSource", "(I)V", (void *)android_media_MediaRecorder_setVideoSource},
531 {"setAudioSource", "(I)V", (void *)android_media_MediaRecorder_setAudioSource},
532 {"setOutputFormat", "(I)V", (void *)android_media_MediaRecorder_setOutputFormat},
533 {"setVideoEncoder", "(I)V", (void *)android_media_MediaRecorder_setVideoEncoder},
534 {"setAudioEncoder", "(I)V", (void *)android_media_MediaRecorder_setAudioEncoder},
535 {"setParameter", "(Ljava/lang/String;)V", (void *)android_media_MediaRecorder_setParameter},
536 {"_setOutputFile", "(Ljava/io/FileDescriptor;JJ)V", (void *)android_media_MediaRecorder_setOutputFileFD},
537 {"setVideoSize", "(II)V", (void *)android_media_MediaRecorder_setVideoSize},
538 {"setVideoFrameRate", "(I)V", (void *)android_media_MediaRecorder_setVideoFrameRate},
539 {"setMaxDuration", "(I)V", (void *)android_media_MediaRecorder_setMaxDuration},
540 {"setMaxFileSize", "(J)V", (void *)android_media_MediaRecorder_setMaxFileSize},
541 {"_prepare", "()V", (void *)android_media_MediaRecorder_prepare},
542 {"getSurface", "()Landroid/view/Surface;", (void *)android_media_MediaRecorder_getSurface},
543 {"getMaxAmplitude", "()I", (void *)android_media_MediaRecorder_native_getMaxAmplitude},
544 {"start", "()V", (void *)android_media_MediaRecorder_start},
545 {"stop", "()V", (void *)android_media_MediaRecorder_stop},
546 {"pause", "()V", (void *)android_media_MediaRecorder_pause},
547 {"resume", "()V", (void *)android_media_MediaRecorder_resume},
548 {"native_reset", "()V", (void *)android_media_MediaRecorder_native_reset},
549 {"release", "()V", (void *)android_media_MediaRecorder_release},
550 {"native_init", "()V", (void *)android_media_MediaRecorder_native_init},
551 {"native_setup", "(Ljava/lang/Object;Ljava/lang/String;Ljava/lang/String;)V",
552 (void *)android_media_MediaRecorder_native_setup},
553 {"native_finalize", "()V", (void *)android_media_MediaRecorder_native_finalize},
554 {"native_setInputSurface", "(Landroid/view/Surface;)V", (void *)android_media_MediaRecorder_setInputSurface },
557 // This function only registers the native methods, and is called from
558 // JNI_OnLoad in android_media_MediaPlayer.cpp
559 int register_android_media_MediaRecorder(JNIEnv *env)
561 return AndroidRuntime::registerNativeMethods(env,
562 "android/media/MediaRecorder", gMethods, NELEM(gMethods));