نظرة عامة على الميزات وواجهات برمجة التطبيقات

يقدّم الإصدار Android 14 ميزات وواجهات برمجة تطبيقات رائعة للمطوّرين. تساعدك المقالات التالية في معرفة المزيد عن ميزات تطبيقاتك والبدء باستخدام واجهات برمجة التطبيقات ذات الصلة.

للحصول على قائمة مفصّلة لواجهات برمجة التطبيقات التي تمت إضافتها أو تعديلها أو إزالتها، يُرجى الاطّلاع على تقرير اختلافات واجهة برمجة التطبيقات. للاطّلاع على تفاصيل عن واجهات برمجة التطبيقات المُضافة، يُرجى الانتقال إلى مرجع واجهات برمجة تطبيقات Android. بالنسبة إلى الإصدار 14 من نظام التشغيل Android، ابحث عن واجهات برمجة التطبيقات التي تمت إضافتها في المستوى 34 لواجهة برمجة التطبيقات. للتعرّف على المجالات التي قد تؤثر فيها تغييرات النظام الأساسي في تطبيقاتك، احرص على الاطّلاع على تغييرات السلوك في الإصدار 14 من Android للتطبيقات التي تستهدف الإصدار 14 ولجميع التطبيقات.

التوافق مع أسواق عالمية

إعدادات اللغة المخصّصة حسب التطبيقات

Android 14 expands on the per-app language features that were introduced in Android 13 (API level 33) with these additional capabilities:

  • Automatically generate an app's localeConfig: Starting with Android Studio Giraffe Canary 7 and AGP 8.1.0-alpha07, you can configure your app to support per-app language preferences automatically. Based on your project resources, the Android Gradle plugin generates the LocaleConfig file and adds a reference to it in the final manifest file, so you no longer have to create or update the file manually. AGP uses the resources in the res folders of your app modules and any library module dependencies to determine the locales to include in the LocaleConfig file.

  • Dynamic updates for an app's localeConfig: Use the setOverrideLocaleConfig() and getOverrideLocaleConfig() methods in LocaleManager to dynamically update your app's list of supported languages in the device's system settings. Use this flexibility to customize the list of supported languages per region, run A/B experiments, or provide an updated list of locales if your app utilizes server-side pushes for localization.

  • App language visibility for input method editors (IMEs): IMEs can utilize the getApplicationLocales() method to check the language of the current app and match the IME language to that language.

Grammatical Inflection API

يتحدّث 3 مليارات شخص لغات جنسانية: وهي لغات تتغيّر فيها فئاتها النحوية، مثل الأسماء والأفعال والصفات وحروف الجر، وفقًا للجنس الذي يحدّده الشخص أو الشيء الذي تتحدث عنه. في العادة، تستخدم العديد من اللغات التي تراعي الجنس النوع النحوي الذكوري كجنس تلقائي أو عام.

يمكن أن يؤدي استخدام الجنس النحوي غير الصحيح للمستخدمين، مثل مخاطبة النساء باستخدام الجنس النحوي للذكور، إلى التأثير سلبًا في أدائهم وسلوكهم. في المقابل، يمكن أن يؤدي استخدام واجهة مستخدم تتضمّن لغة تمثل بشكلٍ صحيح الجنس النحوي للمستخدم إلى تحسين تفاعله مع التطبيق وتوفير تجربة أكثر تخصيصًا وطبيعية.

لمساعدتك في إنشاء واجهة مستخدم تركّز على المستخدم للغات التي تراعي الجنس، يوفّر الإصدار 14 من Android واجهة برمجة التطبيقات Grammatical Inflection API، التي تتيح لك إضافة ميزة مراعاة الجنس النحوي بدون إعادة صياغة تطبيقك.

الإعدادات المفضّلة للمنطقة

Regional preferences enable users to personalize temperature units, the first day of the week, and numbering systems. A European living in the United States might prefer temperature units to be in Celsius rather than Fahrenheit and for apps to treat Monday as the beginning of the week instead of the US default of Sunday.

