2. 程式人生 > >Android原始碼筆記——Camera系統架構

Android原始碼筆記——Camera系統架構

阿新 • • 發佈：2019-02-13

Camera的架構與Android系統的整體架構保持一致，如下圖所示，本文主要從以下四個方面對其進行說明。

  1. Framework：Camera.java
  2. Android Runtime：android_hardware_Camera.cpp
  3. Library：Camera Client和Camera Service
  4. HAL：CameraHardwareInterface

14527792381330663_thumb9

一、Framework：Camera.java

Camera是應用層軟體直接使用的類，涵蓋了啟動、預覽、拍攝及關閉等操作攝像頭的全部介面。Camera.Java在Android原始碼中的路徑為：framework/base/core/java/android/hardware。為了說明整個Camera系統的架構，這裡暫不橫向分析Camera.java的功能，下面從open()方法著手：

複製程式碼 
public static Camera open() {
    int numberOfCameras = getNumberOfCameras();
    CameraInfo cameraInfo = new CameraInfo();
    for (int i = 0; i < numberOfCameras; i++) {
        getCameraInfo(i, cameraInfo);
        if (cameraInfo.facing == CameraInfo.CAMERA_FACING_BACK) {
            return new
 
 Camera(i);
        }
    }
    return null;
}
複製程式碼

open()方法需要注意以下幾點：

  • getNumberOfCameras為native方法，實現在android_hardware_Camera.cpp中；
  • CameraInfo是Camera定義的靜態內部類，包含facing、orientation、canDisableShutterSound；
  • getCameraInfo內部呼叫native方法_getCameraInfo獲取攝像頭資訊；
  • open()預設啟動的是後置攝像頭（CAMERA_FACING_BACK）。
複製程式碼 
/** used by Camera#open, Camera#open(int) 
 
*/
Camera(int cameraId) {
    int err = cameraInitNormal(cameraId);
    if (checkInitErrors(err)) {
        switch(err) {
            case EACCESS:
                throw new RuntimeException("Fail to connect to camera service");
            case ENODEV:
                throw new RuntimeException("Camera initialization failed");
            default:
                // Should never hit this.
                throw new RuntimeException("Unknown camera error");
        }
    }
}
複製程式碼

Camera構造器的核心實現在cameraInitNormal中，cameraInitNormal呼叫cameraInitVersion，並傳入引數cameraId和CAMERA_HAL_API_VERSION_NORMAL_CONNECT，後者代表HAL的版本。

private int cameraInitVersion(int cameraId, int halVersion) {

    ……
    String packageName = ActivityThread.currentPackageName();
    return native_setup(new WeakReference<Camera>(this), cameraId, halVersion, packageName);
}

cameraInitNormal呼叫本地方法native_setup()，由此進入到android_hardware_Camera.cpp中，native_setup()的簽名如下：

private native final int native_setup(Object camera_this, int cameraId, int halVersion, String packageName);

二、Android Runtime：android_hardware_Camera.cpp

native_setup()被動態註冊到JNI，通過JNI呼叫android_hardware_Camera_native_setup()方法。

複製程式碼 
static JNINativeMethod camMethods[] = {
    ……
    { "native_setup",    "(Ljava/lang/Object;ILjava/lang/String;)V",
    (void*)android_hardware_Camera_native_setup }
    ……
};
複製程式碼

JNI的重點是android_hardware_Camera_native_setup()方法的實現：

