chrome.networking.onc

Nội dung mô tả

API chrome.networking.onc dùng để định cấu hình kết nối mạng (Di động, Ethernet, VPN hoặc Wi-Fi). API này có trong các phiên kiosk của Chrome OS tự động chạy.

Các cấu hình kết nối mạng được chỉ định theo thông số kỹ thuật của Cấu hình mạng mở (ONC).

LƯU Ý: Hầu hết các thuộc tính từ điển và giá trị enum đều sử dụng UpperCamelCase để khớp với thông số kỹ thuật ONC thay vì quy ước lowerCamelCase của JavaScript.

Quyền

networking.onc

Phạm vi cung cấp

Chrome 59 trở lên Chỉ dành cho ChromeOS

Loại

ActivationStateType

Liệt kê

CaptivePortalStatus

Liệt kê

CellularProperties

Thuộc tính

  • ActivationState

    ActivationStateType không bắt buộc

    Trạng thái kích hoạt tài khoản nhà mạng.

  • ActivationType

    chuỗi không bắt buộc

    Loại kích hoạt mạng di động.

  • AllowRoaming

    boolean không bắt buộc

    Liệu có cho phép chuyển vùng trong mạng hay không.

  • AutoConnect

    boolean không bắt buộc

    Liệu có nên kết nối tự động mạng di động (khi trong vùng phủ sóng) hay không.

  • Family (Gia đình)

    chuỗi không bắt buộc

    Nhóm công nghệ thiết bị di động – CDMA hoặc GSM.

  • FirmwareRevision

    chuỗi không bắt buộc

    Bản sửa đổi chương trình cơ sở đã được tải trong modem di động.

  • FoundNetworks

    FoundNetworkProperties[] không bắt buộc

    Danh sách các mạng tìm thấy trong lần quét mạng gần đây nhất.

  • HardwareRevision

    chuỗi không bắt buộc

    Sửa đổi phần cứng modem di động.

  • HomeProvider

    CellularProviderProperties không bắt buộc

    Thông tin về nhà cung cấp dịch vụ đã cấp thẻ SIM hiện được lắp đặt trong modem.

  • Nhà sản xuất

    chuỗi không bắt buộc

    Nhà sản xuất modem di động.

  • ModelID

    chuỗi không bắt buộc

    Mã mẫu modem di động.

  • NetworkTechnology

    chuỗi không bắt buộc

    Nếu modem được đăng ký trên mạng, thì công nghệ mạng hiện đang được sử dụng.

  • PaymentPortal

    PaymentPortal không bắt buộc

    Cổng thanh toán trực tuyến mà người dùng có thể sử dụng để đăng ký hoặc sửa đổi gói dữ liệu di động.

  • RoamingState

    chuỗi không bắt buộc

    Trạng thái chuyển vùng của modem di động trên mạng hiện tại.

  • SIMLockStatus

    SIMLockStatus không bắt buộc

    Trạng thái khoá SIM cho các mạng gia đình GSM.

  • SIMPresent

    boolean không bắt buộc

    Liệu có thẻ SIM hay không.

  • Đang quét

    boolean không bắt buộc

    Chrome 63 trở lên

    Đúng khi đang quét mạng di động.

  • ServingOperator

    CellularProviderProperties không bắt buộc

    Thông tin về nhà cung cấp dịch vụ mà modem hiện được đăng ký.

  • SignalStrength

    số không bắt buộc

    Cường độ tín hiệu mạng hiện tại.

  • SupportNetworkScan

    boolean không bắt buộc

    Liệu mạng di động có hỗ trợ tính năng quét hay không.

CellularProviderProperties

Thuộc tính

  • Mã

    string

    Mã mạng di động là cách nối đơn giản giữa MCC (Mã quốc gia trên thiết bị di động) và MNC (Mã mạng di động) của mạng.

  • Quốc gia

    chuỗi không bắt buộc

    Mã quốc gia gồm hai chữ cái.

  • Tên

    string

    Tên toán tử.

CellularStateProperties

Thuộc tính

CertificatePattern

Thuộc tính

  • EnrollmentURI

    string[] không bắt buộc

    Danh sách URI mà người dùng có thể được chuyển hướng đến trong trường hợp không tìm thấy chứng chỉ nào khớp với mẫu này.

  • Tổ chức phát hành

    IssuerSubjectPattern không bắt buộc

    Nếu được đặt, mẫu sẽ khớp với cài đặt của nhà phát hành X.509.

  • IssuerCARef

    string[] không bắt buộc

    Danh sách chứng chỉ CA của tổ chức phát hành chứng chỉ. Chứng chỉ phải được một trong số họ ký để khớp với mẫu này.

  • Tiêu đề

    IssuerSubjectPattern không bắt buộc

    Nếu được đặt, mẫu sẽ khớp với các chế độ cài đặt chủ thể X.509.

ClientCertificateType

Liệt kê

ConnectionStateType

Liệt kê

DeviceStateProperties

