产品介绍

极光桌面OS是专为智能电视、机顶盒、投影仪等大屏设备打造的安卓桌面系统。我们提供完整的开发框架和工具链，帮助开发者快速构建优质的大屏应用体验。

支持的应用类型

法律声明

开发者应确保应用内容符合中华人民共和国法律法规，不侵犯任何第三方权益。平台仅对上传应用进行抽查，开发者对应用内容的合法性承担全部责任。

快速开始

在开始开发之前，请确保您已了解安卓应用开发基础。极光桌面OS基于标准安卓系统，支持所有标准的安卓开发工具和框架。

开发流程

1. 环境准备：安装Android Studio和必要的SDK
2. 项目创建：创建标准的Android项目
3. UI适配：按照大屏设计规范调整界面
4. 功能开发：集成极光桌面OS的SDK
5. 测试验证：在真机或模拟器上测试
6. 应用上传：通过开发者平台提交应用

环境配置

配置标准的Android开发环境即可开始极光桌面OS应用开发。

基础要求

• Android Studio 4.0+
• Android SDK API 21+ (Android 5.0)
• Java 8 或 Kotlin
• Gradle 6.5+

推荐配置

# build.gradle 基础配置
android {
    compileSdkVersion 33
    defaultConfig {
        minSdkVersion 21
        targetSdkVersion 33
        versionCode 1
        versionName "1.0"
    }
}

dependencies {
    implementation 'com.auroraos:core-sdk:2.1.0'
    implementation 'com.auroraos:media-sdk:2.1.0'
}

UI设计规范

为大屏设备设计应用时，需要特别注意用户体验的差异。

布局规范

• 安全区域：保留10%的边距，避免内容被裁剪
• 字体大小：正文至少24sp，标题至少32sp
• 点击目标：最小77x77dp，推荐100x100dp
• 导航焦点：明确的焦点状态和动画效果

遥控器导航

// 处理遥控器按键事件
override fun onKeyDown(keyCode: Int, event: KeyEvent): Boolean {
    return when (keyCode) {
        KeyEvent.KEYCODE_DPAD_CENTER -> {
            // 处理确定键
            true
        }
        KeyEvent.KEYCODE_BACK -> {
            // 处理返回键
            true
        }
        else -> super.onKeyDown(keyCode, event)
    }
}

核心API

极光桌面OS提供丰富的API接口，帮助开发者更好地集成系统功能。

系统信息API

// 获取设备信息
AuroraSystem.getDeviceInfo().thenAccept(deviceInfo -> {
    String model = deviceInfo.getModel();      // 设备型号
    String version = deviceInfo.getOsVersion(); // 系统版本
    String androidId = deviceInfo.getAndroidId(); // 安卓ID
});

窗口管理API

// 创建应用窗口
AuroraWindow.createWindow(activity, config)
    .setTitle("我的应用")
    .setSize(1920, 1080)
    .setResizable(false)
    .show();

主要API参考表

开放平台API

极光桌面OS开放平台提供RESTful API接口，用于应用管理和设备授权验证。

授权验证API

GET /api/open/checkexpiretime?androidid={android_id}

请求示例

// 请求URL
http://os.jxjiguang.com/api/open/checkexpiretime?androidid=0a594ad66543f33e

// 响应示例
{
    "code": 200,
    "time": null,
    "msg": "永久"
}

开放API参考表

应用上传

通过极光桌面OS开发者平台，您可以轻松上传和管理您的应用。

上传要求

• APK文件大小不超过50MB
• 必须包含有效的应用图标
• 支持Android 5.0+系统
• 通过授权验证的设备才能上传

上传流程

1. 验证设备安卓ID授权状态
2. 准备符合规范的APK文件
3. 填写应用基本信息
4. 上传APK文件
5. 等待审核和分发

常见问题

开发相关

• Q: 如何适配不同分辨率的电视？
  A: 使用约束布局和尺寸资源适配，确保在720p、1080p、4K等分辨率下正常显示。
• Q: 遥控器导航有什么注意事项？
  A: 确保所有可点击元素都能通过方向键导航到，并提供清晰的焦点状态反馈。

平台相关

• Q: 应用审核需要多长时间？
  A: 通常需要1-3个工作日，我们会尽快处理您的应用审核请求。
• Q: 如何获取技术支持？
  A: 请联系我们的客服热线：400-872-8680 或通过官方微信获取支持。