複製程式碼 
// connect to camera service
static jint android_hardware_Camera_native_setup(JNIEnv *env, jobject thiz,
    jobject weak_this, jint cameraId, jint halVersion, jstring clientPackageName)
{
    // Convert jstring to String16
    const char16_t *rawClientName = env->GetStringChars(clientPackageName, NULL);
    jsize rawClientNameLen = env->GetStringLength(clientPackageName);
    String16 clientName(rawClientName, rawClientNameLen);
    env->ReleaseStringChars(clientPackageName, rawClientName);

    sp<Camera> camera;
    if (halVersion == CAMERA_HAL_API_VERSION_NORMAL_CONNECT) {
        // Default path: hal version is don't care, do normal camera connect.
        camera = Camera::connect(cameraId, clientName,
                Camera::USE_CALLING_UID);
    } else {
        jint status = Camera::connectLegacy(cameraId, halVersion, clientName,
                Camera::USE_CALLING_UID, camera);
        if (status != NO_ERROR) {
            return status;
        }
    }

    if (camera == NULL) {
        return -EACCES;
    }

    // make sure camera hardware is alive
    if (camera->getStatus() != NO_ERROR) {
        return NO_INIT;
    }

    jclass clazz = env->GetObjectClass(thiz);
    if (clazz == NULL) {
        // This should never happen
        jniThrowRuntimeException(env, "Can't find android/hardware/Camera");
        return INVALID_OPERATION;
    }

    // We use a weak reference so the Camera object can be garbage collected.
    // The reference is only used as a proxy for callbacks.
    sp<JNICameraContext> context = new JNICameraContext(env, weak_this, clazz, camera);
    context->incStrong((void*)android_hardware_Camera_native_setup);
    camera->setListener(context);

    // save context in opaque field
    env->SetLongField(thiz, fields.context, (jlong)context.get());
    return NO_ERROR;
}
複製程式碼

android_hardware_Camera_native_setup()方法通過呼叫Camera::connect()方法請求連線CameraService服務。入參中：

  • clientName是通過將clientPackageName從jstring轉換為String16格式得到；
  • Camera::USE_CALLING_UID是定義在Camera.h中的列舉型別，其值為ICameraService::USE_CALLING_UID（同樣為列舉型別，值為-1）。

Camera::connect()位於Camera.cpp中，由此進入到Library層。

三、Library：Camera Client和Camera Service

如上述架構圖中所示，ICameraService.h、ICameraClient.h和ICamera.h三個類定義了Camera的介面和架構，ICameraService.cpp和Camera.cpp兩個檔案用於Camera架構的實現，Camera的具體功能在下層呼叫硬體相關的介面來實現。Camera.h是Camera系統對上層的介面。

具體的，Camera類繼承模板類CameraBase，Camera::connect()呼叫了CameraBase.cpp中的connect()方法。

sp<Camera> Camera::connect(int cameraId, const String16& clientPackageName,
        int clientUid)
{
    return CameraBaseT::connect(cameraId, clientPackageName, clientUid);
}

CameraBase實際上又繼承了IBinder的DeathRecipient內部類，DeathRecipient虛擬繼承自RefBase。RefBase是Android中的引用計數基礎類，其中定義了incStrong、decStrong、incWeak和decWeak等涉及sp/wp的指標操作函式，當然這扯遠了。

複製程式碼 
template <typename TCam>
struct CameraTraits {
};

template <typename TCam, typename TCamTraits = CameraTraits<TCam> >
class CameraBase : public IBinder::DeathRecipient
{
public:
    
    static sp<TCam>      connect(int cameraId,
                                 const String16& clientPackageName,
                                 int clientUid);
    ……
}
複製程式碼 
class DeathRecipient : public virtual RefBase
{
public:
    virtual void binderDied(const wp<IBinder>& who) = 0;
};

回到Camera::connect()的實現上，其中，new TCam(cameraId)生成BnCameraClient物件，BnCameraClient定義在ICameraClient.h檔案中，繼承自模板類BnInterface。getCameraService()方法返回CameraService的服務代理BpCameraService，BpCameraService同樣繼承自模板類BnInterface。然後通過Binder通訊傳送CONNECT命令，當BnCameraService收到CONNECT命令後呼叫CameraService的connect()成員函式來做相應的處理。