Thuộc tính

  • SIMLockStatus

    SIMLockStatus không bắt buộc

    Chrome 62 trở lên

    Trạng thái khoá SIM nếu Loại = Di động và SIMPresent = True.

  • SIMPresent

    boolean không bắt buộc

    Chrome 62 trở lên

    Đặt sang trạng thái hiện có của SIM nếu loại thiết bị là Mạng di động.

  • Đang quét

    boolean không bắt buộc

    Đặt nếu thiết bị được bật. Đúng nếu thiết bị hiện đang quét.

  • Tiểu bang

    DeviceStateType

    Trạng thái hiện tại của thiết bị.

  • Loại

    NetworkType

    Loại mạng liên kết với thiết bị (Di động, Ethernet hoặc Wi-Fi).

DeviceStateType

Liệt kê

"Chưa khởi tạo"
Có thiết bị nhưng chưa khởi chạy.

"Đã tắt"
Thiết bị đã được khởi chạy nhưng chưa được bật.

"Đang bật"
Trạng thái đã bật đã được yêu cầu nhưng chưa hoàn tất.

"Đang bật"
Thiết bị đang bật.

"Bị cấm"
Thiết bị bị nghiêm cấm.

EAPProperties

Thuộc tính

  • AnonymousIdentity

    chuỗi không bắt buộc

  • Mã chứng chỉ ứng dụng kháchPKCS11

    chuỗi không bắt buộc

    Chrome 60 trở lên
  • ClientCertPattern

    CertificatePattern không bắt buộc

  • ClientCertProvisioningProfileId

    chuỗi không bắt buộc

    Chrome 93 trở lên
  • ClientCertRef

    chuỗi không bắt buộc

  • ClientCertType

    ClientCertificateType

  • Danh tính

    chuỗi không bắt buộc

  • Phía trong

    chuỗi không bắt buộc

  • Bên ngoài

    chuỗi không bắt buộc

    Loại EAP bên ngoài. Yêu cầu của ONC nhưng có thể không được cung cấp khi dịch từ Shill.

  • Mật khẩu

    chuỗi không bắt buộc

  • SaveCredentials

    boolean không bắt buộc

  • ServerCAPEMs

    string[] không bắt buộc

  • ServerCARefs

    string[] không bắt buộc

  • SubjectMatch

    ManagedDOMString không bắt buộc

    Chrome 60 trở lên
  • UseProactiveKeyCaching

    boolean không bắt buộc

  • UseSystemCAs

    boolean không bắt buộc

EthernetProperties

Thuộc tính

  • Xác thực

    chuỗi không bắt buộc

    Phương thức xác thực được mạng Ethernet sử dụng. Các giá trị có thể là None và 8021X.

  • AutoConnect

    boolean không bắt buộc

    Liệu có nên kết nối mạng Ethernet tự động hay không.

  • EAP

    EAPProperties không bắt buộc

    Chế độ cài đặt EAP của mạng. Bắt buộc đối với phương thức xác thực 8021X.

EthernetStateProperties

Thuộc tính

FoundNetworkProperties

Thuộc tính

  • LongName

    chuỗi không bắt buộc

    Tên định dạng dài của đơn vị vận hành mạng.

  • NetworkId

    string

    Mã mạng.

  • ShortName

    chuỗi không bắt buộc

    Tên định dạng ngắn của đơn vị vận hành mạng.

  • Trạng thái

    string

    Khả năng sử dụng mạng.

  • Công nghệ

    string

    Công nghệ truy cập mà mạng sử dụng.

GlobalPolicy

Thuộc tính

  • AllowOnlyPolicyNetworksToAutoconnect

    boolean không bắt buộc

    Nếu đúng, chỉ các mạng tuân thủ chính sách mới có thể tự động kết nối. Giá trị mặc định là false.

  • AllowOnlyPolicyNetworksToConnect

    boolean không bắt buộc

    Nếu đúng, thì bạn chỉ có thể kết nối mạng chính sách và không thể thêm hoặc định cấu hình mạng mới nào. Giá trị mặc định là false.

  • AllowOnlyPolicyNetworksToConnectIfAvailable

    boolean không bắt buộc

    Chrome 70 trở lên

    Nếu giá trị true và một mạng được quản lý có trong danh sách mạng hiển thị, thì bạn chỉ có thể kết nối với các mạng chính sách và không thể thêm hoặc định cấu hình mạng mới nào. Giá trị mặc định là false.

  • BlockedHexSSIDs

    string[] không bắt buộc

    Chrome 86 trở lên

    Danh sách các mạng bị chặn. Nghiêm cấm kết nối với các mạng bị chặn. Bạn có thể bỏ chặn mạng lại bằng cách chỉ định cấu hình mạng rõ ràng. Giá trị mặc định là danh sách trống.

IPConfigProperties

Thuộc tính

  • ExcludedRoutes

    string[] không bắt buộc

    Chrome 76 trở lên

    Mảng IP các khối IP trong ký hiệu CIDR, xem onc_spec.md để biết thông tin chi tiết.

  • Cổng

    chuỗi không bắt buộc

    Địa chỉ cổng vào dùng để định cấu hình IP.

  • IPAddress

    chuỗi không bắt buộc

    Địa chỉ IP của một kết nối. Có thể là địa chỉ IPv4 hoặc IPv6, tuỳ thuộc vào giá trị của Type.

  • IncludedRoutes

    string[] không bắt buộc

    Chrome 76 trở lên

    Mảng IP các khối IP trong ký hiệu CIDR, xem onc_spec.md để biết thông tin chi tiết.

  • NameServers

    string[] không bắt buộc

    Mảng địa chỉ dùng cho máy chủ định danh.

  • RoutingPrefix

    số không bắt buộc

    Tiền tố định tuyến.

  • SearchDomains

    string[] không bắt buộc

    Chrome 76 trở lên

    Mảng chuỗi để phân giải tên, xem onc_spec.md để biết thông tin chi tiết.

  • Loại

    chuỗi không bắt buộc

    Loại cấu hình IP. Có thể là IPv4 hoặc IPv6.

  • WebProxyAutoDiscoveryUrl

    chuỗi không bắt buộc

    URL cho tính năng Tự động phát hiện proxy WEb, như được báo cáo qua DHCP.

