از 27 مارس 2025، توصیه می کنیم از android-latest-release به جای aosp-main برای ساختن و کمک به AOSP استفاده کنید. برای اطلاعات بیشتر، به تغییرات AOSP مراجعه کنید.
شناسایی سیستم عامل اندروید
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
کلمات کلیدی: AiAssisted، انتشار 16، اتصال اندروید، بلوتوث، دسته: اتصال به اندروید، نوع سند: راهنما
با شروع اندروید 14، چارچوب Android شامل یک سرویس ویژگی عمومی (GATT) به نام سرویس اطلاعات اندروید (AIS) است که به دستگاه‌های بلوتوث اجازه می‌دهد سطح API Android را به عنوان ویژگی GATT این سرویس بخوانند. این سرویس به سازندگان دستگاه‌های بلوتوث اجازه می‌دهد بدانند که آیا یک دستگاه جانبی بلوتوث با یک دستگاه مرکزی که دارای سیستم عامل Android است جفت می‌شود یا خیر، و منطق تخصصی را بر اساس سطح API مدیریت کنند.
AIS یک سرویس استاندارد گات است و تنها یک نمونه از AIS روی یک دستگاه می تواند وجود داشته باشد. UUID سرویس اولیه e73e0001-ef1b-4e74-8291-2e4f3164f3b5 است. مشخصه سطح API Android (UUID: e73e0002-ef1b-4e74-8291-2e4f3164f3b5 ) حاوی سطح API دستگاه به عنوان یک عدد صحیح 32 بیتی بدون علامت به شکل باینری (کوچک edian) است. مقدار مشخصه سطح API Android 4 اکتت طول دارد (به عنوان مثال، سطح API 36 0x24_00_00_00 است). وقتی دستگاه قابل شناسایی باشد، مقدار مشخصه سطح Android API بدون احراز هویت یا مجوز قابل خواندن است. وقتی دستگاه قابل شناسایی نباشد، مشخصه سطح API Android فقط با احراز هویت و مجوز قابل خواندن است.
سرویس را کشف کنید
دستگاه بلوتوث در نقش سرویس گیرنده GATT و دستگاه مجهز به Android در نقش سرور قرار دارد. برای کشف AIS و خواندن سطح API Android، دستگاه‌های بلوتوث از روش‌های نمایه GATT مانند کشف سرویس اولیه ، کشف مشخصه ، و روش‌های خواندن ارزش مشخصه استفاده می‌کنند. برای جزئیات بیشتر در مورد این رویه ها، مشخصات نمایه گات را ببینید.
سطح API توسط ویژگی سیستم ro.build.version.sdk تعریف می شود. اگر سرویس اولیه قابل کشف نباشد، به این معنی است که ویژگی سیستم تعریف نشده است یا مقدار خالی تنظیم شده است، یا سیستم عامل میزبان اندروید نیست.
اعتبار سنجی
برای تأیید اینکه آیا AIS قابل کشف است، با جفت کردن یک دستگاه جانبی بلوتوث با یک دستگاه مجهز به Android، یک آزمایش دستی را اجرا کنید و سپس UUID سرویس AIS را در سرویس‌های اصلی کشف‌شده جستجو کنید.
محتوا و نمونه کدها در این صفحه مشمول پروانههای توصیفشده در پروانه محتوا هستند. جاوا و OpenJDK علامتهای تجاری یا علامتهای تجاری ثبتشده Oracle و/یا وابستههای آن هستند.
تاریخ آخرین بهروزرسانی 2025-08-22 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین بهروزرسانی 2025-08-22 بهوقت ساعت هماهنگ جهانی."],[],[],null,["# Android OS identification\n\nkeywords: AiAssisted,release16,androidconnectivity,bluetooth,category:AndroidConnectivity,docType:Guide\n\nStarting in Android 14, the Android framework includes a Generic Attribute\n(GATT) service called Android information service (AIS), which lets Bluetooth\ndevices read the Android API level as a GATT characteristic of the service.\nThis service lets Bluetooth device manufacturers know whether a Bluetooth\nperipheral is pairing with a central device that is running the Android OS,\nand manage specialized logic based on the API level.\n\nAndroid information service (AIS)\n---------------------------------\n\nAIS is a standard GATT service and there can be only one instance of AIS on\na device. The primary service UUID is `e73e0001-ef1b-4e74-8291-2e4f3164f3b5`.\nThe Android API level characteristic (UUID:\n`e73e0002-ef1b-4e74-8291-2e4f3164f3b5`) contains the API level of the device as\nan unsigned 32-bit integer in binary form (little-endian). The value of the\nAndroid API level characteristic is 4 octets in length (for example, API\nlevel 36 is `0x24_00_00_00`). When the device is discoverable, the Android API\nlevel characteristic value is readable without authentication or authorization.\nWhen the device isn't discoverable, the Android API level characteristic is\nreadable only with authentication and authorization.\n\nDiscover the service\n--------------------\n\nThe Bluetooth device is on the GATT client role and the Android-powered device\nis on the server role. To discover AIS and read the Android API level, Bluetooth\ndevices use GATT profile procedures such as the *primary service discovery* ,\n*characteristic discovery* , and *characteristic value read* procedures. For\ndetails on these procedures, see the [GATT profile specification](https://www.bluetooth.com/wp-content/uploads/Files/Specification/HTML/Core-54/out/en/host/generic-attribute-profile--gatt-.html).\n\nThe API level is defined by the `ro.build.version.sdk` system property. If the\nprimary service can't be discovered, it means that the system property isn't\ndefined or the value is set to empty, or the host operation system isn't\nAndroid.\n\nValidation\n----------\n\nTo verify that AIS can be discovered, run a manual test by pairing a Bluetooth\nperipheral with an Android-powered device, and then looking up the AIS service\nUUID in the discovered primary services."]]
