برنامه‌هایی که برای «سازگار» آماده هستند در همه ابعاد به‌صورت تمام‌صفحه اجرا می‌شوند و پشتیبانی پایه برای دستگاه‌های ورودی خارجی ارائه می‌دهند، و به کاربران امکان می‌دهند تا جریان‌های کاری مهم را در هر دستگاهی تکمیل کنند.
رهنمودها
تجربه‌ای پایدار و کاربردی در همه ضرایب شکل ارائه دهید.
پیکربندی و تداوم
| شناسه دستورالعمل | شناسه‌های آزمایشی | شرح |
|---|---|---|
| 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 نسخه M114 و بالاتر، می‌توان از قلم برای نوشتن و ویرایش نوشتار در فیلدهای ورودی نوشتار در مؤلفه‌های توجه: در 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 14 (سطح میانای برنامه‌سازی کاربردی ۳۴) و بالاتر، بااستفاده از قلم در فیلدهای ورودی نوشتار، نوشتار وارد و ویرایش کنید. صفحه‌کلید نرم‌افزاری نباید ظاهر شود. در Googlebook و ChromeOS نسخه M114 یا بالاتر، نوشتار را در فیلدهای ورودی نوشتار در WebView وارد و ویرایش کنید. |