IPConfigType

Liệt kê

"DHCP"

IssuerSubjectPattern

Thuộc tính

  • CommonName

    chuỗi không bắt buộc

    Nếu được đặt, giá trị để khớp với tên thông thường của chủ thể chứng chỉ.

  • Thành phố

    chuỗi không bắt buộc

    Nếu được đặt, giá trị để khớp với vị trí chung của chủ thể chứng chỉ.

  • Tổ chức

    chuỗi không bắt buộc

    Nếu được đặt, giá trị để khớp với các tổ chức của chủ thể chứng chỉ. Ít nhất một tổ chức phải khớp với giá trị này.

  • OrganizationalUnit

    chuỗi không bắt buộc

    Nếu được đặt, giá trị để khớp với đơn vị tổ chức của chủ thể chứng chỉ. Ít nhất một đơn vị tổ chức phải khớp với giá trị này.

ManagedBoolean

Thuộc tính

  • Đang hoạt động

    boolean không bắt buộc

    Giá trị đang hoạt động hiện được trình quản lý cấu hình mạng sử dụng (ví dụ: Shill).

  • DeviceEditable

    boolean không bắt buộc

    Liệu DevicePolicy cho thuộc tính có tồn tại và cho phép chỉnh sửa thuộc tính này (tức là chính sách đặt giá trị thuộc tính được đề xuất). Giá trị mặc định là false.

  • DevicePolicy

    boolean không bắt buộc

    Giá trị thuộc tính do chính sách thiết bị cung cấp.

  • Có hiệu lực

    chuỗi không bắt buộc

    Nguồn được xác định giá trị thuộc tính có hiệu lực.

  • SharedSetting

    boolean không bắt buộc

    Giá trị được đặt cho tất cả người dùng thiết bị. Chỉ được cung cấp nếu DeviceEditiable là true.

  • UserEditable

    boolean không bắt buộc

    Liệu một Chính sách người dùng cho thuộc tính có tồn tại và cho phép chỉnh sửa thuộc tính đó hay không (tức là chính sách đặt giá trị thuộc tính được đề xuất). Giá trị mặc định là false.

  • UserPolicy

    boolean không bắt buộc

    Giá trị thuộc tính do chính sách người dùng cung cấp.

  • UserSetting

    boolean không bắt buộc

    Giá trị thuộc tính do người dùng đã đăng nhập đặt. Chỉ được cung cấp nếu UserEditable là true.

ManagedCellularProperties

Thuộc tính

ManagedDOMString

Thuộc tính

  • Đang hoạt động

    chuỗi không bắt buộc

    Giá trị đang hoạt động hiện được trình quản lý cấu hình mạng sử dụng (ví dụ: Shill).

  • DeviceEditable

    boolean không bắt buộc

    Liệu DevicePolicy cho thuộc tính có tồn tại và cho phép chỉnh sửa thuộc tính này (tức là chính sách đặt giá trị thuộc tính được đề xuất). Giá trị mặc định là false.

  • DevicePolicy

    chuỗi không bắt buộc

    Giá trị thuộc tính do chính sách thiết bị cung cấp.

  • Có hiệu lực

    chuỗi không bắt buộc

    Nguồn được xác định giá trị thuộc tính có hiệu lực.

  • SharedSetting

    chuỗi không bắt buộc

    Giá trị được đặt cho tất cả người dùng thiết bị. Chỉ được cung cấp nếu DeviceEditiable là true.

  • UserEditable

    boolean không bắt buộc

    Liệu một Chính sách người dùng cho thuộc tính có tồn tại và cho phép chỉnh sửa thuộc tính đó hay không (tức là chính sách đặt giá trị thuộc tính được đề xuất). Giá trị mặc định là false.

  • UserPolicy

    chuỗi không bắt buộc

    Giá trị thuộc tính do chính sách người dùng cung cấp.

  • UserSetting

    chuỗi không bắt buộc

    Giá trị thuộc tính do người dùng đã đăng nhập đặt. Chỉ được cung cấp nếu UserEditable là true.

ManagedDOMStringList