New Android Settings menus for these preferences provide users with a discoverable and centralized location to change app preferences. These preferences also persist through backup and restore. Several APIs and intents—such as getTemperatureUnit and getFirstDayOfWeek— grant your app read access to user preferences, so your app can adjust how it displays information. You can also register a BroadcastReceiver on ACTION_LOCALE_CHANGED to handle locale configuration changes when regional preferences change.

To find these settings, open the Settings app and navigate to System > Languages & input > Regional preferences.

Regional preferences screen in Android system settings.
Temperature options for regional preferences in Android system settings.

تسهيل الاستخدام

الضبط غير الخطّي لحجم الخط ليصل إلى %200

Starting in Android 14, the system supports font scaling up to 200%, providing low-vision users with additional accessibility options that align with Web Content Accessibility Guidelines (WCAG).

To prevent large text elements on screen from scaling too large, the system applies a nonlinear scaling curve. This scaling strategy means that large text doesn't scale at the same rate as smaller text. Nonlinear font scaling helps preserve the proportional hierarchy between elements of different sizes while mitigating issues with linear text scaling at high degrees (such as text being cut off or text that becomes harder to read due to an extremely large display sizes).

Test your app with nonlinear font scaling

Enable the maximum font size in a device's accessibility settings to test your app.

If you already use scaled pixels (sp) units to define text sizing, then these additional options and scaling improvements are applied automatically to the text in your app. However, you should still perform UI testing with the maximum font size enabled (200%) to ensure that your app applies the font sizes correctly and can accommodate larger font sizes without impacting usability.

To enable 200% font size, follow these steps:

  1. Open the Settings app and navigate to Accessibility > Display size and text.
  2. For the Font size option, tap the plus (+) icon until the maximum font size setting is enabled, as shown in the image that accompanies this section.

Use scaled pixel (sp) units for text-sizes

Remember to always specify text sizes in sp units. When your app uses sp units, Android can apply the user's preferred text size and scale it appropriately.

Don't use sp units for padding or define view heights assuming implicit padding: with nonlinear font scaling sp dimensions might not be proportional, so 4sp + 20sp might not equal 24sp.

Convert scaled pixel (sp) units

Use TypedValue.applyDimension() to convert from sp units to pixels, and use TypedValue.deriveDimension() to convert pixels to sp. These methods apply the appropriate nonlinear scaling curve automatically.

Avoid hardcoding equations using Configuration.fontScale or DisplayMetrics.scaledDensity. Because font scaling is nonlinear, the scaledDensity field is no longer accurate. The fontScale field should be used for informational purposes only because fonts are no longer scaled with a single scalar value.

Use sp units for lineHeight

Always define android:lineHeight using sp units instead of dp, so the line height scales along with your text. Otherwise, if your text is sp but your lineHeight is in dp or px, it doesn't scale and looks cramped. TextView automatically corrects the lineHeight so that your intended proportions are preserved, but only if both textSize and lineHeight are defined in sp units.

الكاميرا والوسائط

دقة HDR الفائقة للصور

An illustration of Standard Dynamic Range (SDR) versus High Dynamic Range (HDR) image quality.

Android 14 adds support for High Dynamic Range (HDR) images that retain more of the information from the sensor when taking a photo, which enables vibrant colors and greater contrast. Android uses the Ultra HDR format, which is fully backward compatible with JPEG images, allowing apps to seamlessly interoperate with HDR images, displaying them in Standard Dynamic Range (SDR) as needed.

Rendering these images in the UI in HDR is done automatically by the framework when your app opts in to using HDR UI for its Activity Window, either through a manifest entry or at runtime by calling Window.setColorMode(). You can also capture compressed Ultra HDR still images on supported devices. With more colors recovered from the sensor, editing in post can be more flexible. The Gainmap associated with Ultra HDR images can be used to render them using OpenGL or Vulkan.

ميزات التكبير والتركيز والعرض اللاحق والمزيد في إضافات الكاميرا

