Documentation Index
Fetch the complete documentation index at: https://mintlify.com/lastninja294/adgent-sdk/llms.txt
Use this file to discover all available pages before exploring further.
Overview
Hisense Vidaa is the Smart TV platform used in Hisense televisions. The Adgent SDK provides native support for Vidaa with a lightweight implementation optimized for the platform’s resource constraints.Supported Versions
- Vidaa 2.0+: Fully supported
- Vidaa U3+: Recommended for best performance
- Vidaa U4+: Latest version with enhanced features
Platform Detection
The SDK automatically detects Vidaa platforms using user agent patterns:- User agent matches
/Vidaa/i - User agent matches
/VIDAA/i - User agent matches
/Hisense/i
Platform-Specific Features
Lightweight Implementation
Vidaa TVs typically have more constrained hardware compared to WebOS or Tizen. The SDK provides a lightweight implementation:- Minimal memory footprint
- Optimized video playback
- Reduced codec requirements
- Simplified key mapping
Video Capabilities
Vidaa platform capabilities (varies by model):- Resolution: Up to 4K on newer models (1080p recommended)
- HEVC Support: Available on Vidaa U3+
- HDR: Limited HDR10 support on select models
- Preferred Codec: H.264 for maximum compatibility
Remote Control Key Codes
Vidaa uses standard web key codes with dual back button support:| Key Action | Key Code | Description |
|---|---|---|
| Enter | 13 | OK/Select button |
| Back | 8 | Backspace (primary) |
| Back | 27 | Escape (secondary) |
| Left | 37 | Navigate left |
| Up | 38 | Navigate up |
| Right | 39 | Navigate right |
| Down | 40 | Navigate down |
| Play | 415 | Play media |
| Pause | 19 | Pause media |
| Stop | 413 | Stop playback |
| Fast Forward | 417 | Skip forward |
| Rewind | 412 | Skip backward |
Key Code Normalization
Device Information
Access Vidaa-specific device information:Code Example
Complete example for Vidaa platform:Known Limitations
Hardware Constraints
- Lower Processing Power: Vidaa TVs typically use budget chipsets
- Memory Limits: Strict memory constraints compared to premium platforms
- Network Performance: WiFi chips may struggle with high bitrates
Codec Support
- HEVC: Not available on Vidaa 2.x, limited on Vidaa U3
- VP9: Rarely supported
- H.264 Required: Always provide H.264 fallback (mandatory)
- 4K Playback: Unstable on most models, use 1080p maximum
Bitrate Recommendations
- Maximum: 3000 kbps to prevent buffering
- Recommended: 1500-2500 kbps
- Minimum: 800 kbps for smooth playback
Key Mapping Limitations
- No color button support (Red, Green, Yellow, Blue)
- No volume/mute controls exposed to web apps
- No channel up/down controls
- Limited media key support compared to Tizen/WebOS
Video Features
- No HDR: Most Vidaa models lack HDR support
- No Dolby Vision: Not supported
- No Hardware Decode Info: Platform does not expose decode capabilities
- Basic Fullscreen: Limited fullscreen API support
External Links
- Opening external links via
openExternalLink()is not supported - The method will log a warning and return without action
Performance Optimization
Recommended Configuration
Video Encoding Guidelines
For optimal Vidaa playback:- Codec: H.264 Main Profile Level 4.0
- Resolution: 1920x1080 maximum (720p for older models)
- Bitrate: 1500 kbps target, 2500 kbps maximum
- Frame Rate: 30fps (avoid 60fps)
- Audio: AAC-LC, 128 kbps
- Container: MP4
Memory Management
Debugging
Best Practices
- Conservative Bitrates: Always use lower bitrates (1500-2500 kbps)
- H.264 Only: Do not rely on HEVC or VP9 codec support
- Handle Both Back Keys: Support both keyCode 8 and 27 for back button
- Graceful Degradation: Always implement error fallbacks
- Test on Real Hardware: Emulators do not accurately represent Vidaa constraints
- Avoid 4K Content: Use 1080p maximum resolution
- Clean Up Aggressively: Call
sdk.destroy()to free memory - Monitor Performance: Track playback errors and adjust bitrate accordingly