Thuộc tính

  • Đang hoạt động

    string[] không bắt buộc

    Giá trị đang hoạt động hiện được trình quản lý cấu hình mạng sử dụng (ví dụ: Shill).

  • DeviceEditable

    boolean không bắt buộc

    Liệu DevicePolicy cho thuộc tính có tồn tại và cho phép chỉnh sửa thuộc tính này (tức là chính sách đặt giá trị thuộc tính được đề xuất). Giá trị mặc định là false.

  • DevicePolicy

    string[] không bắt buộc

    Giá trị thuộc tính do chính sách thiết bị cung cấp.

  • Có hiệu lực

    chuỗi không bắt buộc

    Nguồn được xác định giá trị thuộc tính có hiệu lực.

  • SharedSetting

    string[] không bắt buộc

    Giá trị được đặt cho tất cả người dùng thiết bị. Chỉ được cung cấp nếu DeviceEditiable là true.

  • UserEditable

    boolean không bắt buộc

    Liệu một Chính sách người dùng cho thuộc tính có tồn tại và cho phép chỉnh sửa thuộc tính đó hay không (tức là chính sách đặt giá trị thuộc tính được đề xuất). Giá trị mặc định là false.

  • UserPolicy

    string[] không bắt buộc

    Giá trị thuộc tính do chính sách người dùng cung cấp.

  • UserSetting

    string[] không bắt buộc

    Giá trị thuộc tính do người dùng đã đăng nhập đặt. Chỉ được cung cấp nếu UserEditable là true.

ManagedEthernetProperties

Thuộc tính

ManagedIPConfigProperties

Thuộc tính

ManagedIPConfigType

Thuộc tính

  • Đang hoạt động

    IPConfigType không bắt buộc

    Giá trị đang hoạt động hiện được trình quản lý cấu hình mạng sử dụng (ví dụ: Shill).

  • DeviceEditable

    boolean không bắt buộc

    Liệu DevicePolicy cho thuộc tính có tồn tại và cho phép chỉnh sửa thuộc tính này (tức là chính sách đặt giá trị thuộc tính được đề xuất). Giá trị mặc định là false.

  • DevicePolicy

    IPConfigType không bắt buộc

    Giá trị thuộc tính do chính sách thiết bị cung cấp.

  • Có hiệu lực

    chuỗi không bắt buộc

    Nguồn được xác định giá trị thuộc tính có hiệu lực.

  • SharedSetting

    IPConfigType không bắt buộc

    Giá trị được đặt cho tất cả người dùng thiết bị. Chỉ được cung cấp nếu DeviceEditiable là true.

  • UserEditable

    boolean không bắt buộc

    Liệu một Chính sách người dùng cho thuộc tính có tồn tại và cho phép chỉnh sửa thuộc tính đó hay không (tức là chính sách đặt giá trị thuộc tính được đề xuất). Giá trị mặc định là false.

  • UserPolicy

    IPConfigType không bắt buộc

    Giá trị thuộc tính do chính sách người dùng cung cấp.

  • UserSetting

    IPConfigType không bắt buộc

    Giá trị thuộc tính do người dùng đã đăng nhập đặt. Chỉ được cung cấp nếu UserEditable là true.

ManagedLong

Thuộc tính

  • Đang hoạt động

    số không bắt buộc

    Giá trị đang hoạt động hiện được trình quản lý cấu hình mạng sử dụng (ví dụ: Shill).

  • DeviceEditable

    boolean không bắt buộc

    Liệu DevicePolicy cho thuộc tính có tồn tại và cho phép chỉnh sửa thuộc tính này (tức là chính sách đặt giá trị thuộc tính được đề xuất). Giá trị mặc định là false.

  • DevicePolicy

    số không bắt buộc

    Giá trị thuộc tính do chính sách thiết bị cung cấp.

  • Có hiệu lực

    chuỗi không bắt buộc

    Nguồn được xác định giá trị thuộc tính có hiệu lực.

  • SharedSetting

    số không bắt buộc

    Giá trị được đặt cho tất cả người dùng thiết bị. Chỉ được cung cấp nếu DeviceEditiable là true.

  • UserEditable

    boolean không bắt buộc

    Liệu một Chính sách người dùng cho thuộc tính có tồn tại và cho phép chỉnh sửa thuộc tính đó hay không (tức là chính sách đặt giá trị thuộc tính được đề xuất). Giá trị mặc định là false.

  • UserPolicy

    số không bắt buộc

    Giá trị thuộc tính do chính sách người dùng cung cấp.

  • UserSetting

    số không bắt buộc

    Giá trị thuộc tính do người dùng đã đăng nhập đặt. Chỉ được cung cấp nếu UserEditable là true.

ManagedManualProxySettings

Thuộc tính

ManagedProperties

Thuộc tính

ManagedProxyLocation

Thuộc tính

ManagedProxySettings

Thuộc tính

ManagedProxySettingsType

Thuộc tính

  • Đang hoạt động

    ProxySettingsType không bắt buộc

    Giá trị đang hoạt động hiện được trình quản lý cấu hình mạng sử dụng (ví dụ: Shill).

  • DeviceEditable

    boolean không bắt buộc

    Liệu DevicePolicy cho thuộc tính có tồn tại và cho phép chỉnh sửa thuộc tính này (tức là chính sách đặt giá trị thuộc tính được đề xuất). Giá trị mặc định là false.

  • DevicePolicy

    ProxySettingsType không bắt buộc

    Giá trị thuộc tính do chính sách thiết bị cung cấp.

  • Có hiệu lực

    chuỗi không bắt buộc

    Nguồn được xác định giá trị thuộc tính có hiệu lực.

  • SharedSetting

    ProxySettingsType không bắt buộc

    Giá trị được đặt cho tất cả người dùng thiết bị. Chỉ được cung cấp nếu DeviceEditiable là true.

  • UserEditable

    boolean không bắt buộc

    Liệu một Chính sách người dùng cho thuộc tính có tồn tại và cho phép chỉnh sửa thuộc tính đó hay không (tức là chính sách đặt giá trị thuộc tính được đề xuất). Giá trị mặc định là false.

  • UserPolicy

    ProxySettingsType không bắt buộc

    Giá trị thuộc tính do chính sách người dùng cung cấp.

  • UserSetting

    ProxySettingsType không bắt buộc

    Giá trị thuộc tính do người dùng đã đăng nhập đặt. Chỉ được cung cấp nếu UserEditable là true.

