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

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

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

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

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

Android 14 扩展了 Android 13(API 级别 33)中引入的按应用设定语言功能,并包含以下额外功能:

  • 自动生成应用的 localeConfig:从 Android Studio Giraffe Canary 7 和 AGP 8.1.0-alpha07 开始,您可以将应用配置为自动支持各应用语言偏好设定。Android Gradle 插件会根据您的项目资源生成 LocaleConfig 文件,并在最终清单文件中添加对该文件的引用,这样您就不再需要手动创建或更新该文件。AGP 使用应用模块的 res 文件夹中的资源以及任何库模块依赖项来确定要在 LocaleConfig 文件中添加的语言区域。

  • 动态更新应用的 localeConfig:使用 LocaleManager 方法中的 setOverrideLocaleConfig()getOverrideLocaleConfig() 可以在设备的系统设置中动态更新应用的受支持语言列表。有了这种灵活性,您可以按区域自定义支持的语言列表、运行 A/B 实验,或者如果您的应用通过服务器端推送进行本地化,则可以提供更新后的语言区域列表。

  • 输入法 (IME) 的应用语言可见性:IME 可以利用 getApplicationLocales() 方法查看当前应用的语言,并将 IME 语言与该语言进行匹配。

Grammatical Inflection API

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

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

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

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

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

توفّر قوائم إعدادات Android الجديدة لهذه الإعدادات المفضّلة للمستخدمين مكانًا يسهل العثور عليه ويكون مركزيًا لتغيير الإعدادات المفضّلة للتطبيقات. هذه والتفضيلات أيضًا من خلال النسخ الاحتياطي والاستعادة. هناك العديد من واجهات برمجة التطبيقات الأهداف - مثل getTemperatureUnit أو getFirstDayOfWeek— منح تطبيقك إذن الوصول للقراءة إلى إعدادات المستخدم المفضّلة، حتى يتمكّن التطبيق من تعديل إعداداته تعرض المعلومات. يمكنك أيضًا تسجيل خيار "BroadcastReceiver" مفعَّل ACTION_LOCALE_CHANGED لمعالجة تغييرات إعدادات اللغة عند تغيير الإعدادات المفضّلة للمنطقة.

للعثور على هذه الإعدادات، افتح تطبيق "الإعدادات" وانتقِل إلى النظام > اللغات والإدخال > الإعدادات المفضّلة على مستوى المنطقة.

شاشة الإعدادات المفضّلة على مستوى المنطقة في إعدادات نظام Android
خيارات درجة الحرارة للإعدادات المفضّلة على مستوى المنطقة في إعدادات نظام Android

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

الضبط غير الخطي لحجم الخط بنسبة ‏200%

从 Android 14 开始,系统支持字体放大高达 200%,为弱视用户提供了符合网络内容无障碍指南 (WCAG) 的其他无障碍选项。

为防止屏幕上的大文本元素放大过大,系统会采用非线性放大曲线。这种放大策略意味着大号文本的放大比例不会与较小的文本相同。非线性字体缩放有助于保持不同大小元素之间的比例层次结构,同时缓解高级别线性文本缩放的问题(例如文本被截断或文本因超大显示大小而难以阅读)。

使用非线性字体放大测试应用

在设备的无障碍设置中启用最大字号,以测试应用。

如果您已经使用放大像素 (sp) 单位来定义文本大小,那么这些额外的选项和缩放改进会自动应用于应用中的文本。但是,您仍然应该在启用最大字体大小 (200%) 的情况下执行界面测试,以确保应用正确应用字体大小,并且可以适应更大的字体大小,而不影响易用性。

要启用 200% 字号,请按以下步骤操作:

  1. 打开“设置”应用,然后依次前往无障碍 > 显示大小和文字
  2. 字号选项中,点按加号 (+) 图标,直到启用最大字号设置,如本部分随附的图片所示。

针对文本大小使用放大像素 (sp) 单位