複製程式碼 
template <typename TCam, typename TCamTraits>
sp<TCam> CameraBase<TCam, TCamTraits>::connect(int cameraId,
                                               const String16& clientPackageName,
                                               int clientUid)
{
    ALOGV("%s: connect", __FUNCTION__);
    sp<TCam> c = new TCam(cameraId); // BnCameraClient 
    sp<TCamCallbacks> cl = c;
    status_t status = NO_ERROR;
    const sp<ICameraService>& cs = getCameraService(); // BpCameraService

    if (cs != 0) {
        TCamConnectService fnConnectService = TCamTraits::fnConnectService;
        status = (cs.get()->*fnConnectService)(cl, cameraId, clientPackageName, clientUid,
                                             /*out*/ c->mCamera);
    }
    if (status == OK && c->mCamera != 0) {
        c->mCamera->asBinder()->linkToDeath(c);
        c->mStatus = NO_ERROR;
    } else {
        ALOGW("An error occurred while connecting to camera: %d", cameraId);
        c.clear();
    }
    return c;
}
複製程式碼 複製程式碼 
class BnCameraClient: public BnInterface<ICameraClient>
{
public:
    virtual status_t    onTransact( uint32_t code,
                                    const Parcel& data,
                                    Parcel* reply,
                                    uint32_t flags = 0);
};
複製程式碼 複製程式碼 
class BpCameraService: public BpInterface<ICameraService>
{
public:
    BpCameraService(const sp<IBinder>& impl)
        : BpInterface<ICameraService>(impl)
    {
    }
    ……
}
複製程式碼

注：connect()函式在BpCameraService和BnCameraService的父類ICameraService中宣告為純虛擬函式，在BpCameraService和CameraService中分別給出了實現，BpCameraService作為代理類，提供介面給客戶端，真正實現在BnCameraService的子類CameraService中。

在BpCameraService中，connect()函式實現如下：

複製程式碼 
// connect to camera service (android.hardware.Camera)
    virtual status_t connect(const sp<ICameraClient>& cameraClient, int cameraId,
                             const String16 &clientPackageName, int clientUid,
                             /*out*/
                             sp<ICamera>& device)
    {
        Parcel data, reply;
        data.writeInterfaceToken(ICameraService::getInterfaceDescriptor());
        data.writeStrongBinder(cameraClient->asBinder());
        data.writeInt32(cameraId);
        data.writeString16(clientPackageName);
        data.writeInt32(clientUid);
        remote()->transact(BnCameraService::CONNECT, data, &reply); // BpBinder的transact()函式向IPCThreadState例項傳送訊息，通知其有訊息要傳送給binder driver
        if (readExceptionCode(reply)) return -EPROTO;
        status_t status = reply.readInt32();
        if (reply.readInt32() != 0) {
            device = interface_cast<ICamera>(reply.readStrongBinder()); // client端讀出server返回的bind
        }
        return status;
    }
複製程式碼

首先將傳遞過來的Camera物件cameraClient轉換成IBinder型別，將呼叫的引數寫到Parcel（可理解為Binder通訊的管道）中，通過BpBinder的transact()函式傳送訊息，然後由BnCameraService去響應該連線，最後就是等待服務端返回，如果成功則生成一個BpCamera例項。

真正的服務端響應實現在BnCameraService的onTransact()函式中，其負責解包收到的Parcel並執行client端的請求的方法。

複製程式碼 
status_t BnCameraService::onTransact(
    uint32_t code, const Parcel& data, Parcel* reply, uint32_t flags)
{
    switch(code) {
    
    ……
     case CONNECT: {
            CHECK_INTERFACE(ICameraService, data, reply);
            sp<ICameraClient> cameraClient =
                    interface_cast<ICameraClient>(data.readStrongBinder()); // 使用Camera的Binder物件生成Camera客戶代理BpCameraClient例項
              int32_t cameraId = data.readInt32();
            const String16 clientName = data.readString16();
            int32_t clientUid = data.readInt32();
            sp<ICamera> camera;
            status_t status = connect(cameraClient, cameraId,
                    clientName, clientUid, /*out*/camera); // 將生成的BpCameraClient物件作為引數傳遞到CameraService的connect()函式中
              reply->writeNoException();
            reply->writeInt32(status); // 將BpCamera物件以IBinder的形式打包到Parcel中返回
              if (camera != NULL) {
                reply->writeInt32(1);
                reply->writeStrongBinder(camera->asBinder());
            } else {
                reply->writeInt32(0);
            }
            return NO_ERROR;
        } break;
    ……
    }
}
複製程式碼

主要的處理包括：

  1. 通過data中Camera的Binder物件生成Camera客戶代理BpCameraClient例項；
  2. 將生成的BpCameraClient物件作為引數傳遞到CameraService（/frameworks/av/services/camera /libcameraservice/CameraService.cpp）的connect()函式中，該函式會返回一個BpCamera例項；
  3. 將在上述例項物件以IBinder的形式打包到Parcel中返回。