يُجري نظام Android 14 ترقيات وتحسينات على إضافات الكاميرا، ويسمح للتطبيقات بمعالجة الصور لفترات أطول، ما يؤدي إلى تحسين الصور باستخدام خوارزميات كثيفة الاستخدام للمعالجة، مثل التصوير في الإضاءة المنخفضة على الأجهزة المتوافقة. وتوفّر هذه الميزات للمستخدمين تجربة أكثر فعالية عند استخدام إمكانات توسيع نطاق الكاميرا. تشمل أمثلة هذه التحسينات ما يلي:

  • يقدّم تقدير وقت الاستجابة لمعالجة الصور الثابتة الديناميكية مزيدًا من الدقة في تقدير وقت الاستجابة لالتقاط الصور الثابتة استنادًا إلى المشهد الحالي وظروف التصوير. استخدِم دالة CameraExtensionSession.getRealtimeStillCaptureLatency() للحصول على عنصر StillCaptureLatency يتضمّن طريقتَين لتقدير وقت الاستجابة. تُرجع الطريقة getCaptureLatency() وقت الاستجابة المقدَّر بين onCaptureStarted و onCaptureProcessStarted()، وتُرجع الطريقة getProcessingLatency() وقت الاستجابة المقدَّر بين onCaptureProcessStarted() ووقت توفُّر الإطار النهائي الذي تمت معالجته.
  • إتاحة عمليات استدعاء لعرض مستوى التقدّم في الالتقاط كي تتمكّن التطبيقات من عرض المستوى الحالي للتقدّم في عمليات معالجة الصور الثابتة التي تستغرق وقتًا طويلاً يمكنك التحقّق مما إذا كانت هذه الميزة متاحة مع CameraExtensionCharacteristics.isCaptureProcessProgressAvailable، وإذا كانت متاحة، يمكنك تنفيذ دالة callback الخاصة بتسجيل التقدّم onCaptureProcessProgressed()، والتي تم تمرير التقدّم (من 0 إلى 100) إليها كمَعلمة.

  • البيانات الوصفية الخاصة بالإضافة، مثل CaptureRequest.EXTENSION_STRENGTH للاتصال برقم هاتفي مقدار تأثير الإضافة، مثل مقدار التمويه في الخلفية باستخدام EXTENSION_BOKEH

  • ميزة "العرض اللاحق" لالتقاط الصور في إضافات الكاميرا، والتي تقدّم صورة تمّت معالجتها بشكل أقلّ بسرعة أكبر من الصورة النهائية إذا كانت إضافة الصور تزيد من وقت الاستجابة في المعالجة، يمكن تقديم صورة ما بعد المشاهدة كعنصر بدلٍ لتحسين تجربة المستخدم واستبدالها لاحقًا بالصورة النهائية. يمكنك معرفة ما إذا كانت هذه الميزة متاحة باستخدام CameraExtensionCharacteristics.isPostviewAvailable. بعد ذلك، يمكنك تمرير OutputConfiguration إلى ExtensionSessionConfiguration.setPostviewOutputConfiguration.

  • إتاحة استخدام SurfaceView للاستفادة من مسار عرض معاينة أكثر فعالية من حيث الطاقة

  • إتاحة ميزة "النقر للتركيز" والتكبير/التصغير أثناء استخدام الإضافة

التكبير/التصغير داخل المستشعر

When REQUEST_AVAILABLE_CAPABILITIES_STREAM_USE_CASE in CameraCharacteristics contains SCALER_AVAILABLE_STREAM_USE_CASES_CROPPED_RAW, your app can use advanced sensor capabilities to give a cropped RAW stream the same pixels as the full field of view by using a CaptureRequest with a RAW target that has stream use case set to CameraMetadata.SCALER_AVAILABLE_STREAM_USE_CASES_CROPPED_RAW. By implementing the request override controls, the updated camera gives users zoom control even before other camera controls are ready.

صوت USB بدون فقدان الجودة

يتيح نظام Android 14 استخدام تنسيقات الصوت غير القابل للفقد لتوفير تجارب رائعة تتعلّق بالصوت عبر سماعات الرأس السلكية USB. يمكنك الاستعلام عن جهاز USB للحصول على سمات أداة المزج المفضّلة، وتسجيل مستمع للتغييرات فيسمات أداة المزج المفضّلة، وضبط سمات أداة المزج باستخدام فئة AudioMixerAttributes. تمثّل هذه الفئة التنسيق، مثل قناع القناة ومعدّل أخذ العينات وسلوك أداة مزج الصوت. تسمح الفئة بإرسال الصوت مباشرةً، بدون مزج أو تعديل مستوى الصوت أو تطبيق تأثيرات المعالجة.

