MetaKeyboard is a custom Android keyboard for Meta Quest. It is designed for comfortable controller/hand input in VR and includes English and Persian layouts, themes, emoji, cursor editing controls, clipboard actions, app shortcuts, and long-press character alternatives.
Quest restart note: After a headset restart, Quest may need to initialize its own world-space keyboard before a third-party IME receives the correct panel size. Follow the After every headset restart steps below before using MetaKeyboard.
- Install the APK on the Quest headset.
- Open the MetaKeyboard app from the Quest app library.
- Grant the keyboard permission when Android asks.
- In Quest keyboard/input settings, enable MetaKeyboard and select it as the active keyboard.
- Open a text field in the Browser or another Quest app to test it.
For automatic recovery of the selected keyboard after restart, the development build can be granted Android's secure-settings permission through ADB:
adb shell pm grant com.arygames.metakeyboard android.permission.WRITE_SECURE_SETTINGSThis command is only required for builds that use automatic IME restoration. It must be run again if the app is uninstalled.
Quest sometimes restores a third-party keyboard before the Quest/Horizon keyboard panel has initialized. That can make the MetaKeyboard panel appear too narrow, stretched, or incorrectly sized. Use this short initialization flow:
- After the headset finishes booting, open Meta Quest Browser (or any app that contains a normal text input).
- Tap or select an input field, such as the address/search bar.
- Wait for the standard Quest/Horizon keyboard to appear. Keep it visible for at least one second.
- While the text field is still active, open the keyboard selector in the keyboard/app settings and choose MetaKeyboard.
- The keyboard switches to MetaKeyboard using the already-initialized Quest panel. You can now close the Browser and use MetaKeyboard normally in other apps.
Do not immediately close the native Quest keyboard before switching. Letting it appear first is the important step: it gives Horizon OS time to calculate the correct world-space IME panel geometry.
If MetaKeyboard is already displayed with the wrong size, switch back to the standard Quest/Horizon keyboard, wait one second while it is visible, and then switch to MetaKeyboard again with the same text field focused.
- Language: Use the language control to switch between English and Persian.
- Long press: Hold a letter to reveal related alternative characters where available.
- Caps Lock: Tap Shift for a single capital; use Caps Lock for continuous capitals.
- Emoji: Open the emoji button for a compact categorized picker.
- Editing panel: Use cursor movement, Select All, Cut, and Copy for text editing.
- Clipboard: Paste is available from the editing controls.
- Theme: Open Settings to choose a theme and primary keyboard accent color.
- App shortcuts: The apps panel lists launchable Quest apps; MetaKeyboard remains at the top for quick access.
| Problem | What to do |
|---|---|
| Keyboard is horizontally shrunken or has incorrect proportions | Run the restart initialization flow above: show the Quest/Horizon keyboard for at least one second, then switch to MetaKeyboard with the input focused. |
| MetaKeyboard is missing from the keyboard list | Reopen MetaKeyboard, confirm it is enabled in Android/Quest input settings, then restart the text field. |
| Keyboard changes back after a reboot | Open MetaKeyboard once after boot and confirm the ADB secure-settings permission was granted for the installed build. Then complete the restart initialization flow. |
| No keyboard appears | Focus a normal editable text field and check that an IME is enabled in Quest keyboard settings. |
| A new app build behaves differently | Reinstall/update the APK, reopen MetaKeyboard once, then repeat the restart initialization flow. |
MetaKeyboard is intended to process typing locally on the headset. Clipboard actions operate on the Android clipboard available to the current device and profile.
MetaKeyboard یک کیبورد سفارشی اندروید برای Meta Quest است. این کیبورد برای استفاده با کنترلر یا دست در واقعیت مجازی طراحی شده و چیدمان فارسی و انگلیسی، تم، ایموجی، ابزار جابهجایی نشانگر، عملیات کلیپبورد، میانبر برنامهها و کاراکترهای جایگزین با نگهداشتن کلید را دارد.
نکته مهم بعد از ریاستارت هدست: پس از ریاستارت، ممکن است Quest قبل از آمادهشدن پنل کیبورد خود سیستم، کیبوردهای دیگر را برگرداند. برای اینکه اندازه پنل MetaKeyboard درست محاسبه شود، مراحل بخش بعد از هر ریاستارت هدست را انجام دهید.
- فایل APK را روی هدست Quest نصب کنید.
- از App Library هدست، برنامه MetaKeyboard را باز کنید.
- اگر اندروید درخواست مجوز کیبورد نشان داد، آن را تأیید کنید.
- از تنظیمات Keyboard/Input در Quest، MetaKeyboard را فعال و بهعنوان کیبورد فعلی انتخاب کنید.
- برای آزمایش، در Browser یا یک برنامه دیگر یک فیلد متنی را انتخاب کنید.
برای اینکه نسخه توسعهدهنده بتواند بعد از ریاستارت کیبورد انتخابشده را دوباره تنظیم کند، یکبار از طریق ADB این مجوز را بدهید:
adb shell pm grant com.arygames.metakeyboard android.permission.WRITE_SECURE_SETTINGSاین دستور فقط برای بیلدهایی که بازیابی خودکار IME دارند لازم است و اگر برنامه را حذف کنید، باید دوباره اجرا شود.
گاهی Quest کیبورد شخص ثالث را پیش از آمادهشدن پنل سهبعدی کیبورد Horizon برمیگرداند. در این حالت ممکن است MetaKeyboard باریک، کشیده یا با اندازه نادرست دیده شود. بعد از هر ریاستارت، این روند کوتاه را انجام دهید:
- بعد از بالا آمدن کامل هدست، Meta Quest Browser را باز کنید؛ هر برنامهای با فیلد متنی عادی هم قابل استفاده است.
- روی یک Input بزنید یا آن را انتخاب کنید؛ مثلاً نوار آدرس یا جستجو.
- صبر کنید تا کیبورد اصلی Quest/Horizon نمایش داده شود و حداقل یک ثانیه آن را باز نگه دارید.
- در حالی که همان فیلد متنی همچنان فعال است، از انتخابگر کیبورد یا تنظیمات کیبورد، کیبورد را به MetaKeyboard تغییر دهید.
- اکنون MetaKeyboard روی پنل آمادهشده Quest نمایش داده میشود. میتوانید Browser را ببندید و در برنامههای دیگر از آن استفاده کنید.
کیبورد اصلی Quest را بلافاصله نبندید. نمایش آن برای حداقل یک ثانیه مهم است، چون Horizon OS در همین مرحله اندازه و جای پنل IME در فضای سهبعدی را محاسبه میکند.
اگر MetaKeyboard همین حالا با اندازه اشتباه باز شده است، به کیبورد اصلی Quest/Horizon برگردید، حداقل یک ثانیه صبر کنید، و در حالی که همان Input فعال است دوباره MetaKeyboard را انتخاب کنید.
- زبان: با کنترل زبان بین فارسی و انگلیسی جابهجا شوید.
- نگهداشتن کلید: کلید حروف را نگه دارید تا کاراکترهای جایگزین آن، در صورت وجود، نمایش داده شوند.
- Caps Lock: Shift برای یک حرف بزرگ است؛ Caps Lock برای نوشتن مداوم با حروف بزرگ استفاده میشود.
- ایموجی: با دکمه ایموجی، انتخابگر دستهبندیشده ایموجی را باز کنید.
- پنل ویرایش: برای حرکت نشانگر و Select All، Cut و Copy از ابزار ویرایش استفاده کنید.
- کلیپبورد: Paste در ابزارهای ویرایش قرار دارد.
- تم: از Settings تم و رنگ اصلی کیبورد را انتخاب کنید.
- میانبر برنامهها: پنل برنامهها، برنامههای قابل اجرا را نشان میدهد و MetaKeyboard برای دسترسی سریع همیشه در ابتدای فهرست است.
| مشکل | راهحل |
|---|---|
| کیبورد از عرض کوچک شده یا نسبت آن درست نیست | مراحل راهاندازی بعد از ریاستارت را انجام دهید: کیبورد Quest/Horizon را حداقل یک ثانیه نمایش دهید، سپس با فعالبودن Input به MetaKeyboard تغییر دهید. |
| MetaKeyboard در فهرست کیبوردها نیست | برنامه MetaKeyboard را دوباره باز کنید، فعالبودن آن را در تنظیمات Keyboard/Input Quest بررسی کنید و سپس Input را دوباره انتخاب کنید. |
| پس از ریاستارت، کیبورد عوض میشود | بعد از بوت برنامه MetaKeyboard را یکبار باز کنید و مطمئن شوید مجوز ADB برای نسخه نصبشده داده شده است. سپس مراحل راهاندازی بعد از ریاستارت را انجام دهید. |
| هیچ کیبوردی نمایش داده نمیشود | یک فیلد متنی قابل ویرایش را انتخاب کنید و فعالبودن یک IME را در تنظیمات کیبورد Quest بررسی کنید. |
| بعد از آپدیت برنامه رفتار متفاوت است | APK را نصب/آپدیت کنید، MetaKeyboard را یکبار باز کنید و مراحل راهاندازی بعد از ریاستارت را تکرار کنید. |
MetaKeyboard برای پردازش محلی تایپ روی هدست طراحی شده است. عملیات کلیپبورد فقط با کلیپبورد اندروید موجود در همان دستگاه و پروفایل فعلی کار میکند.