ManagedThirdPartyVPNProperties

Thuộc tính

ManagedVPNProperties

Thuộc tính

ManagedWiFiProperties

Thuộc tính

ManualProxySettings

Thuộc tính

  • FTPProxy

    ProxyLocation không bắt buộc

    Cài đặt proxy FTP.

  • HTTPProxy

    ProxyLocation không bắt buộc

    Chế độ cài đặt cho proxy HTTP.

  • SÓNG QUEN

    ProxyLocation không bắt buộc

    Chế độ cài đặt cho proxy SOCKS.

  • SecureHTTPProxy

    ProxyLocation không bắt buộc

    Chế độ cài đặt cho proxy HTTP bảo mật.

NetworkConfigProperties

Thuộc tính

NetworkFilter

Thuộc tính

  • đã định cấu hình

    boolean không bắt buộc

    Nếu đúng, chỉ bao gồm các mạng đã định cấu hình (đã lưu). Giá trị mặc định là "false".

  • giới hạn

    số không bắt buộc

    Số mạng tối đa cần trả về. Giá trị mặc định là 1000 nếu không chỉ định. Sử dụng 0 để không có giới hạn.

  • networkType

    NetworkType

    Loại mạng cần trả về.

  • hiển thị

    boolean không bắt buộc

    Nếu đúng, chỉ bao gồm các mạng hiển thị (được kết nối thực tế hoặc trong phạm vi). Giá trị mặc định là "false".

NetworkProperties

Thuộc tính

  • Mạng di động

    CellularProperties không bắt buộc

    Đối với mạng di động, thuộc tính mạng di động.

  • Có thể kết nối

    boolean không bắt buộc

    Liệu mạng có kết nối được hay không.

  • ConnectionState

    ConnectionStateType không bắt buộc

    Trạng thái kết nối hiện tại của mạng.

  • ErrorState

    chuỗi không bắt buộc

    Trạng thái lỗi mạng được ghi lại gần đây nhất.

  • Ethernet

    Không bắt buộc EthernetProperties

    Đối với mạng Ethernet, thuộc tính mạng Ethernet.

  • GUID

    string

    GUID mạng.

  • IPAddressConfigType

    IPConfigType không bắt buộc

    Loại cấu hình địa chỉ IP của mạng.

  • IPConfigs

    IPConfigProperties[] không bắt buộc

    Cấu hình IP của mạng.

  • MacAddress

    chuỗi không bắt buộc

    Địa chỉ MAC của mạng.

  • Đo lượng dữ liệu

    boolean không bắt buộc

    Chrome 85 trở lên

    Liệu mạng có được đo lượng dữ liệu hay không.

  • Tên

    chuỗi không bắt buộc

    Tên mạng thân thiện với người dùng.

  • NameServersConfigType

    IPConfigType không bắt buộc

    Loại cấu hình IP cho máy chủ định danh mà mạng sử dụng.

  • Mức độ ưu tiên

    số không bắt buộc

    Mức độ ưu tiên của mạng.

  • ProxySettings

    ProxySettings không bắt buộc

    Chế độ cài đặt proxy của mạng.

  • RestrictedConnectivity

    boolean không bắt buộc

    Đối với mạng được kết nối, kết nối mạng với Internet có bị giới hạn hay không, ví dụ: mạng nằm sau cổng hoặc mạng di động không được kích hoạt.

  • SavedIPConfig

    IPConfigProperties không bắt buộc

    Cấu hình IP nhận được từ máy chủ DHCP trước khi áp dụng cấu hình IP tĩnh.

  • Nguồn

    chuỗi không bắt buộc

    Cho biết mạng có được định cấu hình hay không và cách định cấu hình. Các giá trị có thể là:

    • Device
    • DevicePolicy
    • User
    • UserPolicy
    • None

    "None" xung đột với quá trình tạo mã tiện ích nên chúng ta phải sử dụng một chuỗi cho "Source" thay vì một enum SourceType.

  • StaticIPConfig

    IPConfigProperties không bắt buộc

    Cấu hình IP tĩnh của mạng.

  • TrafficCounterResetTime

    số không bắt buộc

    Đang chờ xử lý

    Thời điểm gần đây nhất bộ đếm lưu lượng truy cập được đặt lại.

  • Loại

    NetworkType

    Loại mạng.

  • VPN

    VPNProperties không bắt buộc

    Đối với mạng VPN, đây là thuộc tính của VPN của mạng.

  • WiFi

    WiFiProperties không bắt buộc

    Đối với mạng Wi-Fi, thuộc tính Wi-Fi của mạng đó.

NetworkStateProperties

Thuộc tính

NetworkType

Liệt kê

"Ethernet"

"VPN"

"WiFi"

PaymentPortal