أدوات المطوّرين وإنتاجيتهم

مدير بيانات الاعتماد

Android 14 adds Credential Manager as a platform API, with additional support back to Android 4.4 (API level 19) devices through a Jetpack Library using Google Play services. Credential Manager aims to make sign-in easier for users with APIs that retrieve and store credentials with user-configured credential providers. Credential Manager supports multiple sign-in methods, including username and password, passkeys, and federated sign-in solutions (such as Sign-in with Google) in a single API.

Passkeys provide many advantages. For example, passkeys are built on industry standards, can work across different operating systems and browser ecosystems, and can be used with both websites and apps.

For more information, see the Credential Manager and passkeys documentation and the blogpost about Credential Manager and passkeys.

Health Connect

Health Connect is an on-device repository for user health and fitness data. It allows users to share data between their favorite apps, with a single place to control what data they want to share with these apps.

On devices running Android versions prior to Android 14, Health Connect is available to download as an app on the Google Play store. Starting with Android 14, Health Connect is part of the platform and receives updates through Google Play system updates without requiring a separate download. With this, Health Connect can be updated frequently, and your apps can rely on Health Connect being available on devices running Android 14 or higher. Users can access Health Connect from the Settings in their device, with privacy controls integrated into the system settings.

Users can get started using Health Connect without a separate app download on devices running Android 14 or higher.
Users can control which apps have access to their health and fitness data through system settings.

Health Connect includes several new features in Android 14, such as exercise routes, allowing users to share a route of their workout which can be visualized on a map. A route is defined as a list of locations saved within a window of time, and your app can insert routes into exercise sessions, tying them together. To ensure that users have complete control over this sensitive data, users must allow sharing individual routes with other apps.

For more information, see the Health Connection documentation and the blogpost on What's new in Android Health.

تعديلات OpenJDK 17

يواصل نظام التشغيل Android 14 العمل على تحديث المكتبات الأساسية في Android لمواءمتها مع الميزات في أحدث إصدارات OpenJDK LTS، بما في ذلك تحديثات مكتبة ودعم لغة Java 17 لمطوّري التطبيقات والمنصات.

تشمل الميزات والتحسينات التالية:

  • تم تعديل 300 فئة تقريبًا من فئات java.base لتتوافق مع Java 17.
  • كتل النصوص التي تُعرِض سلاسل نصية حرفية متعددة الأسطر في لغة البرمجة Java
  • مطابقة الأنماط لـ instanceof، التي تسمح بالتعامل مع عنصر على أنّه يملك نوعًا معيّنًا في instanceof بدون أي متغيّرات إضافية
  • الفئات المُغلقة، التي تتيح لك فرض قيود على الفئات والواجهات التي يمكنها توسيع نطاقها أو تنفيذها

بفضل تحديثات نظام Google Play (Project Mainline)، تم تفعيل أكثر من 600 مليون جهاز لتلقّي آخر تحديثات Android Runtime (ART) التي تتضمن هذه التغييرات. يأتي ذلك في إطار التزامنا بتوفير بيئة أكثر اتساقًا وأمانًا للتطبيقات على جميع الأجهزة، وتقديم ميزات و إمكانات جديدة للمستخدمين بغض النظر عن إصدارات المنصة.

Java وOpenJDK هما علامتان تجاريتان مسجَّلتان لشركة Oracle و/أو شركائها التابعين.

تحسينات على متاجر التطبيقات

Android 14 introduces several PackageInstaller APIs that allow app stores to improve their user experience.

Request install approval before downloading

Installing or updating an app might require user approval. For example, when an installer making use of the REQUEST_INSTALL_PACKAGES permission attempts to install a new app. In prior Android versions, app stores can only request user approval after APKs are written to the install session and the session is committed.

Starting with Android 14, the requestUserPreapproval() method lets installers request user approval before committing the install session. This improvement lets an app store defer downloading any APKs until after the installation has been approved by the user. Furthermore, once a user has approved installation, the app store can download and install the app in the background without interrupting the user.

Claim responsibility for future updates

