将值传递给接收者 widget

Question

我正在使用 Kotlin 1.9.10 和 Glance 1.0.0 开发一个 Android 小部件应用，希望能够在程序中将小部件固定到主屏幕，并传递更多自定义值。目前，我已经在 onReceive 函数中获取到了刚固定到主屏幕的小部件 ID。

以下是用于将小部件固定到主屏幕的代码：

val appWidgetManager = AppWidgetManager.getInstance(context)
val myProvider = ComponentName(context, MyWidgetReceiver::class.java)

val pinnedWidgetCallbackIntent = Intent(Intent.ACTION_MAIN)
pinnedWidgetCallbackIntent.addCategory(Intent.CATEGORY_HOME)
pinnedWidgetCallbackIntent.flags = Intent.FLAG_ACTIVITY_NEW_TASK

val successCallback = PendingIntent.getActivity(
    context, 0,
    pinnedWidgetCallbackIntent, PendingIntent.FLAG_IMMUTABLE
)

appWidgetManager.requestPinAppWidget(myProvider, null, successCallback)

然后在我的接收器（Receiver）中，重写 onReceive 方法来获取刚刚被固定到主屏幕的小部件 ID：

override fun onReceive(context: Context, intent: Intent) {
    super.onReceive(context, intent)
    if (intent.action == AppWidgetManager.ACTION_APPWIDGET_UPDATE) {
        val extras = intent.extras
        val widgetId = extras?.getIntArray(AppWidgetManager.EXTRA_APPWIDGET_IDS)?.firstOrNull() ?: -1
    }
}

现在的问题是，我希望传递一个额外的值，以便使用小部件 ID 作为键将其保存到本地存储中。请问如何实现这一目标，请帮帮我。

Craig Stuntz · Answer

阅读 Android 文档中关于 requestPinAppWidget的描述，我发现可以将一个 Bundle 对象作为参数传递，而当前你传递的是 null。

因此，您可以将以下代码：

appWidgetManager.requestPinAppWidget(myProvider, null, successCallback)

改为如下所示，以便传递额外数据：

val extras = Bundle().apply {
    putString("key", "value")
}
appWidgetManager.requestPinAppWidget(myProvider, extras, successCallback)

如果你想在小部件固定到主屏幕后处理这些额外的数据，你可以使用 updateAppWidgetOptions方法，并同样传递一个 Bundle 对象。同时，你需要重写 onUpdate 方法，在其中获取并处理这些值：

override fun onUpdate(context: Context, appWidgetManager: AppWidgetManager, appWidgetIds: IntArray) {
    for (appWidgetId in appWidgetIds) {
        val extras = appWidgetManager.getAppWidgetOptions(appWidgetId)
        val value = extras.getString("key")
        // 使用 appWidgetId 和 value 进行后续操作...
    }
}

Tony Delroy · Answer

2000年后的今天，我找到了这个答案。这个解决方案在我遇到的问题上表现得非常好。
参考链接：https://stackoverflow.com/a/47352244/22885025

简而言之：创建一个广播接收器（记得在清单文件中声明）。然后将成功回调设置为使用 PendingIntent.getBroadcast，该广播接收器指向我们自定义的接收器。

val pinnedWidgetCallbackIntent = Intent(context, PinnedWidgetReceiver::class.java)
pinnedWidgetCallbackIntent.putExtras(bundleOf("key" to "value"))

val successCallback = PendingIntent.getBroadcast(
    context, 0,
    pinnedWidgetCallbackIntent, PendingIntent.FLAG_UPDATE_CURRENT
)

appWidgetManager.requestPinAppWidget(myProvider, null, successCallback)

当小部件成功固定到主屏幕时，系统会发送一个包含 widgetId（以及我们传递的值）作为额外数据的广播。在我们自定义的广播接收器（本例中是 PinnedWidgetReceiver）的 onReceive 方法中，我们可以执行所需的任何操作。

class PinnedWidgetReceiver : BroadcastReceiver() {
    override fun onReceive(context: Context?, intent: Intent?) {
        if (intent == null || context == null) return

        val widgetId = intent.getIntExtra(AppWidgetManager.EXTRA_APPWIDGET_ID, -1)
        val widgetName = intent.getStringExtra("key") ?: "default value"
        // 在这里执行所需的操作
    }
}