The display API sends glanceable, user-visible information to supported smart glasses.
Mentra Live does not have a display. Use display APIs only on display-equipped models such as G2.
Basic Text
await BluetoothSdk.displayText('Turn left in 100 ft', 0, 0, 24);
sdk.displayText(text = "Turn left in 100 ft", x = 0, y = 0, size = 24)
try await sdk.displayText("Turn left in 100 ft", x: 0, y: 0, size: 24)
Clear Display
await BluetoothSdk.clearDisplay();
try await sdk.clearDisplay()
Dashboard
await BluetoothSdk.showDashboard();
Display Settings
Display-related settings include dashboard position, head-up angle, and screen enable/disable state.
await BluetoothSdk.setDashboardPosition(4, 6);
await BluetoothSdk.setHeadUpAngle(20);
await BluetoothSdk.setScreenDisabled(false);
sdk.setDashboardPosition(height = 4, depth = 6)
sdk.setHeadUpAngle(angleDegrees = 20)
sdk.setScreenDisabled(false)
try await sdk.setDashboardPosition(height: 4, depth: 6)
try await sdk.setHeadUpAngle(20)
try await sdk.setScreenDisabled(false)
Guidelines
- Keep text short. Glasses displays are glanceable, not phone screens.
- Prefer one primary message at a time.
- Avoid rapid display churn. Debounce frequent updates.
- Clear the display when information is stale.
- Handle disconnected, not-ready, and unsupported-capability states gracefully.