Thuộc tính

  • Phương thức

    string

    Phương thức HTTP để sử dụng cho cổng thanh toán.

  • PostData

    chuỗi không bắt buộc

    Dữ liệu bài đăng cần gửi đến cổng thanh toán. Bỏ qua trừ khi Method là POST.

  • URL

    chuỗi không bắt buộc

    URL cổng thông tin thanh toán.

ProxyLocation

Thuộc tính

  • Thành phần lưu trữ

    string

    Máy chủ lưu trữ địa chỉ IP proxy.

  • Cổng

    number

    Cổng để sử dụng cho proxy.

ProxySettings

Thuộc tính

  • ExcludeDomains

    string[] không bắt buộc

    Miền và máy chủ lưu trữ không áp dụng chế độ cài đặt proxy thủ công.

  • Thủ công

    ManualProxySettings không bắt buộc

    Chế độ cài đặt proxy thủ công – chỉ dùng cho chế độ cài đặt proxy Manual.

  • Uỷ ban hành động chính trị (PAC)

    chuỗi không bắt buộc

    URL cho tệp cấu hình tự động proxy.

  • Loại chế độ cài đặt proxy.

ProxySettingsType

Liệt kê

"PAC"

"WPAD"

SIMLockStatus

Thuộc tính

  • LockEnabled

    boolean

    Liệu tính năng khoá SIM có đang bật hay không.

  • LockType

    string

    Trạng thái khoá SIM – các giá trị có thể là 'sim-pin', 'sim-puk' và ''.

  • RetriesLeft

    số không bắt buộc

    Số lần thử khoá mã PIN được cho phép trước khi yêu cầu PUK để mở khoá SIM.

ThirdPartyVPNProperties

Thuộc tính

  • ExtensionID

    string

    Mã của tiện ích nhà cung cấp VPN bên thứ ba.

  • ProviderName

    chuỗi không bắt buộc

    Tên nhà cung cấp VPN.

VPNProperties

Thuộc tính

  • AutoConnect

    boolean không bắt buộc

    Liệu có nên tự động kết nối mạng VPN hay không.

  • Thành phần lưu trữ

    chuỗi không bắt buộc

    Máy chủ VPN.

  • Loại

    chuỗi không bắt buộc

    Loại VPN. Đây không thể là một enum do "L2TP-IPSec". Thao tác này là không bắt buộc cho NetworkConfigProperties. Các thuộc tính này được chuyển đến setProperties, có thể chỉ dùng để đặt các thuộc tính cụ thể.

VPNStateProperties

Thuộc tính

WiFiProperties

Thuộc tính

  • AllowGatewayARPPolling

    boolean không bắt buộc

    Liệu có cho phép thăm dò ARP của cổng vào mặc định hay không. Giá trị mặc định là đúng.

  • AutoConnect

    boolean không bắt buộc

    Liệu mạng Wi-Fi có cần được tự động kết nối khi nằm trong phạm vi hay không.

  • BSSID (mã định danh của bộ dịch vụ cơ bản)

    chuỗi không bắt buộc

    BSSID của điểm truy cập được liên kết.

  • EAP

    EAPProperties không bắt buộc

    Các thuộc tính EAP mạng. Bắt buộc đối với mạng WEP-8021X và WPA-EAP.

  • Tần suất

    số không bắt buộc

    Tần số hoạt động của dịch vụ Wi-Fi tính bằng MHz. Đối với các mạng kết nối, tần số hiện tại mà mạng được kết nối. Nếu không, hãy nhập tần suất của BSS tốt nhất có sẵn.

  • FrequencyList

    number[] không bắt buộc

    Chứa tất cả tần suất hoạt động gần đây của mạng Wi-Fi.

  • HexSSID

    chuỗi không bắt buộc

    Bản sao được mã hoá bằng SSID của mạng SSID.

  • HiddenSSID

    boolean không bắt buộc

    Liệu SSID mạng có được thông báo hay không.

  • Cụm mật khẩu

    chuỗi không bắt buộc

    Chrome 66 trở lên

    Cụm mật khẩu cho kết nối WEP/WPA/WPA2. Bạn chỉ có thể đặt thuộc tính này – các thuộc tính do getProperties trả về sẽ không chứa giá trị này.

  • RoamThreshold

    số không bắt buộc

    Không dùng nữa, bị bỏ qua.

  • SSID

    chuỗi không bắt buộc

    SSID mạng.

  • Bảo mật

    chuỗi không bắt buộc

    Loại bảo mật mạng.

  • SignalStrength

    số không bắt buộc

    Cường độ tín hiệu mạng.

WiFiStateProperties

Thuộc tính

WiMAXProperties

Thuộc tính

  • AutoConnect

    boolean không bắt buộc

    Liệu có nên kết nối mạng tự động hay không.

  • EAP

    EAPProperties không bắt buộc

    Các thuộc tính EAP mạng.

Phương thức

createNetwork()

Cam kết 
chrome.networking.onc.createNetwork(
  shared: boolean,
  properties: NetworkConfigProperties,
  callback?: function,
)

Tạo cấu hình mạng mới từ các thuộc tính. Nếu đã có một mạng được định cấu hình phù hợp, thì quá trình này sẽ không thành công. Nếu không, sẽ trả về GUID của mạng mới.

