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