The setRequestUpdateOwnership() method allows an installer to indicate to the system that it intends to be responsible for future updates to an app it is installing. This capability enables update ownership enforcement, meaning that only the update owner is permitted to install automatic updates to the app. Update ownership enforcement helps to ensure that users receive updates only from the expected app store.

Any other installer, including those making use of the INSTALL_PACKAGES permission, must receive explicit user approval in order to install an update. If a user decides to proceed with an update from another source, update ownership is lost.

Update apps at less-disruptive times

App stores typically want to avoid updating an app that is actively in use because this leads to the app's running processes being killed, which potentially interrupts what the user was doing.

Starting with Android 14, the InstallConstraints API gives installers a way to ensure that their app updates happen at an opportune moment. For example, an app store can call the commitSessionAfterInstallConstraintsAreMet() method to make sure that an update is only committed when the user is no longer interacting with the app in question.

Seamlessly install optional splits

With split APKs, features of an app can be delivered in separate APK files, rather than as a monolithic APK. Split APKs allow app stores to optimize the delivery of different app components. For example, app stores might optimize based on the properties of the target device. The PackageInstaller API has supported splits since its introduction in API level 22.

In Android 14, the setDontKillApp() method allows an installer to indicate that the app's running processes shouldn't be killed when new splits are installed. App stores can use this feature to seamlessly install new features of an app while the user is using the app.

حِزم البيانات الوصفية للتطبيقات

اعتبارًا من الإصدار Android 14، يتيح لك أداة تثبيت حِزم Android تحديد البيانات الوصفية للتطبيق، مثل ممارسات أمان البيانات، لتضمينها في صفحات متجر التطبيقات، مثل Google Play.

رصد الحالات التي يأخذ فيها المستخدمون لقطات شاشة للأجهزة

لتوفير تجربة أكثر اتساقًا لرصد لقطات الشاشة، يقدّم Android 14 واجهة برمجة تطبيقات لرصد لقطات الشاشة تحافظ على الخصوصية. تتيح واجهة برمجة التطبيقات هذه للتطبيقات تسجيل عمليات ردّ الاتصال على أساس كل نشاط. يتمّ استدعاء هذه callbacks، ويتمّ إشعار المستخدم عندما يأخذ مستخدم لقطة شاشة أثناء ظهور هذا النشاط.

تجربة المستخدم

الإجراءات المخصّصة في "لوحة المشاركة" والترتيب المحسَّن

Android 14 updates the system sharesheet to support custom app actions and more informative preview results for users.

Add custom actions

With Android 14, your app can add custom actions to the system sharesheet it invokes.

Screenshot of custom actions on the sharesheet.

Improve ranking of Direct Share targets

Android 14 uses more signals from apps to determine the ranking of the direct share targets to provide more helpful results for the user. To provide the most useful signal for ranking, follow the guidance for improving rankings of your Direct Share targets. Communication apps can also report shortcut usage for outgoing and incoming messages.

Direct Share row in the sharesheet, as shown by 1

إتاحة الصور المتحركة المضمّنة والمخصّصة لإيماءة الرجوع إلى الخلف التنبؤية

فيديو: الصور المتحركة لميزة "الترجيع التوقّعي"

قدّم نظام التشغيل Android 13 إيماءة الرجوع إلى الشاشة الرئيسية التنبؤية من خلال خيار مخصّص للمطوّرين. عند استخدامها في تطبيق متوافق مع تفعيل خيار المطوّر، يؤدي التمرير سريعًا للخلف إلى عرض صورة متحركة تشير إلى أنّ إيماءة الرجوع تؤدي إلى الخروج من التطبيق والرجوع إلى الشاشة الرئيسية.

يتضمّن Android 14 تحسينات متعدّدة وإرشادات جديدة بشأن ميزة "الرجوع التوقّعي":

في إصدار معاينة Android 14 هذا، تظل جميع ميزات "الترجيع التوقّعي" متاحة فقط من خلال خيار المطوّر. اطّلِع على دليل المطوّر لنقل بيانات تطبيقك إلى ميزة "الرجوع التوقّعي"، بالإضافة إلى دليل المطوّر لإنشاء التحولات المخصّصة داخل التطبيق.