最後，BpCamera例項是通過CameraService::connect()函式返回的。CameraService::connect()實現的核心是呼叫connectHelperLocked()函式根據HAL不同API的版本建立不同的client例項（早期版本中好像沒有connectHelperLocked()這個函式，但功能基本相似）。

複製程式碼 
status_t CameraService::connectHelperLocked(
        /*out*/
        sp<Client>& client,
        /*in*/
        const sp<ICameraClient>& cameraClient,
        int cameraId,
        const String16& clientPackageName,
        int clientUid,
        int callingPid,
        int halVersion,
        bool legacyMode) {

    int facing = -1;
    int deviceVersion = getDeviceVersion(cameraId, &facing);

    if (halVersion < 0 || halVersion == deviceVersion) {
        // Default path: HAL version is unspecified by caller, create CameraClient
        // based on device version reported by the HAL.
        switch(deviceVersion) {
          case CAMERA_DEVICE_API_VERSION_1_0:
            client = new CameraClient(this, cameraClient,
                    clientPackageName, cameraId,
                    facing, callingPid, clientUid, getpid(), legacyMode);
            break;
          case CAMERA_DEVICE_API_VERSION_2_0:
          case CAMERA_DEVICE_API_VERSION_2_1:
          case CAMERA_DEVICE_API_VERSION_3_0:
          case CAMERA_DEVICE_API_VERSION_3_1:
          case CAMERA_DEVICE_API_VERSION_3_2:
            client = new Camera2Client(this, cameraClient,
                    clientPackageName, cameraId,
                    facing, callingPid, clientUid, getpid(), legacyMode);
            break;
          case -1:
            ALOGE("Invalid camera id %d", cameraId);
            return BAD_VALUE;
          default:
            ALOGE("Unknown camera device HAL version: %d", deviceVersion);
            return INVALID_OPERATION;
        }
    } else {
        // A particular HAL version is requested by caller. Create CameraClient
        // based on the requested HAL version.
        if (deviceVersion > CAMERA_DEVICE_API_VERSION_1_0 &&
            halVersion == CAMERA_DEVICE_API_VERSION_1_0) {
            // Only support higher HAL version device opened as HAL1.0 device.
            client = new CameraClient(this, cameraClient,
                    clientPackageName, cameraId,
                    facing, callingPid, clientUid, getpid(), legacyMode);
        } else {
            // Other combinations (e.g. HAL3.x open as HAL2.x) are not supported yet.
            ALOGE("Invalid camera HAL version %x: HAL %x device can only be"
                    " opened as HAL %x device", halVersion, deviceVersion,
                    CAMERA_DEVICE_API_VERSION_1_0);
            return INVALID_OPERATION;
        }
    }

    status_t status = connectFinishUnsafe(client, client->getRemote());
    if (status != OK) {
        // this is probably not recoverable.. maybe the client can try again
        return status;
    }

    mClient[cameraId] = client;
    LOG1("CameraService::connect X (id %d, this pid is %d)", cameraId,
         getpid());

    return OK;
}
複製程式碼

可見，在CAMERA_DEVICE_API_VERSION_2_0之前使用CameraClient進行例項化，之後則採用Camera2Client進行例項化。以CameraClient為例，其initialize()函式如下：

複製程式碼 
status_t CameraClient::initialize(camera_module_t *module) {
    int callingPid = getCallingPid();
    status_t res;

    LOG1("CameraClient::initialize E (pid %d, id %d)", callingPid, mCameraId);

    // Verify ops permissions
    res = startCameraOps();
    if (res != OK) {
        return res;
    }

    char camera_device_name[10];
    snprintf(camera_device_name, sizeof(camera_device_name), "%d", mCameraId);

    mHardware = new CameraHardwareInterface(camera_device_name);
    res = mHardware->initialize(&module->common);
    if (res != OK) {
        ALOGE("%s: Camera %d: unable to initialize device: %s (%d)",
                __FUNCTION__, mCameraId, strerror(-res), res);
        mHardware.clear();
        return res;
    }

    mHardware->setCallbacks(notifyCallback,
            dataCallback,
            dataCallbackTimestamp,
            (void *)(uintptr_t)mCameraId);

    // Enable zoom, error, focus, and metadata messages by default
    enableMsgType(CAMERA_MSG_ERROR | CAMERA_MSG_ZOOM | CAMERA_MSG_FOCUS |
                  CAMERA_MSG_PREVIEW_METADATA | CAMERA_MSG_FOCUS_MOVE);

    LOG1("CameraClient::initialize X (pid %d, id %d)", callingPid, mCameraId);
    return OK;
}
複製程式碼