请务必始终以 sp 为单位指定文本大小。当应用使用 sp 单位时,Android 可以应用用户的首选文本大小并相应地缩放。

不要为内边距使用 sp 单位,也不假设隐式内边距定义视图高度:使用非线性字体缩放 sp 尺寸可能不成比例,因此 4sp + 20sp 可能不等于 24sp。

转换放大像素 (sp) 单位

使用 TypedValue.applyDimension() 从 sp 单位转换为像素,并使用 TypedValue.deriveDimension() 将像素转换为 sp。这些方法会自动应用适当的非线性缩放曲线。

避免使用 Configuration.fontScaleDisplayMetrics.scaledDensity 对方程进行硬编码。由于字体缩放是非线性的,因此 scaledDensity 字段不再准确。fontScale 字段应仅用于提供信息,因为字体不再使用单个标量值进行缩放。

对 lineHeight 使用 sp 单位

始终使用 sp 单位(而非 dp)定义 android:lineHeight,以便行高随文本一起缩放。否则,如果您的文本为 sp,而 lineHeight 以 dp 或 px 为单位,则文本无法缩放且看起来狭窄。TextView 会自动更正 lineHeight 以保留您预期的比例,但前提是以 sp 为单位同时定义 textSizelineHeight

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

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

صورة توضيحية لجودة الصور بنطاق عادي ديناميكية (SDR) مقارنةً بنطاق عالي الديناميكية (HDR).

يتيح نظام التشغيل Android 14 استخدام صور النطاق العالي الديناميكية (HDR) التي تحتفظ بمزيد من المعلومات الواردة من أداة الاستشعار عند التقاط صورة، ما يتيح الحصول على ألوان زاهية ودرجة تباين أكبر. يستخدم نظام Android تنسيق Ultra HDR، وهو متوافق تمامًا مع صور JPEG القديمة، ما يسمح للتطبيقات بالعمل بسلاسة مع صور HDR وعرضها بنطاق ديناميكي عادي (SDR) عند الحاجة.

ويتم عرض هذه الصور في واجهة المستخدم بتنسيق HDR تلقائيًا من خلال إطار العمل عندما يختار تطبيقك استخدام واجهة مستخدم بتنسيق HDR لـ "نافذة النشاط"، إما من خلال أحد إدخالات ملف البيان أو أثناء التشغيل من خلال استدعاء Window.setColorMode(). يمكنك أيضًا التقاط صور ثابتة فائقة التباين الديناميكي (HDR) المضغوطة على الأجهزة المتوافقة. من خلال استرداد المزيد من الألوان من أداة الاستشعار، يمكن أن يكون التعديل في مرحلة ما بعد الإنتاج أكثر مرونة. يمكن استخدام رمز الترميز Gainmap المرتبط بالصور ذات النطاق العالي الديناميكية الفائق لعرضها باستخدام OpenGL أو Vulkan.

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

Android 14 升级并改进了相机扩展程序,让应用能够处理更长的处理时间,从而支持在受支持的设备上使用计算密集型算法(例如弱光摄影)来改善图片。这些功能可让用户在使用相机扩展功能时获得更出色的体验。这些改进的示例包括:

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

عندما يحتوي REQUEST_AVAILABLE_CAPABILITIES_STREAM_USE_CASE في CameraCharacteristics على SCALER_AVAILABLE_STREAM_USE_CASES_CROPPED_RAW، يمكن لتطبيقك استخدام إمكانات أداة الاستشعار المتقدّمة لتوفير بثّ RAW مقطّع يحتوي على كثافة بكسل مماثلة لكثافة بكسل مجال العرض الكامل باستخدام CaptureRequest مع هدف RAW تم ضبط حالة استخدام البث عليه على CameraMetadata.SCALER_AVAILABLE_STREAM_USE_CASES_CROPPED_RAW. من خلال تنفيذ عناصر التحكّم في إلغاء الطلبات، تمنح الكاميرا المعدَّلة المستخدمين إمكانية التحكّم في التكبير/التصغير حتى قبل أن تصبح عناصر التحكّم الأخرى في الكاميرا جاهزة.

