برنامه‌هایی که برای «سازگار» آماده هستند در همه ابعاد فیزیکی به‌صورت تمام‌صفحه اجرا می‌شوند و پشتیبانی پایه برای دستگاه‌های ورودی خارجی ارائه می‌دهند، و به کاربران امکان می‌دهند جریان‌های کاری مهم را در هر دستگاهی تکمیل کنند.
رهنمودها
تجربه‌ای پایدار و کاربردی در همه ضرایب شکل ارائه دهید.
پیکربندی و تداوم
| شناسه دستورالعمل | شناسه‌های آزمایش | شرح |
|---|---|---|
| Config_Changes | T-Config_Orientation، T-Config_State |
برنامه کل ناحیه نمایش دردسترس را پر می‌کند—کل صفحه‌نمایش یا، در حالت چندپنجره‌ای، پنجره برنامه. محتوا از فضای نمایش دردسترس سرریز نمی‌کند. برنامه حالت جعبه‌ای ندارد؛ در حالت سازگاری اجرا نمی‌شود. برنامه تغییرات پیکربندی را مدیریت می‌کند و وضعیت خود را هنگام عبور دستگاه از تغییرات پیکربندی مانند چرخش دستگاه، تا کردن و باز کردن، و تغییر اندازه پنجره در حالت‌های پنجره‌بندی رایانه‌ای و صفحهٔ دونیمه حفظ یا بازیابی می‌کند، برای مثال:
|
| Config_Combinations | T-Config_Combinations | برنامه ترکیب تغییرات پیکربندی را اداره می‌کند، مثلاً تغییر اندازه پنجره و سپس چرخش دستگاه، یا چرخش و سپس تا کردن یا باز کردن دستگاه. |
حالت چندپنجره‌ای و ازسرگیری چندگانه
| شناسه دستورالعمل | شناسه‌های آزمایش | شرح |
|---|---|---|
| Multi-Window_Functionality | T-Multi-Window_Functionality | برنامه در حالت چندپنجره‌ای کاملاً کاربردی است. پشتیبانی از حالت چندپنجره‌ای را ببینید. توجه: برنامه‌های Unity باید در Unity Long Term Support (LTS) نسخه ۲۰۱۹ یا جدیدتر باشند. درستی‌سنجی حالت چندپنجره‌ای را ببینید. |
| ازسرگیری چندگانه | T-Multi-Window_Focus، T-Multi-Window_Resources |
برنامه به‌طور کامل از ازسرگیری چندگانه پشتیبانی می‌کند. وقتی برنامه در کانون توجه نیست، میانای کاربر خود را به‌روز می‌کند (به پخش رسانه ادامه می‌دهد، پیام‌های جدید را اضافه می‌کند، پیشرفت بارگیری را به‌روز می‌کند، و غیره). علاوه‌براین، برنامه ازدست رفتن منابع انحصاری مانند دوربین و میکروفون را در سناریوهای چندپنجره‌ای مدیریت می‌کند. چرخه حیات فعالیت در حالت چندپنجره‌ای را ببینید. |
پیش‌نمای دوربین و نگاشت تصویر رسانه
| شناسه دستورالعمل | شناسه‌های آزمایش | شرح |
|---|---|---|
| Camera_Preview | T-Camera_Preview | برنامه پیش‌نمایش دوربین را در جهت‌های افقی و عمودی، حالت‌های تاشده و بازشده دستگاه، و حالت چندپنجره‌ای ارائه می‌دهد. پیش‌نمایش نسبت درستی دارد و در جهت صحیح است. |
| Media_Projection | T-Media_Projection | برنامه از پروجکشن رسانه در جهت‌های افقی و عمودی، حالت‌های تاشده و بازشده دستگاه، و حالت چندپنجره‌ای پشتیبانی می‌کند. پروجکشن به‌درستی تناسب دارد و در جهت صحیح است. |
صفحه‌کلید، موشواره، و پد لمسی
| شناسه دستورالعمل | شناسه‌های آزمایش | شرح |
|---|---|---|
| Keyboard_Input | T-Keyboard_Input | برنامه از ورودی نوشتاری بااستفاده از صفحه‌کلید خارجی پشتیبانی می‌کند و هنگام متصل یا قطع شدن صفحه‌کلید خارجی، بدون راه‌اندازی مجدد برنامه، بین صفحه‌کلید فیزیکی و مجازی جابه‌جا می‌شود. |
| Mouse_Trackpad_Basic | T-Mouse_Trackpad_Basic | برنامه از تعاملات پایه موشواره یا پد لمسی پشتیبانی می‌کند:
|
قلم
| شناسه دستورالعمل | شناسه‌های آزمایش | شرح |
|---|---|---|
| Stylus_Basic | T-Stylus_Basic | برنامه پشتیبانی پایه برای رایانه‌های لوحی، دستگاه‌های تاشو، و رایانه‌های رومیزی مجهز به قلم ارائه می‌دهد. از قلم می‌توان برای انتخاب و دستکاری عناصر میانای کاربر، ازجمله پیمایش در فهرست‌ها، انتخابگرها، و سایر محتواهای پیمایش‌شدنی استفاده کرد. قلم را در سازگاری ورودی در صفحه‌نمایش‌های بزرگ ببینید. توجه: ورودی قلم لمسی پایه همانند ورودی لمسی است که Android کاملاً از آن پشتیبانی می‌کند. ورودی قلم پایه به‌طور خودکار برای همه برنامه‌ها فعال می‌شود و به توسعه خاصی نیاز ندارد. |
| Stylus_Text_Input | T-Stylus_Text_Input | در Android 14 (سطح ای‌پی‌آی ۳۴) و نسخه‌های بالاتر، کاربران می‌توانند بااستفاده از قلم در فیلدهای ورودی نوشتار بنویسند و نوشتار را ویرایش کنند. در Googlebook و ChromeOS نسخه ۱۱۴ و بالاتر، می‌توان از قلم برای نوشتن و ویرایش نوشتار در فیلدهای ورودی نوشتار در مؤلفه‌های توجه: در Android 14 و نسخه‌های بالاتر، مؤلفه‌های |
آزمایش‌ها
برای تأیید اینکه برنامه‌تان در همه ابعاد فیزیکی کار می‌کند، آزمایش‌های زیر را اجرا کنید.
پیکربندی و تداوم
| شناسه آزمایش | شناسه‌های دستورالعمل | شرح |
|---|---|---|
| T-Config_Orientation | Config_Changes | بررسی کنید که برنامه حالت جعبه‌ای نداشته باشد و در حالت سازگاری در جهت عمودی، جهت افقی، حالت چندپنجره‌ای، یا زمانی که دستگاه تاشو با صفحه‌نمایش بزرگ در جهت عمودی یا افقی باز می‌شود، اجرا نشود. بررسی کنید که همه محتوا در فضای نمایش دردسترس جا شود.
اندازه پنجره برنامه را در حالت چندپنجره‌ای، ازجمله حالت‌های «صفحه دونیمه» و «پنجره‌بندی رایانه‌ای»، تغییر دهید. در رایانه‌های رومیزی، پنجره برنامه را کوچک و بازیابی کنید، پنجره برنامه را بزرگ و بازیابی کنید. تأیید کنید که برنامه جهت مناسب را اتخاذ می‌کند و وضعیت را در همه اندازه‌های پنجره حفظ می‌کند. توجه: در دستگاهی با صفحه‌نمایش بزرگ (sw >= 600 dp) که Android 12 (سطح میانای برنامه‌سازی کاربردی ۳۱) یا بالاتر را اجرا می‌کند آزمایش کنید تا مطمئن شوید دستگاه از موارد زیر پشتیبانی می‌کند:
|
| T-Config_State | Config_Changes | در هر صفحه برنامه که محتوای پیمایشی، محتوای پخش مداوم، یا فیلدهای ورودی نوشتار دارد، کارهای زیر را انجام دهید:
دستگاه را بین جهت‌های افقی و عمودی بچرخانید، دستگاه را تا و باز کنید (درصورت وجود)، و اندازه پنجره برنامه را در حالت چندپنجره‌ای تغییر دهید. کمینه و بازیابی کردن پنجره برنامه در دستگاه‌های رایانه‌ای؛ بیشینه و بازیابی کردن پنجره برنامه. موارد زیر را به‌تأیید برسانید:
|
| T-Config_Combinations | Config_Combinations | از هر صفحه برنامه، ترکیبی از چرخاندن دستگاه بین جهت‌های افقی و عمودی، تا کردن و باز کردن دستگاه (درصورت وجود)، و تغییر اندازه پنجره برنامه در حالت چندپنجره‌ای را انجام دهید. |
حالت چندپنجره‌ای و ازسرگیری چندگانه
| شناسه آزمایش | شناسه‌های دستورالعمل | شرح |
|---|---|---|
| T-Multi-Window_Functionality | Multi-Window_Functionality | برنامه را در حالت چندپنجره‌ای باز کنید. بررسی کنید که برنامه در همه اندازه‌های پنجره، جهت‌های دستگاه، و حالت‌های دستگاه تاشو کاملاً فعال باشد. اندازه پنجره برنامه را در هر جهت تغییر دهید. برای دستگاه‌های تاشو، دستگاه را در هر جهت تا کنید و باز کنید. برنامه‌های Unity برنامه‌ای غیراز برنامه Unity خودتان را باز کنید. به صفحه موارد اخیر بروید. نماد برنامه را انتخاب کنید و برنامه را در حالت صفحه دونیمه قرار دهید. برنامه Unity را باز کنید، این برنامه باید در حالت صفحهٔ دونیمه در کنار یا زیر برنامه اول راه‌اندازی شود. برای پنهان کردن جفت برنامه، به صفحه اصلی بروید. به صفحه موارد اخیر بروید. جفت برنامه صفحهٔ تقسیم‌شده را که شامل برنامه Unity شما است انتخاب کنید. بررسی کنید که برنامه Unity فعالیت خود را ازسر می‌گیرد و چیدمان برنامه در پنجره صفحهٔ تقسیم‌شده درست است و همه عناصر میانای کاربر دردسترس هستند. |
| T-Multi-Window_Focus | ازسرگیری چندگانه | برنامه را باز کنید و فرایندی را شروع کنید که به‌طور مداوم برنامه را به‌روز می‌کند، مثلاً پخش ویدیو. برنامه دیگری را باز کنید و برنامه جدید را به برنامه متمرکز بالا تبدیل کنید. بررسی کنید که برنامه غیرمتمرکز همچنان محتوایش را به‌روز می‌کند (برای مثال، ویدیو همچنان پخش می‌شود). |
| T-Multi-Window_Resources | ازسرگیری چندگانه | در برنامه، دوربین را باز کنید یا از میکروفون استفاده کنید. برنامه دیگری را باز کنید و برنامه جدید را به برنامه متمرکز بالا تبدیل کنید. بررسی کنید که برنامه غیرمتمرکز دوربین یا میکروفون را واگذار کرده باشد. برنامه اصلی را به برنامه با بالاترین تمرکز تبدیل کنید. بررسی کنید که برنامه دوباره به دوربین یا میکروفون دسترسی پیدا کرده باشد. |
پیش‌نمای دوربین و نگاشت تصویر رسانه
| شناسه آزمایش | شناسه‌های دستورالعمل | شرح |
|---|---|---|
| T-Camera_Preview | Camera_Preview | برنامه را در حالت تمام‌صفحه و چندپنجره‌ای باز کنید. دوربین را از داخل برنامه راه‌اندازی کنید. دستگاه را بین جهت‌های افقی و عمودی بچرخانید. برای دستگاه‌های تاشو، دستگاه را در هر جهت تا کنید و باز کنید. در حالت چندپنجره‌ای، اندازه پنجره برنامه را تغییر دهید. تأیید کنید که پیش‌نمایش دوربین در همه حالت‌های دستگاه و اندازه‌های پنجره، جهت و نسبت‌های مناسبی داشته باشد. |
| T-Media_Projection | Media_Projection | برنامه را در حالت تمام‌صفحه و چندپنجره‌ای باز کنید. پخش رسانه را شروع کنید. دستگاه را بین جهت‌های افقی و عمودی بچرخانید. برای دستگاه‌های تاشو، دستگاه را در هر جهت تا کنید و باز کنید. در حالت چندپنجره‌ای، اندازه پنجره برنامه را تغییر دهید. بررسی کنید که پخش رسانه در همه حالت‌های دستگاه و اندازه‌های پنجره، در جهت و نسبت‌های مناسب باشد. |
صفحه‌کلید، موشواره، و پد لمسی
| شناسه آزمایش | شناسه‌های دستورالعمل | شرح |
|---|---|---|
| T-Keyboard_Input | Keyboard_Input | برای هر صفحه برنامه که فیلد ورودی نوشتار دارد، صفحه‌کلید خارجی به دستگاه متصل کنید و با صفحه‌کلید خارجی و صفحه‌کلید مجازی نوشتار وارد کنید. صفحه‌کلید خارجی را جدا کنید و نوشتار را با صفحه‌کلید مجازی وارد کنید. |
| T-Mouse_Trackpad_Basic | Mouse_Trackpad_Basic | برای هر صفحه برنامه، موشواره و پد لمسی را به دستگاه متصل کنید. تعاملات پایه موشواره و پد لمسی را انجام دهید:
|
قلم
| شناسه آزمایش | شناسه‌های دستورالعمل | شرح |
|---|---|---|
| T-Stylus_Basic | Stylus_Basic | بااستفاده از قلم، در برنامه پیمایش کنید، عناصر میانای کاربر را انتخاب کنید، در فهرست‌ها و انتخابگرها پیمایش کنید، و به‌طور کلی با برنامه تعامل برقرار کنید. |
| T-Stylus_Text_Input | Stylus_Text_Input | در Android نسخه ۱۴ (سطح میانای برنامه‌سازی کاربردی ۳۴) و بالاتر، بااستفاده از قلم، نوشتار را در فیلدهای ورودی نوشتار وارد و ویرایش کنید. صفحه‌کلید نرم‌افزاری نباید ظاهر شود. در Googlebook و ChromeOS نسخه M114 یا بالاتر، نوشتار را در فیلدهای ورودی نوشتار در WebView وارد و ویرایش کنید. |