یادداشت‌های انتشار مجموعه آزمایشی تصویر دوربین Android 17

نسخه Android 17 شامل تعدادی تغییر در Camera ITS است. این صفحه تغییرات «سیستم تست کالیبراسیون دوربین» را برای Android 17 خلاصه می‌کند.

نسخه‌های Python و بسته

برای Android 17 و نسخه‌های بالاتر، قویاً توصیه می‌کنیم از نرم‌افزار مدیریت بسته برای دسته‌بندی نسخه‌های صحیح بسته‌ها برای ایجاد محیط مجازی برای توسعه نسخه Android استفاده کنید. برای نمونه ابزار مدیریت بسته که بیشتر بسته‌های موردنیاز را مدیریت می‌کند، به اسناد Python 3 برای venv مراجعه کنید.

برای ایجاد محیط مجازی با venv، این مراحل را دنبال کنید:

  1. نصب Python 3.14 و python3-venv

    sudo apt install python3.14
    sudo apt install python3.14-venv python3.14-dev
    
  2. تأیید نصب پایتون

    python3.14 --version
    
  3. به‌روزرسانی apt و نصب pip

    sudo apt-get update
    sudo apt install python3-pip
    
  4. ایجاد محیط مجازی

    python3.14 -m venv its_android17_env
    
  5. فعال کردن محیط مجازی

    source its_android17_env/bin/activate
    
  6. ‫its_android17_env.txt را با فهرست بسته‌های موردنیاز ایجاد کنید

    ImageIO==2.37.4
    PyYAML==6.0.3
    contourpy==1.3.3
    cycler==0.12.1
    fonttools==4.61.1
    imagecodecs==2025.11.11
    kiwisolver==1.5.0
    lazy-loader==0.*
    matplotlib==3.10.9
    mobly==1.13.1
    mobly-android-partner-tools==1.5.2
    networkx==3.4.2
    numpy==2.5.3
    opencv-python==5.0.0.*
    packaging==26.0.0
    pillow==12.3
    portpicker==1.6.0
    protobuf<=7.37.0
    psutil==5.9.4
    pyparsing==3.2.3
    pyserial==3.5.0
    python-dateutil==2.9.0.post0
    pyudev==0.22.0
    scikit-image==0.26.0
    scipy==1.18.1
    six==1.17.0
    snippet-uiautomator==1.1.2
    tifffile==2026.2.16
    
  7. نصب بسته‌های فهرست‌شده its_android17_env.txt

    pip install -r its_android17_env.txt
    
  8. نصب FFmpeg نسخه 7.0.2 با بارگیری‌کننده ffmpeg

    pip install ffmpeg-downloader
    ffdl install 7.0.2
    

    (اختیاری) اگر بارگیری‌کننده ffmpeg کار نمی‌کند، نسخه ۷.۰.۲ را از یک منبع آنلاین بارگیری کنید.

  9. نصب FFmpeg نسخه ۷.۰.۲ را درستی‌سنجی کنید

    ffmpeg -version
    

    اگر نسخه FFmpeg هنوز ۷.۰.۲ نیست، پیوند نمادین باینری‌ها را ایجاد کنید (براساس جایی که PATH ذخیره می‌کنید its_android17_env، آن را تنظیم کنید).

    ln -s ~/.local/share/ffmpeg-downloader/ffmpeg/ffmpeg ~/PATH/its_android17_env/bin/ffmpeg
    ln -s ~/.local/share/ffmpeg-downloader/ffmpeg/ffprobe ~/PATH/its_android17_env/bin/ffprobe
    
  10. درستی‌سنجی کنید کدام بسته‌ها نصب شده‌اند

    pip freeze
    
  11. (اختیاری) فرمان غیرفعال کردن محیط:

    deactivate
    

صحنه‌های جدید یا به‌روزرسانی‌شده

‫Android 17 صحنه‌های زیر را معرفی می‌کند:

صحنه شرح
gen2_chart صحنه جدیدی که از test_chart_gen2 جدول کاغذی به‌جای صحنه‌های رایانه لوحی استفاده می‌کند تا یکپارچگی و قابلیت اطمینان آزمون را بهبود دهد . ‫test_chart_gen2 در scene_ip نیز استفاده می‌شود.
wide_gamut صحنه جدید برای رایانه‌های لوحی با پشتیبانی از گستره رنگ وسیع.
3 از نشانگرهای ArUco برای تشخیص نمودار استفاده می‌کند تا سرعت و قابلیت اطمینان را بهبود بخشد. این تغییر محدوده وسیع‌تر «زاویه دید» و فاصله‌های دیده‌شده در آزمایش دوربین تله را دربرمی‌گیرد. استفاده از نشانگرها باعث دور زدن منطق اندازه‌گیری و بهینه‌ساز فعلی می‌شود. برای اطلاعات بیشتر، صحنه ۳ را ببینید.
flash آزمایش‌ها را می‌توان بااستفاده از تجهیزات Gen2 اجرا کرد.