上述函式中，主要注意以下流程：

  1. 加粗的程式碼CameraHardwareInterface新建了了一個Camera硬體介面，當然，camera_device_name為攝像頭裝置名；
  2. mHardware->initialize(&module->common)呼叫底層硬體的初始化方法；
  3. mHardware->setCallbacks將CamerService處的回撥函式註冊到HAL處。

CameraHardwareInterface定義了Camera的硬體抽象特徵，由此進入到HAL。

四、HAL：CameraHardwareInterface

CameraHardwareInterface的作用在於連結Camera Server和V4L2，通過實現CameraHardwareInterface可以遮蔽不同的driver對Camera Server的影響。CameraHardwareInterface同樣虛擬繼承自RefBase。

複製程式碼 
class CameraHardwareInterface : public virtual RefBase {
public:
    CameraHardwareInterface(const char *name)
    {
        mDevice = 0;
        mName = name;
    }
    ……
}
複製程式碼

CameraHardwareInterface中包含了控制通道和資料通道，控制通道用於處理預覽和視訊獲取的開始/停止、拍攝照片、自動對焦等功能，資料通道通過回撥函式來獲得預覽、視訊錄製、自動對焦等資料。當需要支援新的硬體時就需要繼承於CameraHardwareInterface ，來實現對應的功能。CameraHardwareInterface提供的public方法如下：

1258.tmp

在前一節中，initialize()函式呼叫了mHardware->initialize和mHardware->se

相關推薦

Android原始碼筆記——Camera系統架構

Camera的架構與Android系統的整體架構保持一致，如下圖所示，本文主要從以下四個方面對其進行說明。 Framework：Camera.javaAndroid Runtime：android_hardware_Camera.cppLibrary：Camera Cli

Android原始碼之Camera系統架構

Camera的架構與Android系統的整體架構保持一致，如下圖所示，本文主要從以下四個方面對其進行說明。 Framewo

Android Camera 系統架構原始碼分析(4)---->Camera的資料來源及Camera的管理