عمليات إلغاء الإعدادات التي تحدّدها الشركة المصنّعة للأجهزة ذات الشاشات الكبيرة لكل تطبيق

تتيح عمليات إلغاء الإعدادات على مستوى التطبيق لصنّاع الأجهزة تغيير سلوك التطبيقات على الأجهزة ذات الشاشات الكبيرة. على سبيل المثال، عند إلغاء FORCE_RESIZE_APP، يتم توجيه النظام لتغيير حجم التطبيق ليلائم أبعاد العرض (وتجنُّب وضع توافق الحجم) حتى في حال ضبط resizeableActivity="false" في بيان التطبيق.

تهدف عمليات الإلغاء إلى تحسين تجربة المستخدم على الشاشات الكبيرة.

تتيح لك سمات البيان الجديدة إيقاف بعض عمليات إلغاء الشركة المصنّعة للجهاز لتطبيقك.

إعدادات المستخدم على الشاشة الكبيرة لكل تطبيق

تؤدي عمليات التجاوز لكل تطبيق إلى تغيير سلوك التطبيقات على الأجهزة ذات الشاشات الكبيرة. على سبيل المثال، يمكن للشركة المصنّعة للجهاز OVERRIDE_MIN_ASPECT_RATIO_LARGE إلغاء الإعدادات وضبط نسبة عرض إلى ارتفاع التطبيق على 16:9 بغض النظر عن إعدادات التطبيق.

يتيح الإصدار 1 من الربع الثاني من العام 2021 من نظام التشغيل Android 14 للمستخدمين تطبيق عمليات إلغاء على مستوى كل تطبيق من خلال قائمة إعدادات جديدة على الأجهزة ذات الشاشات الكبيرة.

مشاركة شاشة التطبيق

تتيح ميزة "مشاركة شاشة التطبيق" للمستخدمين مشاركة نافذة تطبيق بدلاً من شاشة الجهاز بالكامل أثناء تسجيل محتوى الشاشة.

عند مشاركة شاشة التطبيق، يتم استبعاد شريط الحالة وشريط التنقّل والإشعارات وعناصر واجهة مستخدم النظام الأخرى من الشاشة المشترَكة. تتم مشاركة محتوى التطبيق المحدّد فقط.

تعمل ميزة "مشاركة شاشة التطبيق" على تحسين الإنتاجية والخصوصية من خلال السماح للمستخدمين بتشغيل تطبيقات متعددة مع حصر مشاركة المحتوى بتطبيق واحد.

ميزة "الرد السريع" المستندة إلى نموذج اللغة الكبيرة في Gboard على هاتف Pixel 8 Pro

على أجهزة Pixel 8 Pro التي تم تثبيت حزمة ميزات شهر كانون الأول (ديسمبر) عليها، يمكن للمطوّرين تجربة ردود سريعة بجودة أعلى في Gboard، وذلك باستخدام نماذج لغوية كبيرة (LLM) على الجهاز تعمل على معالج Google Tensor.

تتوفّر هذه الميزة في إصدار تجريبي محدود باللغة الإنجليزية (الولايات المتحدة) في WhatsApp وLine وKakaoTalk. تتطلّب الميزة استخدام جهاز Pixel 8 Pro مع Gboard ك keyboard.

لتجربة هذه الميزة، عليك أولاً تفعيلها من خلال الانتقال إلى الإعدادات > خيارات المطوّرين > إعدادات AICore > تفعيل ميزة Aicore Persistent.

بعد ذلك، افتح محادثة في تطبيق متوافق للاطّلاع على ميزة "الرد السريع" المستندة إلى نموذج اللغة الكبيرة في شريط اقتراحات Gboard استجابةً للرسائل الواردة.

تستخدم Gboard نماذج لغوية كبيرة على الجهاز لتقديم ردود سريعة ذكية وعالية الجودة.

الرسومات

يمكن البحث في المسارات وإنشاء خطوط بينية لها.

Path API هي آلية فعّالة ومرنة ل إنشاء الرسومات المتجهّة وعرضها، مع إمكانية رسم خطوط أو ملء مسار أو إنشاء مسار من أجزاء خطية أو منحنيات ثنائية أو ثلاثية الحدود، أو تنفيذ عمليات منطقية للحصول على أشكال أكثر تعقيدًا، أو كل ذلك في الوقت نفسه. ويتمثل أحد القيود في القدرة على معرفة ما هو موجود بالفعل في كائن "مسار"، وتكون العناصر الداخلية للكائن معتمة للمتصلين بعد إنشائه.