آزمایش‌های جدید

‫Android 17 آزمایش‌های زیر را معرفی می‌کند:

صحنه نام آزمایش شرح
gen2_chart test_tonemap_sequence تأیید می‌کند که پارامتر android.tonemap.mode برای توزیع یکنواخت و غیریکنواخت به‌درستی اعمال شده است.
ip test_jca_jpegr_ip تأیید می‌کند که تفاوت تراز سفید بین پیش‌نمایش JPEG_R JCA و تصاویر ضبط‌شده در محدوده آستانه انتخابی باشد.
wide_gamut test_display_p3 تأیید می‌کند که برون‌داد P3 JPEG دارای نمایه icc مناسب است و بیش‌از ۱ درصد از رنگ‌های خارج از گستره sRGB را دربرمی‌گیرد.

آزمایش‌های بازسازی‌شده

در Android 17، آزمایش‌های زیر برای افزایش پوشش آزمایش و گروه‌بندی منطقی‌تر آزمایش‌ها بازسازی شده است:

صحنه نام آزمایش شرح
1_2 tests_param_tonemap_mode نسخه scene1_2 از آزمایش tests_param_tonemap_mode منسوخ شده است و فقط در دستگاه‌های دارای Android 16 یا پایین‌تر استفاده می‌شود.
1_2 test_tonemap_sequence نسخه scene1_2 از آزمون test_tonemap_sequence فقط در دستگاه‌های دارای Android 16 یا پایین‌تر استفاده می‌شود.
2_b test_yuv_jpeg_capture_sameness آستانه تفاوت RMS کاهش می‌یابد تا اطمینان حاصل شود که هرگاه اختلاف رنگ مربوط به رنگ‌مایه منجر به تفاوت قابل‌مشاهده برای کاربر شود، به‌عنوان خطا علامت‌گذاری می‌شود.
3 test_edge_enhancement از نشانگرهای ArUco برای تأیید حضور و جهت استفاده می‌کند. این روش تشخیص پایداری را برای دوربین‌های از «فوق‌عریض» (UW) تا برنامه‌های تله ارائه می‌دهد.
3 test_flip_mirror از نشانگرهای ArUco برای تأیید حضور و جهت استفاده می‌کند. وضعیت PASS فقط درصورتی اعطا می‌شود که همه نشانگرها شناسایی و به‌درستی تراز شوند. آزمایش برای نمودارهای جابه‌جا یا چرخانده‌شده ناموفق است.
3 test_landscape_to_portrait نمودار scene3 را با نشانگرهای ArUco بار می‌کند.
3 test_lens_movement_report از نشانگرهای ArUco برای تأیید حضور و جهت استفاده می‌کند. این روش تشخیص پایداری را برای دوربین‌های «فوق‌عریض» (UW) تا برنامه‌های تله ارائه می‌دهد.
4 test_multi_camera_alignment اگر دستگاه فقط یک دوربین عریض و یک دوربین «سوپر تله» داشته باشد، از آزمایش صرف‌نظر می‌شود.
flash test_auto_flash آزمایش را به‌روز می‌کند تا تأیید کند که فلاش در سطوح مختلف بزرگ‌نمایی به‌درستی کار می‌کند.
ip test_default_jca_ip بررسی‌های موجود را الزامی می‌کند: تفاوت روشنایی، تفاوت تراز سفیدی، و عدم تطابق «زاویه دید». بررسی not_yet_mandated برای تفاوت در پرداز رنگ بین برنامه دوربین پیش‌فرض و ضبط‌های JCA اضافه می‌کند.

فعالیت‌های آزمایشی جداشده

در Android 17، برای آزمایش موازی در دستگاه‌های جداگانه، آزمایش‌های ITS دوربین به دو فعالیت «درستی‌سنج CTS»‏، Camera ITS Test و Camera ITS Sensor Fusion Rig Test، تقسیم می‌شود. فعالیت Camera ITS Sensor Fusion Rig Test حاوی صحنه‌های feature_combination و sensor_fusion است و می‌تواند به‌طور جداگانه در دستگاه آزمایش ترکیب حسگر اجرا شود. جدول زیر صحنه‌های موجود در هر فعالیت را شرح می‌دهد.

فعالیت صحنه‌ها شرح
Camera ITS Test gen2_chart، scene0، scene1_1، scene1_2، scene1_3، scene2_a، scene2_b، scene2_c، scene2_d، scene2_e، scene2_f، scene2_g، scene3، scene4، scene5، scene6، scene8، scene9، scene_flash، scene_hdr، scene_ip، scene_low_light، scene_video، wide_gamut صحنه‌هایی که در دستگاه آزمایش ITS-in-a-box دوربین و دستگاه آزمایش Gen2 اجرا می‌شوند.
Camera ITS Sensor Fusion Rig Test feature_combination، sensor_fusion صحنه‌هایی که در دستگاه آزمایش ترکیب حسگر اجرا می‌شوند.

