بوكيه الكاميرا هو تأثير سطحي لعمق المجال تم إنشاؤه عن طريق طمس أجزاء من المشهد بحيث لا يتم التركيز عليها. في كاميرات الأجهزة المحمولة، يتم تحقيق البوكيه باستخدام معلومات العمق التي تم الحصول عليها من الرؤية المجسمة من كاميرتين أو من الثنائيات الضوئية المزدوجة (PDs) لكاميرا واحدة.
بدءًا من Android 11، يدعم نظام Android الأساسي تطبيقات bokeh ويوفر واجهات برمجة التطبيقات لإتاحة الميزة لتطبيقات الطرف الثالث.
تطبيق
لإتاحة ميزة بوكيه الكاميرا على جهازك، قم بما يلي:
الإعلان عن
ANDROID_CONTROL_AVAILABLE_EXTENDED_SCENE_MODE_MAX_SIZES
:هذه العلامة بتنسيق مصفوفة صفية مكونة من ثلاثة أعداد صحيحة، وكل صف بتنسيق
{mode, maxWidth, maxHeight}
. بالإضافة إلى{ANDROID_CONTROL_EXTENDED_SCENE_MODE_DISABLED, 0, 0}
، يجب أن يدرج HAL للكاميرا أيضًا أحد الوضعينANDROID_CONTROL_EXTENDED_SCENE_MODE_BOKEH_STILL_CAPTURE
وANDROID_CONTROL_EXTENDED_SCENE_MODE_BOKEH_CONTINUOUS
أو كليهما مع الحد الأقصى لأحجام البث المقابلة لهما.أعلن عن
ANDROID_CONTROL_AVAILABLE_EXTENDED_SCENE_MODE_ZOOM_RATIO_RANGES
:هذه العلامة بتنسيق مصفوفة
{minZoomRatio, maxZoomRatio}
، والتي تحتوي على جميع نطاقات نسبة التكبير/التصغير لوضع المشهد الموسع الممكّن، بنفس الترتيب كما فيANDROID_CONTROL_AVAILABLE_EXTENDED_SCENE_MODE_MAX_SIZES
. نطاق التكبير/التصغير[1.0, 1.0]
يعني أن التكبير/التصغير غير مدعوم.قم بتعبئة
ANDROID_CONTROL_USE_EXTENDED_SCENE_MODE
فيANDROID_CONTROL_AVAILABLE_MODES
.
لكي يقوم أحد التطبيقات بتشغيل ميزة البوكيه، يجب أن يقوم التطبيق بتعيين ANDROID_CONTROL_MODE
على ANDROID_CONTROL_USE_EXTENDED_SCENE_MODE
و ANDROID_CONTROL_EXTENDED_SCENE_MODE
على أحد أوضاع المشهد الموسعة المدعومة. لاحظ أن تطبيق البوكيه قد يؤدي إلى استهلاك إضافي للذاكرة بسبب حساب الاستريو.
إذا كان وضع المشهد الممتد المدعوم لا يمكن تطبيقه على كل إطار ويؤدي إلى تأخيرات غير متوقعة عند تمكينه/تعطيله، فقم بتضمين ANDROID_CONTROL_EXTENDED_SCENE_MODE
في ANDROID_REQUEST_AVAILABLE_SESSION_KEYS
. وفي الوقت نفسه، قم بتطبيق طريقة ICameraDeviceSession::isReconfigurationRequired()
لتجنب إعادة التكوين لأوضاع المشهد الموسعة التي لا تتطلب إعادة التكوين.
تصديق
للتحقق من صحة ميزة bokeh على جهازك، قم بتشغيل اختبارات CTS وVTS وCTS Verifier التالية:
-
CtsCameraTestCases
-
VtsHalCameraProviderV2_4TargetTest
-
CameraBokehTest
في أداة التحقق من CTS
بوكيه الكاميرا هو تأثير سطحي لعمق المجال تم إنشاؤه عن طريق طمس أجزاء من المشهد بحيث لا يتم التركيز عليها. في كاميرات الأجهزة المحمولة، يتم تحقيق البوكيه باستخدام معلومات العمق التي تم الحصول عليها من الرؤية المجسمة من كاميرتين أو من الثنائيات الضوئية المزدوجة (PDs) لكاميرا واحدة.
بدءًا من Android 11، يدعم نظام Android الأساسي تطبيقات bokeh ويوفر واجهات برمجة التطبيقات لإتاحة الميزة لتطبيقات الطرف الثالث.
تطبيق
لإتاحة ميزة بوكيه الكاميرا على جهازك، قم بما يلي:
الإعلان عن
ANDROID_CONTROL_AVAILABLE_EXTENDED_SCENE_MODE_MAX_SIZES
:هذه العلامة بتنسيق مصفوفة صفية مكونة من ثلاثة أعداد صحيحة، وكل صف بتنسيق
{mode, maxWidth, maxHeight}
. بالإضافة إلى{ANDROID_CONTROL_EXTENDED_SCENE_MODE_DISABLED, 0, 0}
، يجب أن يدرج HAL للكاميرا أيضًا أحد الوضعينANDROID_CONTROL_EXTENDED_SCENE_MODE_BOKEH_STILL_CAPTURE
وANDROID_CONTROL_EXTENDED_SCENE_MODE_BOKEH_CONTINUOUS
أو كليهما مع الحد الأقصى لأحجام البث المقابلة لهما.أعلن عن
ANDROID_CONTROL_AVAILABLE_EXTENDED_SCENE_MODE_ZOOM_RATIO_RANGES
:هذه العلامة بتنسيق مصفوفة
{minZoomRatio, maxZoomRatio}
، والتي تحتوي على جميع نطاقات نسبة التكبير/التصغير لوضع المشهد الموسع الممكّن، بنفس الترتيب كما فيANDROID_CONTROL_AVAILABLE_EXTENDED_SCENE_MODE_MAX_SIZES
. نطاق التكبير/التصغير[1.0, 1.0]
يعني أن التكبير/التصغير غير مدعوم.قم بتعبئة
ANDROID_CONTROL_USE_EXTENDED_SCENE_MODE
فيANDROID_CONTROL_AVAILABLE_MODES
.
لكي يقوم أحد التطبيقات بتشغيل ميزة البوكيه، يجب أن يقوم التطبيق بتعيين ANDROID_CONTROL_MODE
على ANDROID_CONTROL_USE_EXTENDED_SCENE_MODE
و ANDROID_CONTROL_EXTENDED_SCENE_MODE
على أحد أوضاع المشهد الموسعة المدعومة. لاحظ أن تطبيق البوكيه قد يؤدي إلى استهلاك إضافي للذاكرة بسبب حساب الاستريو.
إذا كان وضع المشهد الممتد المدعوم لا يمكن تطبيقه على كل إطار ويؤدي إلى تأخيرات غير متوقعة عند تمكينه/تعطيله، فقم بتضمين ANDROID_CONTROL_EXTENDED_SCENE_MODE
في ANDROID_REQUEST_AVAILABLE_SESSION_KEYS
. وفي الوقت نفسه، قم بتطبيق طريقة ICameraDeviceSession::isReconfigurationRequired()
لتجنب إعادة التكوين لأوضاع المشهد الموسعة التي لا تتطلب إعادة التكوين.
تصديق
للتحقق من صحة ميزة bokeh على جهازك، قم بتشغيل اختبارات CTS وVTS وCTS Verifier التالية:
-
CtsCameraTestCases
-
VtsHalCameraProviderV2_4TargetTest
-
CameraBokehTest
في أداة التحقق من CTS