应用间通信模块

数据结构

`ESIACMessage`

应用间通信消息

参数	描述	类型	非空
action	事件名称	`string`	是
package	需要接受事件的快应用包名	`string`	否
extras	其他信息	`anny`	否

`ESIACMessageFilter`

应用间通信消息过滤器

参数	描述	类型	非空
action	需要接受的事件列表	`Array<string>`	是

接口

`sendMessage`

该方法发送消息。

完整方法声明：function sendMessage(message: ESIACMessage): Promise<boolean>

参数：

参数	描述	类型	非空
message	消息	`ESIACMessage`	是

返回值：

属性	描述	类型	默认值
无	是否成功	`Promise<boolean>`

`registerReceiver`

该方法注册消息监听。

完整方法声明：function registerReceiver(receiver: ESIACReceiver, messageFilter: ESIACMessageFilter): void

参数：

参数	描述	类型	非空
receiver	消息接受者	`ESIACReceiver`	是
messageFilter	消息过滤器	`ESIACMessageFilter`	是

返回值：

属性	描述	类型	默认值
无	无	`void`

`unregisterReceiver`

该方法取消注册消息监听。

完整方法声明：function unregisterReceiver(receiver: ESIACReceiver): void

参数：

参数	描述	类型	非空
receiver	消息接受者	`ESIACReceiver`	是

返回值：

属性	描述	类型	默认值
无	无	`void`

基础用法

代码示例：

点击查看源码

TypeScript

vue

<template>
	<div class='es-sdk-root-css'>
		<s-title-view class='es-sdk-content-title-css' :text='this.$options.name' />
		<div class='es-sdk-content-divider-css' />
		<div class='es-sdk-content-column-css'>
			<div class='es-sdk-content-row-css'>
				<s-text-button text='发送给所有应用消息A' @onButtonClicked='onSendMessageAButtonClicked' />
				<s-text-button text='注册消息接受者A' @onButtonClicked='onRegisterReceiverAButtonClicked' />
				<s-text-button text='取消注册消息接受者A' @onButtonClicked='onUnregisterReceiverAButtonClicked' />
			</div>
			<div class='es-sdk-content-row-css'>
				<s-text-button text='发送给所有应用消息B' @onButtonClicked='onSendMessageBButtonClicked' />
				<s-text-button text='注册消息接受者B' @onButtonClicked='onRegisterReceiverBButtonClicked' />
				<s-text-button text='取消注册消息接受者B' @onButtonClicked='onUnregisterReceiverBButtonClicked' />
			</div>
			<div class='es-sdk-content-row-css'>
				<s-text-button text='给八阿哥发送消息C' @onButtonClicked='onSendMessageCButtonClicked' />
				<s-text-button text='注册消息接受者C' @onButtonClicked='onRegisterReceiverCButtonClicked' />
				<s-text-button text='取消注册消息接受者C' @onButtonClicked='onUnregisterReceiverCButtonClicked' />
			</div>
			<div class='es-sdk-content-row-css'>
				<s-text-button text='给七阿哥发送消息D' @onButtonClicked='onSendMessageDButtonClicked' />
				<s-text-button text='注册消息接受者D' @onButtonClicked='onRegisterReceiverDButtonClicked' />
				<s-text-button text='取消注册消息接受者D' @onButtonClicked='onUnregisterReceiverDButtonClicked' />
			</div>
		</div>
		<s-text-view :text='intentText'></s-text-view>
	</div>
</template>

<script lang='ts'>

import {defineComponent} from '@vue/runtime-core';
import {
	ESIACMessage,
	ESIACReceiver,
	useESIAC,
} from '@extscreen/es3-core';
import {ref} from 'vue';
import {ESLogLevel, useESLog} from '@extscreen/es3-core';

const TAG = 'ESIACPage';