آزمایش‌های منسوخ

در Android 17، آزمایش‌های زیر به‌دلیل پوشش عملکرد آزمایش توسط آزمایش‌های دیگر منسوخ شده‌اند:

صحنه نام آزمایش شرح
sensor_fusion test_video_stabilization این آزمایش منسوخ شده است. درعوض از test_video_stabilization_jca استفاده کنید.

به‌روزرسانی‌های تجهیزات نسل دوم

در Android 17، آزمایش‌های زیر به دستگاه Gen2 منتقل شده است:

صحنه نام آزمایش شرح
7 test_multi_camera_switch آزمایش به تنظیمات تجهیزات نسل ۲ منتقل شد تا از نمودار نسل ۲ برای بررسی‌های AE و AWB استفاده شود. این گذار، هدف‌های مبتنی بر رایانه لوحی را با نمودارهای فیزیکی جایگزین می‌کند تا جلوه‌های مُوَیر را حذف کند و محیط آزمایشی پایدارتر و قابل‌تولید مجددی ارائه دهد.
flash all tests آزمایش‌های scene_flash در دستگاه gen2 انتقال داده شد. کاربران می‌توانند این آزمایش‌ها را در محیط دستگاه ترکیب حسگر یا دستگاه نسل ۲ اجرا کنند.
sensor_fusion all tests آزمایش‌های sensor_fusion به دستگاه نسل ۲ منتقل شد. کاربران می‌توانند این آزمایش‌ها را در محیط دستگاه ترکیب حسگر یا دستگاه نسل ۲ اجرا کنند.

قبل‌از اجرای آزمایش‌های انتقال‌یافته، نمودار تجهیزات Gen2 را که در Android 17 معرفی شده است نصب کنید. نمودار جدید به شما امکان می‌دهد همه آزمایش‌های ترکیب حسگر را در دستگاه Gen2 اجرا کنید. برای اطلاعات بیشتر، راه‌اندازی نمودار برای آزمایش را ببینید.

وضعیت آزمون جدید: قبول*

‫۱۷ وضعیت آزمایش PASS* را برای شناسایی آزمایش‌های با حداقل امتیاز قبولی معرفی می‌کند. برای اطلاعات بیشتر، به آزمایش‌های با حداقل امتیاز قبولی (وضعیت آزمایش: قبولی*) مراجعه کنید.

بهبودهای مقیاس‌بندی نمودار

‫Android 17 پارامتر chart_scaling را در config.yml برای TEST_BED_TABLET_SCENES اضافه می‌کند تا مشکلات مقیاس‌بندی نمودار را با دستگاه‌های دوربین تله با میدان دید (FoV) عریض‌تر مدیریت کند. برای اطلاعات بیشتر، به بهبودهای مقیاس‌بندی نمودار: پارامتر chart_scaling مراجعه کنید.

رایانه لوحی جدید برای پشتیبانی از آزمایش گستره رنگ

برای Android 17 و بالاتر، Samsung Galaxy Tab S10 FE (هر دو مدل Wi-Fi و 5G) در فهرست مجاز رایانه لوحی قرار دارد. ‫Samsung Galaxy Tab S10 FE برای نمایش نمودارهای آزمون طیف رنگ گسترده و همچنین همه صحنه‌های مبتنی بر رایانه لوحی تأیید شده است. برای درستی‌سنجی اینکه دستگاهتان در فهرست مجاز قرار دارد، از فرمان adb shell getprop ro.product.device استفاده کنید تا مطابقت شناسه محصول با مقدار فهرست‌شده در فهرست زیر را تأیید کنید.

    'gts10fewifi',  # Samsung Galaxy Tab S10 FE
    'gts10fe',  # Samsung Galaxy Tab S10 FE 5G

ارسال نتیجه تجمیعی برای تأیید ساخت

‫Android 17 فرایندی را برای ارسال نتایج تست تجمیعی Camera ITS برای تأیید ساخت بااستفاده از فایل APK به‌روزشده CTS Verifier معرفی می‌کند.

سیستم انبوهش جدید بهبودهای زیر را ارائه می‌دهد:

  • صرفه‌جویی در زمان: نیاز به اجرای مکرر صحنه‌های موفق در دستگاه‌هایی که اثر انگشت ساخت یکسانی دارند را ازبین می‌برد.
  • اجرای موازی: امکان آزمایش هم‌زمان چندین صحنه را در چندین دستگاه فراهم می‌کند، به‌شرطی که اثر انگشت ساخت یکسانی داشته باشند.
  • گزارش‌دهی ساده‌شده: امکان تجمیع نتایج آزمایش از چندین گزارش «درستی‌سنج CTS» (جمع‌آوری‌شده از اجراهای آزمایشی یا دستگاه‌های مختلف) در یک ارسال واحد و یکپارچه را فراهم می‌کند.

برای اطلاعات بیشتر، به ارسال نتایج آزمایش تجمیعی مراجعه کنید.