Tham số

  • đã chia sẻ

    boolean

    Nếu là true, hãy chia sẻ cấu hình mạng này với người dùng khác.

    Lựa chọn này chỉ hiển thị với giao diện người dùng web của Chrome.* Khi được ứng dụng gọi, false là giá trị duy nhất được cho phép.

  • các tài sản

    NetworkConfigProperties

    Các thuộc tính để định cấu hình mạng mới.

  • số gọi lại

    hàm không bắt buộc

    Tham số callback sẽ có dạng như sau: 

    (result: string)=>void

    • kết quả

      string

Giá trị trả về

  • Hứa hẹn<string>

    Đang chờ xử lý

    Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

disableNetworkType()

chrome.networking.onc.disableNetworkType(
  networkType: NetworkType,
)

Tắt mọi thiết bị khớp với loại mạng đã chỉ định. Xem ghi chú về enableNetworkType.

Tham số

enableNetworkType()

chrome.networking.onc.enableNetworkType(
  networkType: NetworkType,
)

Cho phép mọi thiết bị khớp với loại mạng đã chỉ định. Lưu ý: loại này có thể đại diện cho nhiều loại mạng (ví dụ: "Không dây").

Tham số

forgetNetwork()

Cam kết 
chrome.networking.onc.forgetNetwork(
  networkGuid: string,
  callback?: function,
)

Bỏ qua cấu hình mạng bằng cách xoá mọi thuộc tính đã định cấu hình cho mạng bằng GUID networkGuid. Dữ liệu này cũng có thể bao gồm bất kỳ mạng nào khác có mã nhận dạng trùng khớp (ví dụ: SSID và Bảo mật Wi-Fi). Nếu không có cấu hình như vậy, một lỗi sẽ được đặt và thao tác sẽ không thành công.

Trong phiên kiosk, phương thức này sẽ không thể xoá cấu hình mạng dùng chung.

Tham số

  • networkGuid

    string

    GUID của mạng cần bỏ qua.

  • số gọi lại

    hàm không bắt buộc

    Tham số callback sẽ có dạng như sau: 

    ()=>void

Giá trị trả về

  • Promise<void>

    Đang chờ xử lý

    Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

getCaptivePortalStatus()

Cam kết 
chrome.networking.onc.getCaptivePortalStatus(
  networkGuid: string,
  callback?: function,
)

Trả về trạng thái trang xác thực cho mạng khớp với "networkGuid".

Tham số

  • networkGuid

    string

    GUID của mạng để nhận trạng thái trang xác thực.

  • số gọi lại

    hàm không bắt buộc

    Tham số callback sẽ có dạng như sau: 

    (result: CaptivePortalStatus)=>void

Giá trị trả về

  • Đang chờ xử lý

    Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

getDeviceStates()

Cam kết 
chrome.networking.onc.getDeviceStates(
  callback?: function,
)

Trả về trạng thái của các thiết bị mạng hiện có.

Tham số

Giá trị trả về

  • Đang chờ xử lý

    Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

getGlobalPolicy()

Cam kết 
chrome.networking.onc.getGlobalPolicy(
  callback?: function,
)

Lấy các thuộc tính chính sách toàn cầu. Các thuộc tính này dự kiến sẽ không thay đổi trong một phiên.

Tham số

  • số gọi lại

    hàm không bắt buộc

    Tham số callback sẽ có dạng như sau: 

    (result: GlobalPolicy)=>void

Giá trị trả về

  • Promise<GlobalPolicy>

    Đang chờ xử lý

    Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

getManagedProperties()

Cam kết 
chrome.networking.onc.getManagedProperties(
  networkGuid: string,
  callback?: function,
)

Lấy các thuộc tính hợp nhất của mạng có id networkGuid từ các nguồn: Chế độ cài đặt người dùng, chế độ cài đặt dùng chung, chính sách người dùng, chính sách thiết bị và chế độ cài đặt hiện đang hoạt động.

Tham số

  • networkGuid

    string

    GUID của mạng để lấy thuộc tính.

  • số gọi lại

    hàm không bắt buộc

    Tham số callback sẽ có dạng như sau: 

    (result: ManagedProperties)=>void

Giá trị trả về

  • Đang chờ xử lý

    Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

getNetworks()

Cam kết 
chrome.networking.onc.getNetworks(
  filter: NetworkFilter,
  callback?: function,
)

Trả về danh sách đối tượng mạng có cùng thuộc tính do getState cung cấp. Bạn sẽ thấy bộ lọc để chỉ định loại mạng được trả về và giới hạn số lượng mạng. Các mạng được hệ thống sắp xếp dựa trên mức độ ưu tiên, trong đó mạng đã kết nối hoặc mạng kết nối được liệt kê trước.

Tham số

Giá trị trả về

  • Đang chờ xử lý

    Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

getProperties()

Cam kết 
chrome.networking.onc.getProperties(
  networkGuid: string,
  callback?: function,
)

Lấy tất cả thuộc tính của mạng bằng id networkGuid. Bao gồm tất cả thuộc tính của mạng (giá trị chỉ đọc và đọc/ghi).

Tham số

  • networkGuid

    string

    GUID của mạng để lấy thuộc tính.

  • số gọi lại

    hàm không bắt buộc

    Tham số callback sẽ có dạng như sau: 

    (result: NetworkProperties)=>void

Giá trị trả về

  • Đang chờ xử lý

    Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

getState()