صوت عالي الدقة عبر USB

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

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

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

Android 14 将 Credential Manager 添加为平台 API,并通过使用 Google Play 服务的 Jetpack 库,向后额外支持 Android 4.4(API 级别 19)设备。Credential Manager 旨在通过 API 使用用户配置的凭据提供程序检索和存储凭据,让用户更轻松地登录。Credential Manager 在单个 API 中支持多种登录方法,包括用户名和密码、通行密钥和联合登录解决方案(如“使用 Google 账号登录”)。

通行密钥具有许多优势。例如,通行密钥是基于业界标准构建的,可在各种不同的操作系统和浏览器生态系统中使用,并且可用于网站和应用。

如需了解详情,请参阅 Credential Manager 和通行密钥文档以及介绍 Credential Manager 和通行密钥的博文

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 أو إصدار أحدث.
يمكن للمستخدمين التحكّم في التطبيقات التي يمكنها الوصول إلى بيانات صحتهم ولياقتهم البدنية من خلال إعدادات النظام.

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

لمزيد من المعلومات، يُرجى الاطّلاع على مستندات Health Connect والمقالة في المدونة حول الميزات الجديدة في تطبيق "صحة Android".

تعديلات OpenJDK 17

Android 14 将继续更新 Android 的核心库,以与最新 OpenJDK LTS 版本中的功能保持一致,包括适合应用和平台开发者的库更新和 Java 17 语言支持。

其中包含以下功能和改进:

  • 将大约 300 个 java.base 类更新为支持 Java 17。
  • 文本块 - 为 Java 编程语言引入了多行字符串字面量。
  • instanceof 模式匹配:可让对象在 instanceof 中被视为具有特定类型,而无需任何额外的变量。
  • 密封类:允许您限制哪些类和接口可以扩展或实现它们。

得益于 Google Play 系统更新 (Project Mainline),6 亿多台设备能够接收包含这些更改的最新 Android 运行时 (ART) 更新。我们致力于为应用提供更加一致、安全的跨设备环境,并为用户提供独立于平台版本的新功能。

Java 和 OpenJDK 是 Oracle 及/或其关联公司的商标或注册商标。

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

Android 14 引入了多个 PackageInstaller API,可帮助应用商店改善其用户体验。

下载之前请求批准安装

安装或更新应用可能需要用户批准。例如,当使用 REQUEST_INSTALL_PACKAGES 权限的安装程序尝试安装新应用时。在之前的 Android 版本中,只有在将 APK 写入安装会话并且提交会话后,应用商店才能请求用户批准。

从 Android 14 开始,requestUserPreapproval() 方法可让安装程序在提交安装会话之前请求用户批准。此项改进可让应用商店将任何 APK 的下载操作推迟到用户批准安装之后。此外,用户批准安装后,应用商店可以在后台下载并安装应用,而不会干扰用户。

承担未来更新的责任

借助 setRequestUpdateOwnership() 方法,安装程序可以向系统表明它打算负责将被安装的应用未来的更新。此 capability 可实现更新所有权强制执行,即仅允许更新所有者为应用安装自动更新。更新所有权强制执行有助于确保用户仅收到来自预期应用商店的更新。

任何其他安装程序(包括使用 INSTALL_PACKAGES 权限的安装程序)都必须获得用户的明确批准,才能安装更新。如果用户决定继续从其他来源安装更新,则会失去更新所有权。

在干扰较少的时段更新应用

应用商店通常希望避免更新正在使用的应用,因为这会导致应用正在运行的进程被终止,而这可能会中断用户正在执行的操作。

从 Android 14 开始,InstallConstraints API 让安装程序可以确保其应用更新在适当的时机进行。例如,应用商店可以调用 commitSessionAfterInstallConstraintsAreMet() 方法来确保仅在用户不再与相应应用互动时才进行更新。

