يقدّم الإصدار Android 14 ميزات وواجهات برمجة تطبيقات رائعة للمطوّرين. تساعدك المعلومات التالية في التعرّف على ميزات تطبيقاتك والبدء في استخدام واجهات برمجة التطبيقات ذات الصلة.
للحصول على قائمة مفصّلة بواجهات برمجة التطبيقات التي تمت إضافتها وتعديلها وإزالتها، يُرجى الاطّلاع على تقرير الاختلافات في واجهات برمجة التطبيقات. للحصول على تفاصيل حول واجهات برمجة التطبيقات المضافة، يُرجى الانتقال إلى مرجع واجهات برمجة تطبيقات Android. بالنسبة إلى نظام التشغيل Android 14، ابحث عن واجهات برمجة التطبيقات التي تمت إضافتها في المستوى 34 لواجهة برمجة التطبيقات. للتعرّف على المجالات التي قد تؤثّر فيها تغييرات النظام الأساسي في تطبيقاتك، احرص على الاطّلاع على تغييرات السلوك في الإصدار 14 من نظام التشغيل Android للتطبيقات التي تستهدف الإصدار 14 من نظام التشغيل Android ولجميع التطبيقات.
التوافق مع أسواق عالمية
إعدادات اللغة المخصصة حسب التطبيقات
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 theLocaleConfigfile 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 theresfolders of your app modules and any library module dependencies to determine the locales to include in theLocaleConfigfile.Dynamic updates for an app's
localeConfig: Use thesetOverrideLocaleConfig()andgetOverrideLocaleConfig()methods inLocaleManagerto 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 billion people speak gendered languages: languages where grammatical categories—such as nouns, verbs, adjectives, and prepositions—inflect according to the gender of people and objects you talk to or about. Traditionally, many gendered languages use masculine grammatical gender as the default or generic gender.
Addressing users in the wrong grammatical gender, such as addressing women in masculine grammatical gender, can negatively impact their performance and attitude. In contrast, a UI with language that correctly reflects the user's grammatical gender can improve user engagement and provide a more personalized and natural-sounding user experience.
لمساعدتك في إنشاء واجهة مستخدم تركّز على المستخدم للغات التي تراعي الجنس، يوفّر الإصدار 14 من Android واجهة برمجة التطبيقات Grammatical Inflection API، التي تتيح لك إضافة ميزة مراعاة الجنس النحوي بدون إعادة صياغة تطبيقك.
الإعدادات المفضّلة للمنطقة
تتيح الإعدادات المفضّلة الإقليمية للمستخدمين تخصيص وحدات درجة الحرارة، وهي أول ويوم من الأسبوع وأنظمة الترقيم. أوروبي يعيش في الولايات المتحدة قد يفضلون أن تكون وحدات درجة الحرارة بالدرجة المئوية بدلاً من الفهرنهايت التي تتعامل مع يوم الاثنين على أنه بداية الأسبوع بدلاً من الوضع الافتراضي في الولايات المتحدة الأحد
توفّر قوائم إعدادات Android الجديدة لهذه الإعدادات المفضّلة للمستخدمين مكانًا
يسهل العثور عليه ويكون مركزيًا لتغيير الإعدادات المفضّلة للتطبيقات. هذه
والتفضيلات أيضًا من خلال النسخ الاحتياطي والاستعادة. هناك العديد من واجهات برمجة التطبيقات
الأهداف - مثل
getTemperatureUnit
أو
getFirstDayOfWeek—
منح تطبيقك إذن الوصول للقراءة إلى إعدادات المستخدم المفضّلة، حتى يتمكّن التطبيق من تعديل إعداداته
تعرض المعلومات. يمكنك أيضًا تسجيل
خيار "BroadcastReceiver" مفعَّل
ACTION_LOCALE_CHANGED
لمعالجة تغييرات إعدادات اللغة عند تغيير الإعدادات المفضّلة للمنطقة.
للعثور على هذه الإعدادات، افتح تطبيق "الإعدادات" وانتقِل إلى النظام > اللغات والإدخال > الإعدادات المفضّلة على مستوى المنطقة.
تسهيل الاستخدام
الضبط غير الخطي لحجم الخط بما يصل إلى 200%
Starting in Android 14, the system supports font scaling up to 200%, providing users with additional accessibility options.
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
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:
- Open the Settings app and navigate to Accessibility > Display size and text.
- 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 فائقة للصور
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 upgrades and improves camera extensions, allowing apps to handle longer processing times, which enables improved images using compute-intensive algorithms like low-light photography on supported devices. These features give users an even more robust experience when using camera extension capabilities. Examples of these improvements include:
- Dynamic still capture processing latency estimation provides much more
accurate still capture latency estimates based on the current scene and
environment conditions. Call
CameraExtensionSession.getRealtimeStillCaptureLatency()to get aStillCaptureLatencyobject that has two latency estimation methods. ThegetCaptureLatency()method returns the estimated latency betweenonCaptureStartedandonCaptureProcessStarted(), and thegetProcessingLatency()method returns the estimated latency betweenonCaptureProcessStarted()and the final processed frame being available. - Support for capture progress callbacks so that apps can display the current
progress of long-running, still-capture processing operations. You can check
if this feature is available with
CameraExtensionCharacteristics.isCaptureProcessProgressAvailable, and if it is, you implement theonCaptureProcessProgressed()callback, which has the progress (from 0 to 100) passed in as a parameter. Extension specific metadata, such as
CaptureRequest.EXTENSION_STRENGTHfor dialing in the amount of an extension effect, such as the amount of background blur withEXTENSION_BOKEH.Postview Feature for Still Capture in camera extensions, which provides a less-processed image more quickly than the final image. If an extension has increased processing latency, a postview image could be provided as a placeholder to improve UX and switched out later for the final image. You can check if this feature is available with
CameraExtensionCharacteristics.isPostviewAvailable. Then you can pass anOutputConfigurationtoExtensionSessionConfiguration.setPostviewOutputConfiguration.Support for
SurfaceViewallowing for a more optimized and power-efficient preview render path.Support for tap to focus and zoom during extension usage.
التكبير داخل المستشعر
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. تمثّل هذه الفئة
التنسيق، مثل قناع القناة ومعدّل أخذ العينات وسلوك أداة مزج الصوت. تسمح
الفئة بإرسال الصوت مباشرةً، بدون مزج أو
تعديل مستوى الصوت أو تطبيق تأثيرات المعالجة.
إنتاجية المطوّرين وأدواتهم
مدير بيانات الاعتماد
يضيف الإصدار 14 من Android واجهة برمجة التطبيقات Credential Manager كواجهة برمجة تطبيقات لمنصّة Android، مع إتاحة استخدامها على أجهزة Android 4.4 (المستوى 19 من واجهة برمجة التطبيقات) والإصدارات الأقدم من خلال مكتبة Jetpack باستخدام "خدمات Google Play". يهدف Credential Manager إلى تسهيل تسجيل الدخول للمستخدمين من خلال واجهات برمجة التطبيقات التي تسترجع بيانات الاعتماد وتخزّنها باستخدام موفّري بيانات الاعتماد الذين يضبطهم المستخدم. توفِّر واجهة برمجة التطبيقات Credential Manager طُرق تسجيل دخول متعدّدة، بما في ذلك اسم المستخدم وكلمة المرور ومفاتيح المرور، وحلول تسجيل الدخول الموحَّدة (مثل "تسجيل الدخول باستخدام حساب Google") في واجهة برمجة تطبيقات واحدة.
توفّر مفاتيح المرور العديد من المزايا. على سبيل المثال، تم إنشاء مفاتيح المرور استنادًا إلى المعايير المتّبعة في المجال، ويمكن استخدامها في مختلَف أنظمة التشغيل والمنظومات المتكاملة للمتصفِّحات، ويمكن استخدامها مع كلٍّ من المواقع الإلكترونية والتطبيقات.
لمزيد من المعلومات، يُرجى الاطّلاع على مستندات "مدير بيانات الاعتماد" ومفاتيح المرور ومقالة المدونة حول "مدير بيانات الاعتماد" ومفاتيح المرور.
Health Connect
Health Connect هو مستودع على الجهاز لبيانات الصحة واللياقة البدنية للمستخدم. ويسمح الإعداد للمستخدمين بمشاركة البيانات بين تطبيقاتهم المفضّلة، مع توفير مكان واحد للتحكّم في البيانات التي يريدون مشاركتها مع هذه التطبيقات.
على الأجهزة التي تعمل بإصدارات Android أقدم من Android 14، يمكن تنزيل تطبيق Health Connect من متجر Google Play. بدءًا من الإصدار Android 14، أصبح تطبيق Health Connect جزءًا من المنصة ويتلقّى تحديثات من خلال تحديثات نظام Google Play بدون الحاجة إلى تنزيله بشكل منفصل. وبفضل ذلك، يمكن تحديث Health Connect بشكل متكرّر، ويمكن لتطبيقاتك الاعتماد على توفّر Health Connect على الأجهزة التي تعمل بالإصدار 14 من نظام Android أو الإصدارات الأحدث. يمكن للمستخدمين الوصول إلى Health Connect من خلال "الإعدادات" في أجهزتهم، مع دمج عناصر التحكّم في الخصوصية في إعدادات النظام.
يتضمّن Health Connect العديد من الميزات الجديدة في Android 14، مثل مسار التمارين، ما يتيح للمستخدمين مشاركة مسار تمرينهم الذي يمكن عرضه visually على خريطة. يتم تعريف المسار على أنّه قائمة بالمواقع الجغرافية المحفوظة خلال فترة زمنية معيّنة، ويمكن لتطبيقك إدراج المسارات في جلسات التمارين، وربطها معًا. لضمان حصول المستخدمين على التحكّم الكامل في هذه البيانات الحسّاسة، يجب أن يسمح المستخدمون بمشاركة مسارات فردية مع تطبيقات أخرى.
لمزيد من المعلومات، يُرجى الاطّلاع على مستندات Health Connect والمقالة في المدونة حول الميزات الجديدة في تطبيق "صحة Android".
تعديلات OpenJDK 17
Android 14 continues the work of refreshing Android's core libraries to align with the features in the latest OpenJDK LTS releases, including both library updates and Java 17 language support for app and platform developers.
The following features and improvements are included:
- Updated approximately 300
java.baseclasses to Java 17 support. - Text Blocks, which introduce multi-line string literals to the Java programming language.
- Pattern Matching for instanceof, which allows an object to
be treated as having a specific type in an
instanceofwithout any additional variables. - Sealed classes, which allow you restrict which classes and interfaces can extend or implement them.
Thanks to Google Play system updates (Project Mainline), over 600 million devices are enabled to receive the latest Android Runtime (ART) updates that include these changes. This is part of our commitment to give apps a more consistent, secure environment across devices, and to deliver new features and capabilities to users independent of platform releases.
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
تحسينات على متاجر التطبيقات
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.
حِزم البيانات الوصفية للتطبيق
Starting in Android 14, the Android package installer lets you specify app metadata, such as data safety practices, to include on app store pages such as Google Play.
رصد وقت أخذ المستخدمين لقطات شاشة للجهاز
To create a more standardized experience for detecting screenshots, Android 14 introduces a privacy-preserving screenshot detection API. This API lets apps register callbacks on a per-activity basis. These callbacks are invoked, and the user is notified, when the user takes a screenshot while that activity is visible.
تجربة المستخدم
الإجراءات المخصّصة في ورقة المشاركة والترتيب المحسّن
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.
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.
إتاحة صور متحركة مضمّنة ومخصّصة لإيماءة "الرجوع التنبؤي"
قدّم نظام التشغيل Android 13 إيماءة الرجوع إلى الشاشة الرئيسية التنبؤية من خلال خيار مخصّص للمطوّرين. عند استخدامها في تطبيق متوافق مع تفعيل خيار المطوّر، يؤدي التمرير سريعًا للخلف إلى عرض صورة متحركة تشير إلى أنّ إيماءة الرجوع تؤدي إلى الخروج من التطبيق والرجوع إلى الشاشة الرئيسية.
يتضمّن Android 14 تحسينات متعدّدة وإرشادات جديدة بشأن ميزة "الرجوع التوقّعي":
- يمكنك ضبط
android:enableOnBackInvokedCallback=trueلتفعيل الصور المتحركة في النظام لإيماءة الرجوع إلى الخلف التنبؤية لكل نشاط بدلاً من تفعيلها للتطبيق بأكمله. - أضفنا صورًا متحركة جديدة للنظام لترافق الصورة المتحركة للرجوع إلى الشاشة الرئيسية من Android 13. إنّ الصور المتحركة الجديدة في النظام تعمل على جميع الأنشطة والمهام، ويتم عرضها تلقائيًا بعد نقل البيانات إلى ميزة "الرجوع التلقائي".
- أضفنا رسومًا متحركة جديدة لعناصر Material Design في الجدولَين المعروضَين في أسفل الشاشة والجدولَين الجانبيَين والبحث.
- لقد أنشأنا إرشادات تصميم لإنشاء مؤثرات مخصّصة للصور المتحركة والانتقالات داخل التطبيق.
- لقد أضفنا واجهات برمجة تطبيقات جديدة تتيح استخدام صور متحركة مخصّصة للانتقالات داخل التطبيق:
handleOnBackStartedوhandleOnBackProgressedوhandleOnBackCancelledinOnBackPressedCallbackonBackStartedوonBackProgressedوonBackCancelledinOnBackAnimationCallback- استخدِم
overrideActivityTransitionبدلاً منoverridePendingTransitionللانتقالات التي تستجيب عندما يقلب المستخدم الشاشة للخلف.
في إصدار معاينة Android 14 هذا، تظل جميع ميزات "الترجيع التوقّعي" متاحة فقط من خلال خيار المطوّر. اطّلِع على دليل المطوّر لنقل بيانات تطبيقك إلى ميزة "الرجوع التوقّعي"، بالإضافة إلى دليل المطوّر لإنشاء التحولات المخصّصة داخل التطبيق.
عمليات الإلغاء على مستوى التطبيق من قِبل مصنّع الأجهزة ذات الشاشات الكبيرة
تتيح عمليات إلغاء الإعدادات على مستوى التطبيق لصنّاع الأجهزة تغيير سلوك التطبيقات على الأجهزة ذات الشاشات الكبيرة. على سبيل المثال، عند إلغاء FORCE_RESIZE_APP، يتم توجيه النظام لتغيير حجم التطبيق ليلائم أبعاد العرض (وتجنُّب وضع توافق الحجم) حتى في حال ضبط resizeableActivity="false" في بيان التطبيق.
تهدف عمليات الإلغاء إلى تحسين تجربة المستخدم على الشاشات الكبيرة.
تتيح لك سمات البيان الجديدة إيقاف بعض عمليات إلغاء الشركة المصنّعة للجهاز لتطبيقك.
عمليات إلغاء على مستوى التطبيق لمستخدمي الشاشات الكبيرة
تؤدي عمليات التجاوز لكل تطبيق إلى تغيير سلوك التطبيقات على الأجهزة ذات الشاشات الكبيرة. على سبيل المثال، يمكن للشركة المصنّعة للجهاز OVERRIDE_MIN_ASPECT_RATIO_LARGE إلغاء الإعدادات وضبط نسبة عرض إلى ارتفاع التطبيق على 16:9 بغض النظر عن إعدادات التطبيق.
يتيح الإصدار 1 من الربع الثاني من العام 2021 من نظام التشغيل Android 14 للمستخدمين تطبيق عمليات إلغاء على مستوى كل تطبيق من خلال قائمة إعدادات جديدة على الأجهزة ذات الشاشات الكبيرة.
مشاركة شاشة التطبيق
تتيح ميزة "مشاركة شاشة التطبيق" للمستخدمين مشاركة نافذة تطبيق بدلاً من شاشة الجهاز بالكامل أثناء تسجيل محتوى الشاشة.
عند مشاركة شاشة التطبيق، يتم استبعاد شريط الحالة وشريط التنقّل والإشعارات وعناصر واجهة مستخدم النظام الأخرى من الشاشة المشترَكة. تتم مشاركة محتوى التطبيق المحدّد فقط.
تعمل ميزة "مشاركة شاشة التطبيق" على تحسين الإنتاجية والخصوصية من خلال السماح للمستخدمين بتشغيل تطبيقات متعددة مع حصر مشاركة المحتوى بتطبيق واحد.
ميزة "الرد السريع" المستندة إلى نماذج اللغات الكبيرة في Gboard على هاتف Pixel 8 Pro
On Pixel 8 Pro devices with the December Feature Drop, developers can try out higher-quality smart replies in Gboard powered by on-device Large Language Models (LLMs) running on Google Tensor.
This feature is available as a limited preview for US English in WhatsApp, Line, and KakaoTalk. It requires using a Pixel 8 Pro device with Gboard as your keyboard.
To try it out, first enable the feature in Settings > Developer Options > AiCore Settings > Enable Aicore Persistent.
Next, open a conversation in a supported app to see LLM-powered Smart Reply in Gboard's suggestion strip in response to incoming messages.
الرسومات
يمكن البحث عن المسارات وتعديلها.
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
للمساعدة في استخدام واجهة برمجة التطبيقات Canvas في Android للرسم باستخدام
التسارع في الأجهزة في HardwareBuffer، يوفّر الإصدار 14 من Android HardwareBufferRenderer. واجهة برمجة التطبيقات هذه
عندما تشتمل حالة الاستخدام على التواصل مع النظام
المكون من خلال SurfaceControl لوقت الاستجابة المنخفض
رسم.