Thuộc tính tệp kê khai externally_connectable
khai báo những tiện ích, ứng dụng và trang web có thể kết nối với ứng dụng của bạn qua runtime.connect
và runtime.sendMessage
.
Để xem hướng dẫn về cách truyền thông báo, hãy xem nội dung tiện ích trên nhiều tiện ích và thông báo trên ứng dụng cũng như gửi thông báo từ các trang web.
Kết nối mà không cần kết nối bên ngoài
Nếu externally_connectable
không được khai báo trong tệp kê khai của ứng dụng, thì mọi tiện ích và ứng dụng đều có thể kết nối, nhưng không trang web nào có thể kết nối. Do đó, khi bạn cập nhật tệp kê khai để sử dụng externally_connectable
, nếu bạn không chỉ định "ids": ["*"]
thì các tiện ích và ứng dụng khác sẽ mất khả năng kết nối với ứng dụng của bạn. Đây có thể là hậu quả ngoài ý muốn, vì vậy, hãy lưu ý điều này.
Tệp manifest.json mẫu
{
"name": "My externally connectable app",
"externally_connectable": {
// Extension and app IDs. If this field is not specified, no
// extensions or apps can connect.
"ids": [
"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
...
// Alternatively, to match all extensions and apps, specify only
// "*".
"*"
],
// Match patterns for web pages. Does not affect content scripts.
// If this field is not specified, no webpages can connect.
"matches": [
"https://*.google.com/*",
"*://*.chromium.org/*",
...
],
// Indicates that the extension would like to make use of the TLS
// channel ID of the web page connecting to it. The web page must
// also opt to send the TLS channel ID to the extension via setting
// includeTlsChannelId to true in runtime.connect's connectInfo
// or runtime.sendMessage's options.
"accepts_tls_channel_id": false
},
...
}
Tài liệu tham khảo
Khoá tệp kê khai External_connectable có thể có các thuộc tính sau:
ids
(mảng chuỗi) – không bắt buộcMã của các tiện ích hoặc ứng dụng được phép kết nối. Nếu để trống hoặc không chỉ định, thì sẽ không có tiện ích hoặc ứng dụng nào có thể kết nối.
Ký tự đại diện
"*"
sẽ cho phép tất cả tiện ích và ứng dụng kết nối.matches
(mảng chuỗi) – không bắt buộcCác mẫu URL cho các trang web được phép kết nối. Điều này không ảnh hưởng đến tập lệnh nội dung. Nếu bạn để trống hoặc không chỉ định, thì sẽ không có trang web nào có thể kết nối.
Các mẫu không được bao gồm miền ký tự đại diện hay miền con của miền cấp cao nhất(có hiệu lực);
*://google.com/*
vàhttps://*.chromium.org/*
là hợp lệ, trong khi<all_urls>
,https://*/*
,*://*.com/*
và thậm chíhttps://*.appspot.com/*
thì không hợp lệ.accepts_tls_channel_id
(boolean) – không bắt buộcNếu là
true
, các tin nhắn được gửi quaruntime.connect
hoặcruntime.sendMessage
sẽ thiết lậpruntime.MessageSender.tlsChannelId
nếu các phương thức đó yêu cầu. Nếu giá trị làfalse
,runtime.MessageSender.tlsChannelId
sẽ không bao giờ được đặt trong bất kỳ trường hợp nào.