Cam kết 
chrome.networking.onc.getState(
  networkGuid: string,
  callback?: function,
)

Lấy các thuộc tính chỉ đọc được lưu vào bộ nhớ đệm của mạng bằng id networkGuid. Đây là hàm hiệu suất cao hơn so với getProperties, đòi hỏi phải thực hiện vòng lặp để truy vấn hệ thống mạng con. Các thuộc tính sau được trả về cho tất cả các mạng: GUID, Loại, Tên, WiFi.Security. Các thuộc tính khác được cung cấp cho các mạng hiển thị: ConnectionState, ErrorState, Wi-Fi.SignalStrength, Cellular.NetworkPolicies, Cellular.Kích hoạtState, Cellular.chuyểnState.

Tham số

  • networkGuid

    string

    GUID của mạng để lấy thuộc tính.

  • số gọi lại

    hàm không bắt buộc

    Tham số callback sẽ có dạng như sau: 

    (result: NetworkStateProperties)=>void

Giá trị trả về

  • Đang chờ xử lý

    Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

requestNetworkScan()

chrome.networking.onc.requestNetworkScan(
  networkType?: NetworkType,
)

Yêu cầu hệ thống kết nối mạng phụ quét tìm các mạng mới và cập nhật danh sách do getVisibleNetworks trả về. Đây chỉ là yêu cầu: hệ thống phụ của mạng có thể chọn bỏ qua yêu cầu này. Nếu bạn cập nhật danh sách, thì sự kiện onNetworkListChanged sẽ được kích hoạt.

Tham số

  • networkType

    NetworkType không bắt buộc

    Chrome 63 trở lên

    Nếu được cung cấp, hãy yêu cầu một lượt quét cụ thể cho loại đó. Đối với Mạng di động, hệ thống sẽ yêu cầu quét mạng di động nếu được hỗ trợ.

setProperties()

Cam kết 
chrome.networking.onc.setProperties(
  networkGuid: string,
  properties: NetworkConfigProperties,
  callback?: function,
)

Đặt thuộc tính của mạng có mã networkGuid. Điều này chỉ hợp lệ cho các mạng đã được định cấu hình (Nguồn != Không có). Các mạng hiển thị chưa được định cấu hình nên sử dụng createNetwork. Trong các phiên kiosk, bạn sẽ không thể gọi phương thức này trên mạng dùng chung.

Tham số

  • networkGuid

    string

    GUID của mạng để đặt thuộc tính.

  • các tài sản

    NetworkConfigProperties

    Các thuộc tính cần đặt.

  • số gọi lại

    hàm không bắt buộc

    Tham số callback sẽ có dạng như sau: 

    ()=>void

Giá trị trả về

  • Promise<void>

    Đang chờ xử lý

    Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

startConnect()

Cam kết 
chrome.networking.onc.startConnect(
  networkGuid: string,
  callback?: function,
)

Bắt đầu kết nối mạng bằng networkGuid.

Tham số

  • networkGuid

    string

    GUID của mạng để kết nối.

  • số gọi lại

    hàm không bắt buộc

    Tham số callback sẽ có dạng như sau: 

    ()=>void

Giá trị trả về

  • Promise<void>

    Đang chờ xử lý

    Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

startDisconnect()

Cam kết 
chrome.networking.onc.startDisconnect(
  networkGuid: string,
  callback?: function,
)

Bắt đầu ngắt kết nối mạng bằng networkGuid.

Tham số

  • networkGuid

    string

    GUID của mạng muốn ngắt kết nối.

  • số gọi lại

    hàm không bắt buộc

    Tham số callback sẽ có dạng như sau: 

    ()=>void

Giá trị trả về

  • Promise<void>

    Đang chờ xử lý

    Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

Sự kiện

onDeviceStateListChanged

chrome.networking.onc.onDeviceStateListChanged.addListener(
  callback: function,
)

Được kích hoạt khi danh sách thiết bị thay đổi hoặc bất kỳ thuộc tính trạng thái nào của thiết bị đã thay đổi.

Tham số

  • số gọi lại

    hàm

    Tham số callback sẽ có dạng như sau: 

    ()=>void

onNetworkListChanged

chrome.networking.onc.onNetworkListChanged.addListener(
  callback: function,
)

Được kích hoạt khi danh sách mạng thay đổi. Gửi danh sách đầy đủ các GUID cho tất cả các mạng hiện tại.

Tham số

  • số gọi lại

    hàm

    Tham số callback sẽ có dạng như sau: 

    (changes: string[])=>void

    • các thay đổi

      chuỗi[]

onNetworksChanged

chrome.networking.onc.onNetworksChanged.addListener(
  callback: function,
)

Được kích hoạt khi các thuộc tính thay đổi trên bất kỳ mạng nào. Gửi danh sách GUID cho những mạng có thuộc tính đã thay đổi.

Tham số

  • số gọi lại

    hàm

    Tham số callback sẽ có dạng như sau: 

    (changes: string[])=>void

    • các thay đổi

      chuỗi[]

onPortalDetectionCompleted

chrome.networking.onc.onPortalDetectionCompleted.addListener(
  callback: function,
)

Được kích hoạt khi quá trình phát hiện cổng thông tin cho một mạng hoàn tất. Gửi GUID của mạng và trạng thái trang xác thực tương ứng.

Tham số