react-native-live-widgets 0.0.0-stage → 1.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +13 -0
- package/LICENSE +21 -0
- package/README.md +221 -2
- package/android/build.gradle +49 -0
- package/android/src/main/AndroidManifest.xml +38 -0
- package/android/src/main/java/com/reactnativeliveactivity/bridge/LiveActivityModule.kt +440 -0
- package/android/src/main/java/com/reactnativeliveactivity/bridge/LiveActivityPackage.kt +17 -0
- package/android/src/main/java/com/reactnativeliveactivity/liveactivity/LiveActivityHeadlessTaskService.kt +24 -0
- package/android/src/main/java/com/reactnativeliveactivity/liveactivity/LiveActivityNotifier.kt +410 -0
- package/android/src/main/java/com/reactnativeliveactivity/liveactivity/LiveActivityReceiver.kt +67 -0
- package/android/src/main/java/com/reactnativeliveactivity/renderer/DynamicNodeRegistry.kt +64 -0
- package/android/src/main/java/com/reactnativeliveactivity/renderer/DynamicWidgetCanvasRenderer.kt +1223 -0
- package/android/src/main/java/com/reactnativeliveactivity/storage/DynamicWidgetImageCache.kt +120 -0
- package/android/src/main/java/com/reactnativeliveactivity/storage/DynamicWidgetStateStore.kt +281 -0
- package/android/src/main/java/com/reactnativeliveactivity/widgets/DynamicHomeScreenWidgetProvider.kt +229 -0
- package/android/src/main/res/layout/rn_live_widget_host.xml +113 -0
- package/android/src/main/res/xml/rn_live_widget_info.xml +14 -0
- package/assets/dashboard_features.png +0 -0
- package/assets/dynamic_island_expanded.png +0 -0
- package/assets/home_widget_interactive.png +0 -0
- package/assets/lock_screen_live_activity.png +0 -0
- package/cli/setup.js +94 -0
- package/docs/GUIDE-EN.md +804 -0
- package/docs/GUIDE-VI.md +802 -0
- package/docs/widgets.md +52 -0
- package/ios/Bridge/LiveActivityModule.m +105 -0
- package/ios/Bridge/LiveActivityModule.swift +957 -0
- package/ios/Intents/DynamicWidgetActionIntent.swift +38 -0
- package/ios/Models/DynamicActivityAttributes.swift +22 -0
- package/ios/Models/DynamicLayoutModels.swift +243 -0
- package/ios/Renderer/ColorHexExtension.swift +49 -0
- package/ios/Renderer/DynamicNodeRegistry.swift +54 -0
- package/ios/Renderer/DynamicNodeView.swift +1060 -0
- package/ios/Storage/DynamicWidgetImageCache.swift +137 -0
- package/ios/Storage/DynamicWidgetStateStore.swift +162 -0
- package/ios/Widgets/DynamicHomeScreenWidget.swift +435 -0
- package/ios/Widgets/DynamicLiveActivityWidget.swift +79 -0
- package/lib/builder.d.ts +60 -0
- package/lib/builder.d.ts.map +1 -0
- package/lib/builder.js +296 -0
- package/lib/builder.js.map +1 -0
- package/lib/dispatcher.d.ts +16 -0
- package/lib/dispatcher.d.ts.map +1 -0
- package/lib/dispatcher.js +23 -0
- package/lib/dispatcher.js.map +1 -0
- package/lib/index.d.ts +199 -0
- package/lib/index.d.ts.map +1 -0
- package/lib/index.js +634 -0
- package/lib/index.js.map +1 -0
- package/lib/types.d.ts +489 -0
- package/lib/types.d.ts.map +1 -0
- package/lib/types.js +10 -0
- package/lib/types.js.map +1 -0
- package/package.json +68 -4
- package/react-native-live-widgets.podspec +38 -0
- package/src/builder.ts +409 -0
- package/src/dispatcher.ts +25 -0
- package/src/index.ts +681 -0
- package/src/types.ts +595 -0
package/lib/builder.js
ADDED
|
@@ -0,0 +1,296 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.UI = exports.StyleSheet = void 0;
|
|
4
|
+
exports.flattenStyle = flattenStyle;
|
|
5
|
+
const dispatcher_1 = require("./dispatcher");
|
|
6
|
+
let autoActionCounter = 0;
|
|
7
|
+
function flattenStyle(...styles) {
|
|
8
|
+
let merged = undefined;
|
|
9
|
+
function walk(item) {
|
|
10
|
+
if (!item)
|
|
11
|
+
return;
|
|
12
|
+
if (Array.isArray(item)) {
|
|
13
|
+
for (const sub of item)
|
|
14
|
+
walk(sub);
|
|
15
|
+
}
|
|
16
|
+
else if (typeof item === 'object') {
|
|
17
|
+
if (!merged)
|
|
18
|
+
merged = {};
|
|
19
|
+
Object.assign(merged, item);
|
|
20
|
+
}
|
|
21
|
+
}
|
|
22
|
+
for (const s of styles) {
|
|
23
|
+
walk(s);
|
|
24
|
+
}
|
|
25
|
+
return merged;
|
|
26
|
+
}
|
|
27
|
+
exports.StyleSheet = {
|
|
28
|
+
create: (styles) => styles,
|
|
29
|
+
flatten: flattenStyle,
|
|
30
|
+
};
|
|
31
|
+
function isLayoutNode(item) {
|
|
32
|
+
return item && typeof item === 'object' && typeof item.type === 'string';
|
|
33
|
+
}
|
|
34
|
+
function parseContainerArgs(first, rest) {
|
|
35
|
+
if (!first) {
|
|
36
|
+
return { props: undefined, children: [] };
|
|
37
|
+
}
|
|
38
|
+
if (Array.isArray(first)) {
|
|
39
|
+
if (first.length > 0 && isLayoutNode(first[0])) {
|
|
40
|
+
return { props: undefined, children: first };
|
|
41
|
+
}
|
|
42
|
+
const flattened = flattenStyle(first);
|
|
43
|
+
return { props: flattened, children: rest || [] };
|
|
44
|
+
}
|
|
45
|
+
if (isLayoutNode(first)) {
|
|
46
|
+
return { props: undefined, children: [first, ...(rest || [])] };
|
|
47
|
+
}
|
|
48
|
+
return { props: first, children: rest || [] };
|
|
49
|
+
}
|
|
50
|
+
/**
|
|
51
|
+
* Các hàm helper tạo node cây giao diện trực quan cho TypeScript/JavaScript
|
|
52
|
+
*/
|
|
53
|
+
exports.UI = {
|
|
54
|
+
StyleSheet: exports.StyleSheet,
|
|
55
|
+
VStack: (propsOrChildren, ...children) => {
|
|
56
|
+
const { props, children: parsedChildren } = parseContainerArgs(propsOrChildren, children);
|
|
57
|
+
return {
|
|
58
|
+
type: 'VStack',
|
|
59
|
+
props,
|
|
60
|
+
children: parsedChildren,
|
|
61
|
+
};
|
|
62
|
+
},
|
|
63
|
+
HStack: (propsOrChildren, ...children) => {
|
|
64
|
+
const { props, children: parsedChildren } = parseContainerArgs(propsOrChildren, children);
|
|
65
|
+
return {
|
|
66
|
+
type: 'HStack',
|
|
67
|
+
props,
|
|
68
|
+
children: parsedChildren,
|
|
69
|
+
};
|
|
70
|
+
},
|
|
71
|
+
Text: (text, ...styles) => {
|
|
72
|
+
const merged = flattenStyle(...styles);
|
|
73
|
+
return {
|
|
74
|
+
type: 'Text',
|
|
75
|
+
props: {
|
|
76
|
+
text,
|
|
77
|
+
...(merged || {}),
|
|
78
|
+
},
|
|
79
|
+
};
|
|
80
|
+
},
|
|
81
|
+
Timer: (targetTimestamp, options) => ({
|
|
82
|
+
type: 'Timer',
|
|
83
|
+
props: {
|
|
84
|
+
targetTimestamp,
|
|
85
|
+
mode: options?.mode ?? 'countdown',
|
|
86
|
+
...options,
|
|
87
|
+
},
|
|
88
|
+
}),
|
|
89
|
+
Progress: (valueOrOptions, options) => {
|
|
90
|
+
if (typeof valueOrOptions === 'number') {
|
|
91
|
+
return {
|
|
92
|
+
type: 'Progress',
|
|
93
|
+
props: {
|
|
94
|
+
value: valueOrOptions,
|
|
95
|
+
...options,
|
|
96
|
+
},
|
|
97
|
+
};
|
|
98
|
+
}
|
|
99
|
+
return {
|
|
100
|
+
type: 'Progress',
|
|
101
|
+
props: valueOrOptions,
|
|
102
|
+
};
|
|
103
|
+
},
|
|
104
|
+
Image: (urlOrOptions, options) => {
|
|
105
|
+
if (typeof urlOrOptions === 'string') {
|
|
106
|
+
const isHttp = urlOrOptions.startsWith('http://') || urlOrOptions.startsWith('https://');
|
|
107
|
+
const isBase64 = urlOrOptions.startsWith('data:image/');
|
|
108
|
+
return {
|
|
109
|
+
type: 'Image',
|
|
110
|
+
props: {
|
|
111
|
+
...(isHttp
|
|
112
|
+
? { url: urlOrOptions }
|
|
113
|
+
: isBase64
|
|
114
|
+
? { base64: urlOrOptions }
|
|
115
|
+
: { systemName: urlOrOptions }),
|
|
116
|
+
...options,
|
|
117
|
+
},
|
|
118
|
+
};
|
|
119
|
+
}
|
|
120
|
+
return {
|
|
121
|
+
type: 'Image',
|
|
122
|
+
props: urlOrOptions,
|
|
123
|
+
};
|
|
124
|
+
},
|
|
125
|
+
Spacer: (minLength) => ({
|
|
126
|
+
type: 'Spacer',
|
|
127
|
+
props: { minLength },
|
|
128
|
+
}),
|
|
129
|
+
Button: (titleOrProps, options) => {
|
|
130
|
+
if (typeof titleOrProps === 'object' && titleOrProps !== null) {
|
|
131
|
+
if (titleOrProps.onPress && !titleOrProps.actionId) {
|
|
132
|
+
autoActionCounter += 1;
|
|
133
|
+
titleOrProps.actionId = `act_${Date.now()}_${autoActionCounter}`;
|
|
134
|
+
(0, dispatcher_1.registerAction)(titleOrProps.actionId, titleOrProps.onPress);
|
|
135
|
+
}
|
|
136
|
+
else if (titleOrProps.onPress && titleOrProps.actionId) {
|
|
137
|
+
(0, dispatcher_1.registerAction)(titleOrProps.actionId, titleOrProps.onPress);
|
|
138
|
+
}
|
|
139
|
+
return {
|
|
140
|
+
type: 'Button',
|
|
141
|
+
props: titleOrProps,
|
|
142
|
+
};
|
|
143
|
+
}
|
|
144
|
+
let finalActionId = options?.actionId;
|
|
145
|
+
if (options?.onPress) {
|
|
146
|
+
if (!finalActionId) {
|
|
147
|
+
autoActionCounter += 1;
|
|
148
|
+
finalActionId = `act_${Date.now()}_${autoActionCounter}`;
|
|
149
|
+
}
|
|
150
|
+
(0, dispatcher_1.registerAction)(finalActionId, options.onPress);
|
|
151
|
+
}
|
|
152
|
+
return {
|
|
153
|
+
type: 'Button',
|
|
154
|
+
props: {
|
|
155
|
+
title: titleOrProps,
|
|
156
|
+
...options,
|
|
157
|
+
actionId: finalActionId,
|
|
158
|
+
},
|
|
159
|
+
};
|
|
160
|
+
},
|
|
161
|
+
/**
|
|
162
|
+
* Tạo nút bấm kèm logic hàm TypeScript trực tiếp.
|
|
163
|
+
* Thư viện tự động sinh ActionId và kết nối bộ lắng nghe Native -> hàm async TypeScript của bạn!
|
|
164
|
+
*/
|
|
165
|
+
ActionButton: (title, onPress, options) => {
|
|
166
|
+
autoActionCounter += 1;
|
|
167
|
+
const actionId = `act_${Date.now()}_${autoActionCounter}`;
|
|
168
|
+
(0, dispatcher_1.registerAction)(actionId, onPress);
|
|
169
|
+
return {
|
|
170
|
+
type: 'Button',
|
|
171
|
+
props: {
|
|
172
|
+
title,
|
|
173
|
+
actionId,
|
|
174
|
+
onPress,
|
|
175
|
+
...options,
|
|
176
|
+
},
|
|
177
|
+
};
|
|
178
|
+
},
|
|
179
|
+
ZStack: (propsOrChildren, ...children) => {
|
|
180
|
+
const { props, children: parsedChildren } = parseContainerArgs(propsOrChildren, children);
|
|
181
|
+
return {
|
|
182
|
+
type: 'ZStack',
|
|
183
|
+
props: props,
|
|
184
|
+
children: parsedChildren,
|
|
185
|
+
};
|
|
186
|
+
},
|
|
187
|
+
Grid: (propsOrChildren, ...children) => {
|
|
188
|
+
const { props, children: parsedChildren } = parseContainerArgs(propsOrChildren, children);
|
|
189
|
+
return {
|
|
190
|
+
type: 'Grid',
|
|
191
|
+
props: props,
|
|
192
|
+
children: parsedChildren,
|
|
193
|
+
};
|
|
194
|
+
},
|
|
195
|
+
Divider: (options) => ({
|
|
196
|
+
type: 'Divider',
|
|
197
|
+
props: options,
|
|
198
|
+
}),
|
|
199
|
+
Gauge: (valueOrOptions, options) => {
|
|
200
|
+
if (typeof valueOrOptions === 'number') {
|
|
201
|
+
return {
|
|
202
|
+
type: 'Gauge',
|
|
203
|
+
props: {
|
|
204
|
+
value: valueOrOptions,
|
|
205
|
+
...options,
|
|
206
|
+
},
|
|
207
|
+
};
|
|
208
|
+
}
|
|
209
|
+
return {
|
|
210
|
+
type: 'Gauge',
|
|
211
|
+
props: valueOrOptions,
|
|
212
|
+
};
|
|
213
|
+
},
|
|
214
|
+
Chart: (valuesOrOptions, options) => {
|
|
215
|
+
if (Array.isArray(valuesOrOptions)) {
|
|
216
|
+
return {
|
|
217
|
+
type: 'Chart',
|
|
218
|
+
props: {
|
|
219
|
+
values: valuesOrOptions,
|
|
220
|
+
...options,
|
|
221
|
+
},
|
|
222
|
+
};
|
|
223
|
+
}
|
|
224
|
+
return {
|
|
225
|
+
type: 'Chart',
|
|
226
|
+
props: valuesOrOptions,
|
|
227
|
+
};
|
|
228
|
+
},
|
|
229
|
+
Toggle: (labelOrOptions, options) => {
|
|
230
|
+
if (typeof labelOrOptions === 'string') {
|
|
231
|
+
return {
|
|
232
|
+
type: 'Toggle',
|
|
233
|
+
props: {
|
|
234
|
+
label: labelOrOptions,
|
|
235
|
+
actionId: options?.actionId ?? 'toggle:default',
|
|
236
|
+
...options,
|
|
237
|
+
},
|
|
238
|
+
};
|
|
239
|
+
}
|
|
240
|
+
return {
|
|
241
|
+
type: 'Toggle',
|
|
242
|
+
props: labelOrOptions,
|
|
243
|
+
};
|
|
244
|
+
},
|
|
245
|
+
Badge: (textOrOptions, options) => {
|
|
246
|
+
if (typeof textOrOptions === 'string') {
|
|
247
|
+
return {
|
|
248
|
+
type: 'Badge',
|
|
249
|
+
props: {
|
|
250
|
+
text: textOrOptions,
|
|
251
|
+
...options,
|
|
252
|
+
},
|
|
253
|
+
};
|
|
254
|
+
}
|
|
255
|
+
return {
|
|
256
|
+
type: 'Badge',
|
|
257
|
+
props: textOrOptions,
|
|
258
|
+
};
|
|
259
|
+
},
|
|
260
|
+
Link: (props, ...children) => ({
|
|
261
|
+
type: 'Link',
|
|
262
|
+
props,
|
|
263
|
+
children,
|
|
264
|
+
}),
|
|
265
|
+
/**
|
|
266
|
+
* Khởi tạo một Component Native tùy chỉnh đã được đăng ký qua:
|
|
267
|
+
* - iOS (Swift): `DynamicNodeRegistry.shared.register("MyComponent") { node in ... }`
|
|
268
|
+
* - Android (Kotlin): `DynamicNodeRegistry.register("MyComponent", ...)`
|
|
269
|
+
*/
|
|
270
|
+
Custom: (componentName, props, ...children) => ({
|
|
271
|
+
type: 'Custom',
|
|
272
|
+
props: {
|
|
273
|
+
...props,
|
|
274
|
+
componentName,
|
|
275
|
+
},
|
|
276
|
+
children: children.length > 0 ? children : undefined,
|
|
277
|
+
}),
|
|
278
|
+
/**
|
|
279
|
+
* Component sóng nhạc chuyển động (Equalizer / Sound Visualizer):
|
|
280
|
+
* Tự động chạy animation nhịp sóng nhạc mượt mà trên Dynamic Island và Lock Screen (iOS)
|
|
281
|
+
* và hiển thị trực quan trên Android.
|
|
282
|
+
*/
|
|
283
|
+
Equalizer: (options) => ({
|
|
284
|
+
type: 'Equalizer',
|
|
285
|
+
props: {
|
|
286
|
+
isPlaying: true,
|
|
287
|
+
barCount: 4,
|
|
288
|
+
tintColor: '#10B981',
|
|
289
|
+
height: 16,
|
|
290
|
+
barWidth: 3,
|
|
291
|
+
spacing: 2,
|
|
292
|
+
...options,
|
|
293
|
+
},
|
|
294
|
+
}),
|
|
295
|
+
};
|
|
296
|
+
//# sourceMappingURL=builder.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"builder.js","sourceRoot":"","sources":["../src/builder.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
export type ActionHandler = (event: {
|
|
2
|
+
actionId: string;
|
|
3
|
+
activityId?: string;
|
|
4
|
+
[key: string]: any;
|
|
5
|
+
}) => Promise<any> | any;
|
|
6
|
+
export declare const actionHandlers: Map<string, ActionHandler>;
|
|
7
|
+
/**
|
|
8
|
+
* Đăng ký một hàm xử lý logic TypeScript khi người dùng bấm nút có `actionId` tương ứng ngoài Widget/Live Activity.
|
|
9
|
+
* Trả về hàm hủy đăng ký (unsubscribe).
|
|
10
|
+
*/
|
|
11
|
+
export declare function registerAction(actionId: string, handler: ActionHandler): () => void;
|
|
12
|
+
/**
|
|
13
|
+
* Hủy đăng ký action handler.
|
|
14
|
+
*/
|
|
15
|
+
export declare function unregisterAction(actionId: string): void;
|
|
16
|
+
//# sourceMappingURL=dispatcher.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"dispatcher.d.ts","sourceRoot":"","sources":["../src/dispatcher.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB,KAAK,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;AAEzB,eAAO,MAAM,cAAc,4BAAmC,CAAC;AAE/D;;;GAGG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,MAAM,IAAI,CAKnF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAEvD"}
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.actionHandlers = void 0;
|
|
4
|
+
exports.registerAction = registerAction;
|
|
5
|
+
exports.unregisterAction = unregisterAction;
|
|
6
|
+
exports.actionHandlers = new Map();
|
|
7
|
+
/**
|
|
8
|
+
* Đăng ký một hàm xử lý logic TypeScript khi người dùng bấm nút có `actionId` tương ứng ngoài Widget/Live Activity.
|
|
9
|
+
* Trả về hàm hủy đăng ký (unsubscribe).
|
|
10
|
+
*/
|
|
11
|
+
function registerAction(actionId, handler) {
|
|
12
|
+
exports.actionHandlers.set(actionId, handler);
|
|
13
|
+
return () => {
|
|
14
|
+
exports.actionHandlers.delete(actionId);
|
|
15
|
+
};
|
|
16
|
+
}
|
|
17
|
+
/**
|
|
18
|
+
* Hủy đăng ký action handler.
|
|
19
|
+
*/
|
|
20
|
+
function unregisterAction(actionId) {
|
|
21
|
+
exports.actionHandlers.delete(actionId);
|
|
22
|
+
}
|
|
23
|
+
//# sourceMappingURL=dispatcher.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"dispatcher.js","sourceRoot":"","sources":["../src/dispatcher.ts"],"names":[],"mappings":";;;AAYA,wCAKC;AAKD,4CAEC;AAlBY,QAAA,cAAc,GAAG,IAAI,GAAG,EAAyB,CAAC;AAE/D;;;GAGG;AACH,SAAgB,cAAc,CAAC,QAAgB,EAAE,OAAsB;IACrE,sBAAc,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACtC,OAAO,GAAG,EAAE;QACV,sBAAc,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAClC,CAAC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAgB,gBAAgB,CAAC,QAAgB;IAC/C,sBAAc,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AAClC,CAAC"}
|
package/lib/index.d.ts
ADDED
|
@@ -0,0 +1,199 @@
|
|
|
1
|
+
import { ActiveActivityInfo, EndActivityOptions, LiveActivityPushTokens, StartActivityOptions, UpdateActivityOptions, WidgetConfigOption, WidgetLayoutConfig, WidgetRemoteConfig, WidgetTimelineConfig } from './types';
|
|
2
|
+
import { ActionHandler, registerAction, unregisterAction } from './dispatcher';
|
|
3
|
+
export type { ActionHandler };
|
|
4
|
+
export { registerAction, unregisterAction };
|
|
5
|
+
export declare const LiveActivity: {
|
|
6
|
+
/**
|
|
7
|
+
* Khởi động một Live Activity (iOS) hoặc Live Update / Ongoing Notification (Android).
|
|
8
|
+
*/
|
|
9
|
+
start: (options: StartActivityOptions) => Promise<boolean>;
|
|
10
|
+
/**
|
|
11
|
+
* Cập nhật nội dung Live Activity hiện tại.
|
|
12
|
+
*/
|
|
13
|
+
update: (options: UpdateActivityOptions) => Promise<boolean>;
|
|
14
|
+
/**
|
|
15
|
+
* Kết thúc một Live Activity cụ thể theo activityId với các chính sách linh hoạt (Dismissal Policy & Final Summary Layout).
|
|
16
|
+
*/
|
|
17
|
+
end: (activityId: string, options?: EndActivityOptions) => Promise<boolean>;
|
|
18
|
+
/**
|
|
19
|
+
* Tắt tất cả Live Activity / Live Update của ứng dụng.
|
|
20
|
+
*/
|
|
21
|
+
endAll: () => Promise<boolean>;
|
|
22
|
+
/**
|
|
23
|
+
* Đăng ký và lấy Push Token của thiết bị (APNs Device Token trên iOS / FCM Device Token trên Android).
|
|
24
|
+
*/
|
|
25
|
+
getDevicePushToken: () => Promise<string | undefined>;
|
|
26
|
+
/**
|
|
27
|
+
* Lấy Push-to-Start token để backend kích hoạt mở mới Live Activity / Live Update từ xa.
|
|
28
|
+
*/
|
|
29
|
+
getPushToStartToken: () => Promise<string | undefined>;
|
|
30
|
+
/**
|
|
31
|
+
* Lấy Update Push Token của một phiên Live Activity / Live Update đang chạy (theo activityId)
|
|
32
|
+
* để backend gửi bản cập nhật ("event": "update") hoặc kết thúc ("event": "end").
|
|
33
|
+
*/
|
|
34
|
+
getActivityPushToken: (activityId: string) => Promise<string | undefined>;
|
|
35
|
+
/**
|
|
36
|
+
* Lấy trọn bộ cả 3 loại Push Token trong 1 lần gọi (hỗ trợ cả iOS APNs & Android):
|
|
37
|
+
* - `devicePushToken`: Token của máy
|
|
38
|
+
* - `pushToStartToken`: Token mở mới Live Activity / Live Update từ xa
|
|
39
|
+
* - `activityUpdateToken`: Token cập nhật phiên Live Activity đang chạy
|
|
40
|
+
*/
|
|
41
|
+
getAllPushTokens: (activityId?: string) => Promise<LiveActivityPushTokens>;
|
|
42
|
+
/**
|
|
43
|
+
* Lắng nghe khi hệ điều hành cấp mới hoặc thay đổi Device Push Token của máy.
|
|
44
|
+
*/
|
|
45
|
+
onDevicePushTokenChange: (listener: (token: string) => void) => (() => void);
|
|
46
|
+
/**
|
|
47
|
+
* Lắng nghe khi hệ điều hành cấp hoặc xoay Push-to-Start Token mới.
|
|
48
|
+
*/
|
|
49
|
+
onPushToStartTokenChange: (listener: (token: string) => void) => (() => void);
|
|
50
|
+
/**
|
|
51
|
+
* Lắng nghe khi hệ điều hành cấp hoặc xoay Update Token cho một Live Activity cụ thể.
|
|
52
|
+
* Trả về `{ activityId, token }` để gửi ngay lên Backend.
|
|
53
|
+
*/
|
|
54
|
+
onActivityUpdateTokenChange: (listener: (event: {
|
|
55
|
+
activityId: string;
|
|
56
|
+
token: string;
|
|
57
|
+
}) => void) => (() => void);
|
|
58
|
+
/**
|
|
59
|
+
* Đăng ký một hàm xử lý logic TypeScript khi người dùng bấm nút có `actionId` tương ứng ngoài Widget/Live Activity.
|
|
60
|
+
* Hoạt động mượt mà cả khi App đang mở lẫn chạy ngầm.
|
|
61
|
+
* Trả về hàm hủy đăng ký (unsubscribe).
|
|
62
|
+
*/
|
|
63
|
+
registerAction: (actionId: string, handler: ActionHandler) => (() => void);
|
|
64
|
+
/**
|
|
65
|
+
* Hủy đăng ký action handler theo `actionId`.
|
|
66
|
+
*/
|
|
67
|
+
unregisterAction: (actionId: string) => void;
|
|
68
|
+
/**
|
|
69
|
+
* Lấy danh sách các phiên Live Activity đang chạy trên thiết bị (ID và Push Token).
|
|
70
|
+
* Giúp ứng dụng khôi phục lại trạng thái giao diện khi mở lại App.
|
|
71
|
+
*/
|
|
72
|
+
getActiveActivities: () => Promise<ActiveActivityInfo[]>;
|
|
73
|
+
/**
|
|
74
|
+
* Kiểm tra xem người dùng có cấp quyền Hoạt động trực tiếp (Live Activities) trong Cài đặt máy hay không.
|
|
75
|
+
*/
|
|
76
|
+
areActivitiesEnabled: () => Promise<boolean>;
|
|
77
|
+
/**
|
|
78
|
+
* iOS 16.2+: Kiểm tra xem người dùng có bật tùy chọn nhận cập nhật đẩy APNs tần suất cao (Frequent Pushes) hay không.
|
|
79
|
+
*/
|
|
80
|
+
areFrequentPushesEnabled: () => Promise<boolean>;
|
|
81
|
+
/**
|
|
82
|
+
* Lắng nghe khi người dùng bấm vào một Action Button.
|
|
83
|
+
*/
|
|
84
|
+
onActionClicked: (listener: (actionId: string, activityId: string) => void) => (() => void);
|
|
85
|
+
/**
|
|
86
|
+
* Android 16+: Kiểm tra quyền Promoted Ongoing Notifications.
|
|
87
|
+
*/
|
|
88
|
+
canPostPromoted: () => Promise<boolean>;
|
|
89
|
+
/**
|
|
90
|
+
* Đăng ký tác vụ chạy ngầm xử lý tương tác nút bấm trên Widget (Headless JS / Background Action Task).
|
|
91
|
+
* Hoạt động ngay cả khi App chính đã bị người dùng vuốt đóng (Killed).
|
|
92
|
+
*/
|
|
93
|
+
registerBackgroundActionHandler: (handler?: (actionId: string, activityId?: string) => Promise<void> | void) => void;
|
|
94
|
+
};
|
|
95
|
+
export declare const Widget: {
|
|
96
|
+
/**
|
|
97
|
+
* Yêu cầu hệ điều hành iOS và Android vẽ lại toàn bộ Home Screen Widgets ngay lập tức.
|
|
98
|
+
*/
|
|
99
|
+
reloadAll: () => Promise<boolean>;
|
|
100
|
+
/**
|
|
101
|
+
* Yêu cầu vẽ lại một Widget cụ thể theo kind (hỗ trợ cả iOS và Android).
|
|
102
|
+
*/
|
|
103
|
+
reload: (kind: string) => Promise<boolean>;
|
|
104
|
+
/**
|
|
105
|
+
* Thiết lập layout động cho Home Screen Widget (hỗ trợ small, medium, large).
|
|
106
|
+
* Tự động lưu vào Shared Storage và yêu cầu vẽ lại.
|
|
107
|
+
*/
|
|
108
|
+
setLayout: (widgetKey: string, layoutConfig: WidgetLayoutConfig, appGroup?: string) => Promise<boolean>;
|
|
109
|
+
/**
|
|
110
|
+
* Thiết lập dòng thời gian tự động (Timeline Entries) cho Widget.
|
|
111
|
+
* Hệ điều hành iOS/Android sẽ tự động chuyển đổi giữa các layout theo từng mốc thời gian
|
|
112
|
+
* mà KHÔNG tốn pin, không cần ứng dụng mở hay chạy ngầm.
|
|
113
|
+
*/
|
|
114
|
+
setTimeline: (widgetKey: string, timelineConfig: WidgetTimelineConfig, appGroup?: string) => Promise<boolean>;
|
|
115
|
+
/**
|
|
116
|
+
* Cung cấp danh sách các tùy chọn cấu hình cho Widget (dành cho tính năng Edit Widget / AppIntent Configuration).
|
|
117
|
+
* Ví dụ: Danh sách các Dự án, Chi nhánh, Ca làm để người dùng chọn khi nhấn giữ Widget ngoài Home Screen.
|
|
118
|
+
*/
|
|
119
|
+
setConfigurationOptions: (widgetKey: string, options: WidgetConfigOption[], appGroup?: string) => Promise<boolean>;
|
|
120
|
+
/**
|
|
121
|
+
* Lấy ID tùy chọn cấu hình đang được người dùng chọn ghim trên Widget.
|
|
122
|
+
*/
|
|
123
|
+
getSelectedConfiguration: (widgetKey: string, appGroup?: string) => Promise<string | null>;
|
|
124
|
+
/**
|
|
125
|
+
* Thiết lập lựa chọn cấu hình cho Widget từ trong ứng dụng.
|
|
126
|
+
*/
|
|
127
|
+
setSelectedConfiguration: (widgetKey: string, selectedId: string, appGroup?: string) => Promise<boolean>;
|
|
128
|
+
/**
|
|
129
|
+
* Cấu hình Endpoint API để bản thân Widget Extension tự chạy ngầm lấy dữ liệu mới
|
|
130
|
+
* theo chu kỳ (`getTimeline`) hoặc khi bấm nút `actionId: 'refresh'` trên mặt Widget,
|
|
131
|
+
* kể cả khi người dùng đã vuốt tắt (Kill) hoàn toàn ứng dụng chính!
|
|
132
|
+
*/
|
|
133
|
+
setRemoteConfig: (widgetKey: string, remoteConfig: WidgetRemoteConfig, appGroup?: string) => Promise<boolean>;
|
|
134
|
+
/**
|
|
135
|
+
* (Android 8.0+) Mở hộp thoại hệ thống cho phép người dùng ghim trực tiếp Tiện ích ra màn hình chính ngay từ trong ứng dụng.
|
|
136
|
+
* Trên iOS, hàm trả về false vì Apple chỉ cho phép người dùng tự thêm tiện ích từ thư viện Widget của hệ điều hành.
|
|
137
|
+
*/
|
|
138
|
+
requestPin: () => Promise<boolean>;
|
|
139
|
+
/**
|
|
140
|
+
* Kiểm tra xem thiết bị hiện tại có hỗ trợ ghim Tiện ích trực tiếp từ trong ứng dụng hay không (Chỉ Android API 26+).
|
|
141
|
+
*/
|
|
142
|
+
isPinSupported: () => Promise<boolean>;
|
|
143
|
+
};
|
|
144
|
+
export declare const SharedStorage: {
|
|
145
|
+
/**
|
|
146
|
+
* Lưu dữ liệu vào App Group (iOS) hoặc SharedPreferences (Android) để Widget đọc.
|
|
147
|
+
*/
|
|
148
|
+
set: (key: string, value: any, appGroup?: string) => Promise<boolean>;
|
|
149
|
+
/**
|
|
150
|
+
* Đọc dữ liệu từ App Group hoặc SharedPreferences.
|
|
151
|
+
*/
|
|
152
|
+
get: <T = any>(key: string, appGroup?: string) => Promise<T | null>;
|
|
153
|
+
/**
|
|
154
|
+
* Xóa 1 giá trị theo key.
|
|
155
|
+
*/
|
|
156
|
+
remove: (key: string, appGroup?: string) => Promise<boolean>;
|
|
157
|
+
/**
|
|
158
|
+
* Xóa sạch toàn bộ dữ liệu trong App Group.
|
|
159
|
+
*/
|
|
160
|
+
clear: (appGroup?: string) => Promise<boolean>;
|
|
161
|
+
};
|
|
162
|
+
export interface AudioPlayerStatus {
|
|
163
|
+
isPlaying: boolean;
|
|
164
|
+
currentTime: number;
|
|
165
|
+
duration: number;
|
|
166
|
+
}
|
|
167
|
+
export interface AudioTrackMetadata {
|
|
168
|
+
title?: string;
|
|
169
|
+
artist?: string;
|
|
170
|
+
artworkUrl?: string;
|
|
171
|
+
duration?: number;
|
|
172
|
+
}
|
|
173
|
+
export declare const AudioPlayer: {
|
|
174
|
+
/**
|
|
175
|
+
* Phát nhạc trực tiếp từ URL (hỗ trợ stream mp3, m4a, aac, wav...)
|
|
176
|
+
* và đăng ký hệ thống Now Playing của iOS (hiện trên Dynamic Island & Lock Screen như Spotify).
|
|
177
|
+
*/
|
|
178
|
+
play: (url: string, metadata?: AudioTrackMetadata) => Promise<boolean>;
|
|
179
|
+
/**
|
|
180
|
+
* Tạm dừng bài nhạc đang phát.
|
|
181
|
+
*/
|
|
182
|
+
pause: () => Promise<boolean>;
|
|
183
|
+
/**
|
|
184
|
+
* Tiếp tục phát bài nhạc sau khi tạm dừng.
|
|
185
|
+
*/
|
|
186
|
+
resume: () => Promise<boolean>;
|
|
187
|
+
/**
|
|
188
|
+
* Dừng hẳn bài nhạc và giải phóng tài nguyên phát.
|
|
189
|
+
*/
|
|
190
|
+
stop: () => Promise<boolean>;
|
|
191
|
+
/**
|
|
192
|
+
* Lấy trạng thái hiện tại của trình phát nhạc (đang phát, thời lượng, vị trí phát).
|
|
193
|
+
*/
|
|
194
|
+
getStatus: () => Promise<AudioPlayerStatus>;
|
|
195
|
+
};
|
|
196
|
+
export * from './types';
|
|
197
|
+
export * from './builder';
|
|
198
|
+
export { StyleSheet } from './builder';
|
|
199
|
+
//# sourceMappingURL=index.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
|