ui/activity

ui/activity.ActivityLifecycle

继承关系

• EventEmitter

  ↳ ActivityLifecycle

ActivityLifecycle 接口继承自 EventEmitter，用于监听 Activity 的生命周期事件。

目录

方法

• on

方法

on

▸ on(event, listener): ActivityLifecycle

监听 Activity 生命周期事件。ActivityLifecycle 接口继承自 EventEmitter，支持多种生命周期事件。

示例

"nodejs";
const { activityLifecycle } = require("ui/activity");

activityLifecycle.on("activity_created", (activity) => {
    console.log("Activity 已创建:", activity);
});

activityLifecycle.on("activity_resumed", (activity) => {
    console.log("Activity 已恢复:", activity);
});

activityLifecycle.on("activity_destroyed", (activity) => {
    console.log("Activity 已销毁:", activity);
});

事件类型

"activity_created" 事件

当 Activity 被创建时触发。

示例

"nodejs";
const { activityLifecycle } = require("ui/activity");

activityLifecycle.on("activity_created", (activity, savedInstanceState) => {
    console.log("Activity 已创建");
    if (savedInstanceState) {
        console.log("有保存的状态");
    }
});

参数（"activity_created" 事件）

名称	类型	描述
event	"activity_created"	事件名称，固定为 "activity_created"
listener	(activity: Activity, savedInstanceState?: any) => void	监听器函数。当 Activity 被创建时被调用，第一个参数为 Activity 对象，第二个参数为保存的状态（如果有）

返回值

ActivityLifecycle

返回 ActivityLifecycle 对象本身，支持链式调用。

---

"activity_started" 事件

当 Activity 启动时触发。

示例

"nodejs";
const { activityLifecycle } = require("ui/activity");

activityLifecycle.on("activity_started", (activity) => {
    console.log("Activity 已启动");
});

参数（"activity_started" 事件）

名称	类型	描述
event	"activity_started"	事件名称，固定为 "activity_started"
listener	(activity: Activity) => void	监听器函数。当 Activity 启动时被调用，参数为 Activity 对象

返回值

ActivityLifecycle

返回 ActivityLifecycle 对象本身，支持链式调用。

---

"activity_resumed" 事件

当 Activity 恢复时触发（Activity 进入前台并可以与用户交互）。

示例

"nodejs";
const { activityLifecycle } = require("ui/activity");

activityLifecycle.on("activity_resumed", (activity) => {
    console.log("Activity 已恢复，可以交互");
});

参数（"activity_resumed" 事件）

名称	类型	描述
event	"activity_resumed"	事件名称，固定为 "activity_resumed"
listener	(activity: Activity) => void	监听器函数。当 Activity 恢复时被调用，参数为 Activity 对象

返回值

ActivityLifecycle

返回 ActivityLifecycle 对象本身，支持链式调用。

---

"activity_paused" 事件

当 Activity 暂停时触发（Activity 失去焦点但仍可见）。

示例

"nodejs";
const { activityLifecycle } = require("ui/activity");

activityLifecycle.on("activity_paused", (activity) => {
    console.log("Activity 已暂停");
});

参数（"activity_paused" 事件）

名称	类型	描述
event	"activity_paused"	事件名称，固定为 "activity_paused"
listener	(activity: Activity) => void	监听器函数。当 Activity 暂停时被调用，参数为 Activity 对象

返回值

ActivityLifecycle

返回 ActivityLifecycle 对象本身，支持链式调用。

---

"activity_stopped" 事件

当 Activity 停止时触发（Activity 不再可见）。

示例

"nodejs";
const { activityLifecycle } = require("ui/activity");

activityLifecycle.on("activity_stopped", (activity) => {
    console.log("Activity 已停止");
});

参数（"activity_stopped" 事件）

名称	类型	描述
event	"activity_stopped"	事件名称，固定为 "activity_stopped"
listener	(activity: Activity) => void	监听器函数。当 Activity 停止时被调用，参数为 Activity 对象

返回值

ActivityLifecycle

返回 ActivityLifecycle 对象本身，支持链式调用。

---

"activity_save_instance_state" 事件

当 Activity 需要保存状态时触发（例如屏幕旋转时）。

示例

"nodejs";
const { activityLifecycle } = require("ui/activity");

activityLifecycle.on("activity_save_instance_state", (activity, outState) => {
    console.log("保存 Activity 状态");
    // 可以在这里保存自定义状态
});

参数（"activity_save_instance_state" 事件）

名称	类型	描述
event	"activity_save_instance_state"	事件名称，固定为 "activity_save_instance_state"
listener	(activity: Activity, outState: Bundle) => void	监听器函数。当需要保存状态时被调用，第一个参数为 Activity 对象，第二个参数为 Bundle 对象用于保存状态

返回值

ActivityLifecycle

返回 ActivityLifecycle 对象本身，支持链式调用。

---

"activity_destroyed" 事件

当 Activity 被销毁时触发。

示例

"nodejs";
const { activityLifecycle } = require("ui/activity");

activityLifecycle.on("activity_destroyed", (activity) => {
    console.log("Activity 已销毁");
});

参数（"activity_destroyed" 事件）

名称	类型	描述
event	"activity_destroyed"	事件名称，固定为 "activity_destroyed"
listener	(activity: Activity) => void	监听器函数。当 Activity 被销毁时被调用，参数为 Activity 对象

返回值

ActivityLifecycle

返回 ActivityLifecycle 对象本身，支持链式调用。

---

"all_activities_destroyed" 事件

当所有 Activity 都被销毁时触发。

示例

"nodejs";
const { activityLifecycle } = require("ui/activity");

activityLifecycle.on("all_activities_destroyed", () => {
    console.log("所有 Activity 都已销毁");
});

参数（"all_activities_destroyed" 事件）

名称	类型	描述
event	"all_activities_destroyed"	事件名称，固定为 "all_activities_destroyed"
listener	() => void	监听器函数。当所有 Activity 都被销毁时被调用，无参数

返回值

ActivityLifecycle

返回 ActivityLifecycle 对象本身，支持链式调用。