Titanium SDK 中 Android 广播接收器的深度解析

Titanium SDK 中 Android 广播接收器的深度解析

titanium-sdk 🚀 Native iOS and Android Apps with JavaScript 项目地址: https://gitcode.com/gh_mirrors/ti/titanium-sdk

广播接收器概述

在 Android 开发中，广播接收器(BroadcastReceiver)是一种重要的组件，用于监听和响应系统或应用发出的广播消息。Titanium SDK 通过 Titanium.Android.BroadcastReceiver 模块为开发者提供了这一功能的封装实现。

广播接收器的核心功能

广播接收器主要用来监听两类广播：

1. 系统广播：如网络状态变化、电池电量变化、屏幕开关等系统级事件
2. 自定义广播：其他应用或本应用内部发送的自定义广播消息

创建广播接收器

在 Titanium 中创建广播接收器有两种方式：

1. 使用回调函数

var receiver = Ti.Android.createBroadcastReceiver({
    onReceived: function(e) {
        // 处理广播逻辑
        console.log('收到广播:', e.action);
    }
});

2. 使用外部JS文件

var receiver = Ti.Android.createBroadcastReceiver({
    url: 'broadcastHandler.js'
});

注意：两种方式不能同时使用，如果同时指定了 onReceived 和 url 属性，url 会优先生效。

注册与注销广播接收器

注册广播接收器

Ti.Android.registerBroadcastReceiver(
    receiver, 
    [Ti.Android.ACTION_BATTERY_CHANGED]
);

注销广播接收器

Ti.Android.unregisterBroadcastReceiver(receiver);

广播类型与权限

Titanium SDK 提供了一系列系统广播常量，如：

• ACTION_AIRPLANE_MODE_CHANGED（飞行模式变化）
• ACTION_BATTERY_CHANGED（电池状态变化）
• ACTION_POWER_CONNECTED（电源连接）

对于某些需要特殊权限的广播（如监听来电），需要在 tiapp.xml 中添加相应权限声明：

<ti:app>
    <android>
        <manifest>
            <uses-permission android:name="android.permission.NEW_OUTGOING_CALL" />
        </manifest>
    </android>
</ti:app>

自定义广播

开发者可以定义自己的广播动作，建议使用反向域名格式以避免冲突：

var MY_CUSTOM_ACTION = 'com.example.myapp.CUSTOM_ACTION';

最佳实践

1. 及时注销：不再需要的广播接收器应及时注销，避免内存泄漏
2. 权限管理：只申请必要的广播权限
3. 性能考虑：广播处理应尽量快速完成，避免耗时操作
4. 错误处理：在回调中添加适当的错误处理逻辑

实际应用示例

下面是一个完整的电池状态监听示例：

// 创建接收器
var batteryReceiver = Ti.Android.createBroadcastReceiver({
    onReceived: function(e) {
        var level = e.intent.getIntExtra(Ti.Android.EXTRA_BATTERY_LEVEL, -1);
        var scale = e.intent.getIntExtra(Ti.Android.EXTRA_SCALE, -1);
        var percent = (level / scale) * 100;
        console.log('当前电量: ' + percent + '%');
    }
});

// 注册接收器
Ti.Android.registerBroadcastReceiver(
    batteryReceiver,
    [Ti.Android.ACTION_BATTERY_CHANGED]
);

// 应用退出时注销
Ti.App.addEventListener('close', function() {
    Ti.Android.unregisterBroadcastReceiver(batteryReceiver);
});

通过合理使用广播接收器，开发者可以构建出更加智能、响应式的移动应用，及时感知系统和环境的变化，提供更好的用户体验。

titanium-sdk 🚀 Native iOS and Android Apps with JavaScript 项目地址: https://gitcode.com/gh_mirrors/ti/titanium-sdk