无缝安装可选拆分

借助拆分 APK,应用的功能可以通过单独的 APK 文件提供,而不是以单体式 APK 的形式提供。借助拆分 APK,应用商店可以优化不同应用组件的提供。例如,应用商店可能会根据目标设备的属性进行优化。自在 API 级别 22 中引入以来,PackageInstaller API 一直支持拆分。

在 Android 14 中,setDontKillApp() 方法可让安装程序指明在安装新的拆分项时应用的运行进程不应终止。应用商店可以使用此功能,在用户使用应用时无缝安装应用的新功能。

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

从 Android 14 开始,Android 软件包安装程序可让您指定应用元数据(例如数据安全做法),以在 Google Play 等应用商店页面上架。

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

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

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

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

Android 14 更新了系统 Sharesheet,以便为用户提供自定义应用操作和信息更丰富的预览结果。

添加自定义操作

对于 Android 14,您的应用可以向其调用的系统 Sharesheet 添加自定义操作

分享表格中自定义操作的屏幕截图。

提高直接共享目标的排名

Android 14 根据来自应用的更多信号来确定直接共享目标的排名,以便为用户提供更实用的结果。为了提供最实用的排名信号,请遵循提高直接共享目标排名的准则。通讯应用还可以报告出站和入站消息的快捷方式使用情况

共享表单中的“直接分享”行,如 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

在搭载 12 月功能分块的 Pixel 8 Pro 设备上,开发者可以在 Gboard 中试用质量更高的智能回复,这些回复由在 Google Tensor 上运行的设备端大语言模型 (LLM) 提供支持。

此功能目前仅在 WhatsApp、Line 和 KakaoTalk 中以美式英语的形式提供给用户进行小范围测试。此功能需要使用 Pixel 8 Pro 设备,并将 Gboard 用作键盘。

如需试用此功能,请先依次前往设置 > 开发者选项 > AiCore 设置 > 启用 Aicore 持久性,启用该功能。

接下来,在受支持的应用中打开对话,即可在 Gboard 的建议栏中看到依托 LLM 的智能回复,以便回复收到的消息。

Gboard 利用设备端 LLM 提供更高质量的智能回复。

الرسومات

يمكن البحث عن المسارات وتعديلها.

Android 的 Path API 是一种强大且灵活的机制,可用于创建和渲染矢量图形,能够描边或填充路径、根据线段或二次曲线或立方曲线构建路径、执行布尔运算以获取更复杂的形状,或同时执行所有这些操作。但有一个限制是,您无法了解 Path 对象中实际包含的内容;该对象的内部信息在创建后对调用方是不透明的。

如需创建 Path,您可以调用 moveTo()lineTo()cubicTo() 等方法来添加路径段。但是,无法询问该路径有哪些片段,因此您必须在创建时保留该信息。

从 Android 14 开始,您可以查询路径以了解其内部内容。首先,您需要使用 Path.getPathIterator API 获取 PathIterator 对象:

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 针对 Path 还包含 interpolate() 方法。假设两个路径具有相同的内部结构,interpolate() 方法会使用该插值结果创建一个新的 Path。以下示例返回了一个形状介于 pathotherPath 之间的一半(线性插值为 0.5)的路径:

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);
}

Jetpack graphics-path 库也为早期版本的 Android 启用了类似的 API。

شبكات مخصّصة مع مظلّلات الرؤوس والأجزاء

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

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

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

للمساعدة في استخدام واجهة برمجة التطبيقات Canvas في Android للرسم باستخدام التسارع في الأجهزة في HardwareBuffer، يوفّر الإصدار 14 من Android HardwareBufferRenderer. واجهة برمجة التطبيقات هذه عندما تشتمل حالة الاستخدام على التواصل مع النظام المكون من خلال SurfaceControl لوقت الاستجابة المنخفض رسم.