اولین فعالیت خود را برای عینک هوش مصنوعی ایجاد کنید

دستگاه‌های XR قابل اجرا

این راهنما به شما کمک می‌کند تا برای این نوع دستگاه‌های XR تجربه ایجاد کنید.

درباره انواع دستگاه‌های XR اطلاعات کسب کنید →

درباره انواع دستگاه‌های XR اطلاعات کسب کنید →

تجربه عینک هوش مصنوعی بر اساس API موجود در چارچوب Activity اندروید ساخته شده است و شامل مفاهیم اضافی برای پشتیبانی از جنبه‌های منحصر به فرد عینک‌های هوش مصنوعی است. برخلاف هدست‌های XR که یک APK کامل را روی دستگاه اجرا می‌کنند، عینک‌های هوش مصنوعی از یک فعالیت اختصاصی استفاده می‌کنند که در برنامه موجود تلفن شما اجرا می‌شود. این فعالیت از دستگاه میزبان به عینک هوش مصنوعی منتقل می‌شود.

برای ایجاد تجربه عینک هوش مصنوعی برنامه خود، شما برنامه تلفن موجود خود را با ایجاد یک Activity جدید پیش‌بینی‌شده برای عینک هوش مصنوعی گسترش می‌دهید. این Activity به عنوان نقطه ورود اصلی راه‌اندازی برای برنامه شما در عینک هوش مصنوعی عمل می‌کند. این رویکرد توسعه را ساده می‌کند زیرا می‌توانید منطق کسب‌وکار را بین تجربیات تلفن و عینک هوش مصنوعی خود به اشتراک بگذارید و دوباره استفاده کنید.

سازگاری نسخه

الزامات سازگاری Android SDK را برای Jetpack XR SDK بررسی کنید.

وابستگی‌ها

وابستگی‌های کتابخانه‌ای زیر را برای عینک‌های هوش مصنوعی اضافه کنید:

dependencies {
    implementation "androidx.xr.runtime:runtime:1.0.0-alpha11"
    implementation "androidx.xr.glimmer:glimmer:1.0.0-alpha06"
    implementation "androidx.xr.projected:projected:1.0.0-alpha04"
    implementation "androidx.xr.arcore:arcore:1.0.0-alpha10"
}

dependencies {
    implementation("androidx.xr.runtime:runtime:1.0.0-alpha11")
    implementation("androidx.xr.glimmer:glimmer:1.0.0-alpha06")
    implementation("androidx.xr.projected:projected:1.0.0-alpha04")
    implementation("androidx.xr.arcore:arcore:1.0.0-alpha10")
}

فعالیت خود را در مانیفست برنامه خود اعلام کنید

درست مانند سایر انواع اکتیویتی‌ها، شما باید اکتیویتی خود را در فایل مانیفست برنامه خود تعریف کنید تا سیستم آن را ببیند و اجرا کند.

<application>
  <activity
      android:name="com.example.xr.projected.GlassesMainActivity"
      android:exported="true"
      android:requiredDisplayCategory="xr_projected"
      android:label="Example AI Glasses activity">
      <intent-filter>
          <action android:name="android.intent.action.MAIN" />
      </intent-filter>
  </activity>
</application>

نکات کلیدی در مورد کد

• xr_projected برای ویژگی android:requiredDisplayCategory مشخص می‌کند تا به سیستم بگوید که این فعالیت باید از یک زمینه‌ی پیش‌بینی‌شده برای دسترسی به سخت‌افزار از یک دستگاه متصل استفاده کند.

فعالیت خود را ایجاد کنید

در مرحله بعد، یک فعالیت کوچک ایجاد خواهید کرد که می‌تواند هر زمان که صفحه نمایش روشن می‌شود، چیزی را روی عینک هوش مصنوعی نمایش دهد.

@OptIn(ExperimentalProjectedApi::class)
class GlassesMainActivity : ComponentActivity() {

    private var displayController: ProjectedDisplayController? = null
    private var isVisualUiSupported by mutableStateOf(false)
    private var areVisualsOn by mutableStateOf(true)

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)

        lifecycle.addObserver(object : DefaultLifecycleObserver {
            override fun onDestroy(owner: LifecycleOwner) {
                displayController?.close()
                displayController = null
            }
        })

        lifecycleScope.launch {
            // Check device capabilities
            val projectedDeviceController = ProjectedDeviceController.create(this@GlassesMainActivity)
            isVisualUiSupported = projectedDeviceController.capabilities.contains(CAPABILITY_VISUAL_UI)

            val controller = ProjectedDisplayController.create(this@GlassesMainActivity)
            displayController = controller
            val observer = GlassesLifecycleObserver(
                context = this@GlassesMainActivity,
                controller = controller,
                onVisualsChanged = { visualsOn -> areVisualsOn = visualsOn }
            )
            lifecycle.addObserver(observer)
        }

        setContent {
            GlimmerTheme {
                HomeScreen(
                    areVisualsOn = areVisualsOn,
                    isVisualUiSupported = isVisualUiSupported,
                    onClose = { finish() }
                )
            }
        }
    }
}
GlassesMainActivity.kt