لإنشاء Path، يمكنك استدعاء طرق مثل moveTo() وlineTo() و cubicTo() لإضافة شرائح مسار. ولكن لم تكن هناك طريقة للسؤال عن الأجزاء في هذا المسار، لذلك يجب عليك الاحتفاظ بهذه المعلومات في وقت الإنشاء.

بدءًا من Android 14، يمكنك طلب البحث عن المسارات لمعرفة ما بداخلها. عليك أولاً الحصول على كائن PathIterator باستخدام واجهة برمجة تطبيقات Path.getPathIterator:

Kotlin

val path = Path().apply {
    moveTo(1.0f, 1.0f)
    lineTo(2.0f, 2.0f)
    close()
}
val pathIterator = path.pathIterator

Java

Path path = new Path();
path.moveTo(1.0F, 1.0F);
path.lineTo(2.0F, 2.0F);
path.close();
PathIterator pathIterator = path.getPathIterator();

بعد ذلك، يمكنك استدعاء الدالة PathIterator لتكرار الشرائح الواحد تلو الآخر، واسترداد جميع البيانات اللازمة لكل شريحة. يستخدم هذا المثال كائنات PathIterator.Segment التي تحزم البيانات نيابةً عنك:

Kotlin

for (segment in pathIterator) {
    println("segment: ${segment.verb}, ${segment.points}")
}

Java

while (pathIterator.hasNext()) {
    PathIterator.Segment segment = pathIterator.next();
    Log.i(LOG_TAG, "segment: " + segment.getVerb() + ", " + segment.getPoints());
}

لدى PathIterator أيضًا إصدار غير مخصّص من next() يمكنك تمريره في مخزن مؤقت للاحتفاظ ببيانات النقاط.

من حالات الاستخدام المهمة لطلب بيانات Path هي الاستقراء. على سبيل المثال، قد ترغب في إضافة تأثير متحرك (أو تحويل) بين مسارين مختلفين. لتبسيط حالة الاستخدام هذه بشكل أكبر، يتضمّن Android 14 أيضًا طريقة interpolate() في Path. بافتراض أنّ المسارَين لهما البنية الداخلية نفسها، تنشئ الطريقة interpolate() Path جديدة مع تلك النتيجة المضمَّنة. يعرض هذا المثال مسارًا يكون شكله في منتصف الطريق (تداخل خطي بنسبة 0.5) بين path وotherPath:

Kotlin

val interpolatedResult = Path()
if (path.isInterpolatable(otherPath)) {
    path.interpolate(otherPath, .5f, interpolatedResult)
}

Java

Path interpolatedResult = new Path();
if (path.isInterpolatable(otherPath)) {
    path.interpolate(otherPath, 0.5F, interpolatedResult);
}

تتيح مكتبة graphics-path في Jetpack واجهات برمجة تطبيقات مشابهة لإصدارات Android الأقدم أيضًا.

شبكات مخصّصة تتضمّن برامج تشويش قمة وجزء

Android has long supported drawing triangle meshes with custom shading, but the input mesh format has been limited to a few predefined attribute combinations. Android 14 adds support for custom meshes, which can be defined as triangles or triangle strips, and can, optionally, be indexed. These meshes are specified with custom attributes, vertex strides, varying, and vertex and fragment shaders written in AGSL.

The vertex shader defines the varyings, such as position and color, while the fragment shader can optionally define the color for the pixel, typically by using the varyings created by the vertex shader. If color is provided by the fragment shader, it is then blended with the current Paint color using the blend mode selected when drawing the mesh. Uniforms can be passed into the fragment and vertex shaders for additional flexibility.

أداة عرض المخزن المؤقت للأجهزة في Canvas

To assist in using Android's Canvas API to draw with hardware acceleration into a HardwareBuffer, Android 14 introduces HardwareBufferRenderer. This API is particularly useful when your use case involves communication with the system compositor through SurfaceControl for low-latency drawing.