Camera的資料來源及Camera的管理  我們接著第3篇，再返回Cam1DeviceBase::startPreview()的(4) mpCamAdapter->startPreview()。在講(4)前我們先來看看(1)onStartPreview(

Android Camera 系統架構原始碼分析(2)---->Camera的startPreview和setPreviewCallback

Camera startPreview流程 上接第一篇，這個過程的主要任務是，如何讀取資料的，讀取的資料是什麼格式，最好能知道是如何去預覽的 上層APP呼叫的是Camera.java的startPreview();，下面列出startPreview的呼叫流程 //Camera

Android 5.0 Camera系統原始碼分析(2)：Camera開啟流程

1. 前言 本文將分析android系統原始碼，從frameworks層到hal層，暫不涉及app層和kernel層。由於某些函式比較複雜，在貼出程式碼時會適當對其進行簡化。本文屬於自己對原始碼的總結，僅僅是貫穿程式碼流程，不會深入分析各個細節。歡迎聯絡討論，QQ：1026

Android 5.0 Camera系統原始碼分析(4)：Camera預覽流程資料流

1. 前言 上一篇講了怎麼讓Camera進入預覽模式，提到了DisplayClient負責顯示影象資料，而CamAdapter負責提供影象資料，這裡主要記錄了CamAdapter怎麼獲取影象，然後DisplayClient怎麼將影象顯示在螢幕上。 2.

Android 5.0 Camera系統原始碼分析(3)：Camera預覽流程控制流

1. 前言 本文分析的是Android系統原始碼，從frameworks層到hal層，記錄了Camera進入預覽模式的重點程式碼，主要為控制流程的程式碼，有關影象buffer的傳遞暫不涉及，硬體平臺基於mt6735。由於某些函式比較複雜，在貼出程式碼時會適當對

Android原始碼筆記--APK解除安裝過程

            Android中應用的解除安裝主要是通過PackageManager中提供的deletePackage()函式來解除安裝，該函式通過IPC呼叫到Pms的deletePackage()函式，繼而呼叫到deletePac

[android原始碼日記]當系統時間小於1970年

我們知道，計算機的時間是從1970年開始的，而java獲取時間的方法System.currentTimeMillis()的返回值也是從0開始的，0就代表1970年一月一日。 那麼這個如果值為負數會怎麼樣？1969年？ 今天在讀SystemServer原始碼的時候

Android8.0 Camera系統架構(一)

隨著Android系統的不斷升級，相機子系統框架也在不斷進化，由最初的API1和HAL1到現在的API2和HAL3，由最初簡單的拍照，錄製到現在的連拍，AI人像；可以說是架構上變動最大最頻繁的子系統。很多裝置仍然依賴相機 HAL1，因此 Android 7.0

Android 菜鳥認知總結——Android初印象之系統架構和app 元件

     1.對Android安裝包的認識，Android的安裝包是apk檔案，裡面包含了你程式碼和資源，它包含了Android應用的所有內容。 2。對Android系統的認識： 什麼是Android系統，由哪些部分構成的。我們需要對系統架構有一定的瞭解，方便以後拓展學習每

【Orange Pi PC試用體驗】11編譯android原始碼筆記

我的筆記和資料全共享在雲盤： 沒有密碼，歡迎下載~~~~~~ 材料： 香橙派：orangepi PC TF卡：用原來的三星8G CLASS 10 TF卡裝LUBUNTU 電源介面卡：1A的帶不動，啟動卡死，改用某A10S盒子的5V/2A電源OK(內徑1.7

Android原始碼筆記--SystemUIVisibility

SystemUIVisibility         &n

Android學習筆記——Android系統整體架構與原始碼目錄

首先要感謝**@劉望舒**大神的部落格，讓我們這些渣渣有途徑更快速地接觸到Android系統層的內容。 本篇部落格主要介紹了Android系統的整體架構及原始碼的目錄結構。 Android系統架構 Android的系統架構可以分為五層，分別是 應用層、應用框架

《Android群英傳》學習筆記之Android體系與系統架構

一、Android系統架構 1.Linux核心層 Android核心系統服務依賴於Linux2.6核心，如安全性、記憶體管理、程序管理、網路協議棧和驅動模型。Linux核心也是作為硬體與軟體棧的抽象層

Android系統架構與系統原始碼目錄

1.Android系統架構 Android系統架構分為五層，從上到下依次是應用層、應用框架層、系統執行庫層、硬體抽象層和Linux核心層。 應用層 系統內建的應用程式以及非系統級的應用程式都是屬於應用層。負責與使用者進行直接互動，通常都是用Java進行開發的。

《Android群英傳》讀書筆記1.Android體系與系統架構

1. Android系統架構 應用層：Application (NDK App & SDK App) 框架層：Framework 庫和執行時：Dalvik(libraries | 執行時編譯)　ART(Android 5.x開始，安裝時編譯) 核

Android 7.0 Camera架構原始碼分析

Android 7.0之前CameraService是在mediaserver程序中註冊的，看下Android 6.0的程式碼： //path: frameworks\av\media\mediaserver\main_mediaserver.cpp int m

Android面試題3之描寫敘述下Android的系統架構

都是 csdn 進行 功能 驅動程序 libraries sso 封裝 rar 描寫敘述下Android的系統架構： Android系統從下往上分為Linux內核層（linux kerner），執行庫(runtime library)，應用程序框架層，

Android 安卓系統架構介紹

圖片 img 多核心 nco 安全性 .com not 狀態 linux android系統架構 從上圖中可以看出，Android系統架構為四層結構，從上層到下層分別是應用程序層、應用程序框架層、系統運行庫層以及Linux內核層，分別介紹如下：