نکات کلیدی در مورد کد

• استفاده از APIهای آزمایشی کتابخانه Jetpack Projected را انتخاب می‌کند.
• GlassesMainActivity از ComponentActivity ارث‌بری می‌کند، درست همانطور که در توسعه موبایل انتظار می‌رود.
• از آنجا که همه عینک‌های هوش مصنوعی نمایشگر ندارند، با استفاده از ProjectedDeviceController بررسی می‌کند که آیا دستگاه نمایشگر دارد یا خیر.
• بلوک setContent درون تابع onCreate ریشه درخت رابط کاربری Composable را برای اکتیویتی تعریف می‌کند. شما Composable HomeScreen با استفاده از Jetpack Compose Glimmer پیاده‌سازی خواهید کرد.
• رابط کاربری را در طول متد onCreate مربوط به اکتیویتی مقداردهی اولیه می‌کند (به چرخه حیات اکتیویتی پیش‌بینی‌شده مراجعه کنید).

پیاده‌سازی composable

اکتیویتی که شما ایجاد کرده‌اید به یک تابع قابل ترکیب HomeScreen اشاره می‌کند که باید آن را پیاده‌سازی کنید. کد زیر از Jetpack Compose Glimmer برای تعریف یک تابع قابل ترکیب استفاده می‌کند که می‌تواند متنی را روی صفحه نمایش عینک هوش مصنوعی نمایش دهد:

@Composable
fun HomeScreen(
    areVisualsOn: Boolean,
    isVisualUiSupported: Boolean,
    onClose: () -> Unit,
    modifier: Modifier = Modifier
) {
    Box(
        modifier = modifier
            .surface(focusable = false)
            .fillMaxSize(),
        contentAlignment = Alignment.Center
    ) {
        if (isVisualUiSupported) {
            Card(
                title = { Text("Android XR") },
                action = {
                    Button(onClick = onClose) {
                        Text("Close")
                    }
                }
            ) {
                if (areVisualsOn) {
                    Text("Hello, AI Glasses!")
                } else {
                    Text("Display is off. Audio guidance active.")
                }
            }
        } else {
            Text("Audio Guidance Mode Active")
        }
    }
}
GlassesMainActivity.kt

نکات کلیدی در مورد کد

• همانطور که قبلاً در اکتیویتی خود تعریف کردید، تابع HomeScreen شامل محتوای قابل ترکیبی است که کاربر هنگام روشن بودن صفحه نمایش عینک هوش مصنوعی می‌بیند.
• کامپوننت Jetpack Compose Glimmer Text متن «سلام، عینک هوش مصنوعی!» را روی نمایشگر عینک نمایش می‌دهد.
• Button Jetpack Compose Glimmer با فراخوانی finish() از طریق onClose در اکتیویتی عینک هوش مصنوعی، اکتیویتی را می‌بندد.

بررسی کنید که آیا عینک‌های هوش مصنوعی متصل هستند یا خیر

برای اینکه قبل از اجرای اکتیویتی خود، مشخص کنید که آیا عینک هوش مصنوعی کاربر به تلفن همراهش متصل است یا خیر، از متد ProjectedContext.isProjectedDeviceConnected استفاده کنید. این متد یک Flow<Boolean> برمی‌گرداند که برنامه شما می‌تواند آن را مشاهده کند تا به‌روزرسانی‌های بلادرنگ در مورد وضعیت اتصال را دریافت کند.

فعالیت خود را شروع کنید

اکنون که یک اکتیویتی پایه ایجاد کرده‌اید، می‌توانید آن را روی عینک خود اجرا کنید. برای دسترسی به سخت‌افزار عینک، برنامه شما باید اکتیویتی شما را با گزینه‌های خاصی که به سیستم می‌گوید از یک زمینه‌ی پیش‌بینی‌شده استفاده کند، همانطور که در کد زیر نشان داده شده است، آغاز کند:

val options = ProjectedContext.createProjectedActivityOptions(context)
val intent = Intent(context, GlassesMainActivity::class.java)
context.startActivity(intent, options.toBundle())
PhoneMainActivity.kt

متد createProjectedActivityOptions در ProjectedContext گزینه‌های لازم برای شروع فعالیت شما در یک زمینه‌ی پیش‌بینی‌شده را تولید می‌کند. پارامتر context می‌تواند زمینه‌ای از تلفن یا دستگاه عینک باشد.

مراحل بعدی

حالا که اولین فعالیت خود را برای عینک هوش مصنوعی ایجاد کرده‌اید، روش‌های دیگری را که می‌توانید عملکرد آن را گسترش دهید، بررسی کنید:

• مدیریت خروجی صدا با استفاده از تبدیل متن به گفتار
• مدیریت ورودی صدا با استفاده از تشخیص خودکار گفتار
• ساخت رابط کاربری با Jetpack Compose Glimmer
• دسترسی به سخت‌افزار عینک‌های هوش مصنوعی