export default defineComponent({
	name: '应用间通信模块',
	setup() {

		const intentText = ref('');

		const iac = useESIAC();
		const log = useESLog();

		const receiverAMessageFilter = {
			action: [
				'android.intent.action.TEST_BC_A',
			],
		};
		const receiverBMessageFilter = {
			action: [
				'android.intent.action.TEST_BC_B',
			],
		};
		const receiverCMessageFilter = {
			action: [
				'android.intent.action.TEST_BC_C',
			],
		};
		const receiverDMessageFilter = {
			action: [
				'com.huan.appstore.intent.action.ext',
			],
		};

		const messageReceiverA: ESIACReceiver = {

			onReceive(message: ESIACMessage) {
				if (log.isLoggable(ESLogLevel.DEBUG)) {
					log.d(TAG, '------messageReceiverA--onReceive--->>>' + message);
				}
				intentText.value = JSON.stringify(message);
			},
		};

		const messageReceiverB: ESIACReceiver = {

			onReceive(message: ESIACMessage) {
				if (log.isLoggable(ESLogLevel.DEBUG)) {
					log.d(TAG, '------messageReceiverB--onReceive--->>>' + message);
				}
				intentText.value = JSON.stringify(message);
			},
		};

		const messageReceiverC: ESIACReceiver = {

			onReceive(message: ESIACMessage) {
				if (log.isLoggable(ESLogLevel.DEBUG)) {
					log.d(TAG, '------messageReceiverC--onReceive--->>>' + message);
				}
				intentText.value = JSON.stringify(message);
			},
		};

		const messageReceiverD: ESIACReceiver = {

			onReceive(message: ESIACMessage) {
				if (log.isLoggable(ESLogLevel.DEBUG)) {
					log.d(TAG, '------messageReceiverD--onReceive--->>>' + message);
				}
				intentText.value = JSON.stringify(message);
			},
		};

		function onSendMessageAButtonClicked() {
			let message: ESIACMessage = {
				action: 'android.intent.action.TEST_BC_A',
			};
			iac.sendMessage(message);
		}

		function onSendMessageBButtonClicked() {
			let message: ESIACMessage = {
				action: 'android.intent.action.TEST_BC_B',
			};
			iac.sendMessage(message);
		}

		function onSendMessageCButtonClicked() {
			let message: ESIACMessage = {
				action: 'android.intent.action.TEST_BC_C',
				package: 'es.test.eight',
			};
			iac.sendMessage(message);
		}

		function onSendMessageDButtonClicked() {
			let message: ESIACMessage = {
				action: 'android.intent.action.TEST_BC_D',
				package: 'es.test.seven',
			};
			iac.sendMessage(message);
		}

		function onRegisterReceiverAButtonClicked() {
			iac.registerReceiver(messageReceiverA, receiverAMessageFilter);
		}

		function onRegisterReceiverBButtonClicked() {
			iac.registerReceiver(messageReceiverB, receiverBMessageFilter);
		}

		function onRegisterReceiverCButtonClicked() {
			iac.registerReceiver(messageReceiverC, receiverCMessageFilter);
		}

		function onRegisterReceiverDButtonClicked() {
			iac.registerReceiver(messageReceiverD, receiverDMessageFilter);
		}

		function onUnregisterReceiverAButtonClicked() {
			iac.unregisterReceiver(messageReceiverA);
		}

		function onUnregisterReceiverBButtonClicked() {
			iac.unregisterReceiver(messageReceiverB);
		}

		function onUnregisterReceiverCButtonClicked() {
			iac.unregisterReceiver(messageReceiverC);
		}

		function onUnregisterReceiverDButtonClicked() {
			iac.unregisterReceiver(messageReceiverD);
		}

		return {
			intentText,
			onSendMessageAButtonClicked,
			onSendMessageBButtonClicked,
			onSendMessageCButtonClicked,
			onSendMessageDButtonClicked,
			onRegisterReceiverAButtonClicked,
			onRegisterReceiverBButtonClicked,
			onRegisterReceiverCButtonClicked,
			onRegisterReceiverDButtonClicked,
			onUnregisterReceiverAButtonClicked,
			onUnregisterReceiverBButtonClicked,
			onUnregisterReceiverCButtonClicked,
			onUnregisterReceiverDButtonClicked,
		};
	},
});

</script>
<style>
</style>

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196

应用间通信模块 ​

数据结构 ​

ESIACMessage ​

ESIACMessageFilter ​

接口 ​

sendMessage ​

registerReceiver ​

unregisterReceiver ​

基础用法 ​