Tính năng cắt mạng 5G

Đối với các thiết bị chạy Android 12 trở lên, Android cung cấp hỗ trợ chia sẻ mạng 5G, sử dụng ảo hoá mạng để chia các kết nối mạng thành nhiều kết nối ảo riêng biệt cung cấp lượng tài nguyên khác nhau cho các loại lưu lượng truy cập khác nhau. 5G tính năng chia sẻ mạng cho phép các nhà khai thác mạng dành riêng một phần mạng cho cung cấp các tính năng cụ thể cho một phân khúc khách hàng cụ thể. Android 12 ra mắt sau đây về khả năng phân chia mạng 5G dành cho doanh nghiệp. Các nhà khai thác mạng có thể cung cấp cho khách hàng là doanh nghiệp:

Tính năng cắt lát trên thiết bị doanh nghiệp cho các thiết bị được quản lý toàn diện

Đối với các doanh nghiệp cung cấp được quản lý hoàn toàn thiết bị của công ty cho nhân viên của họ, nhà cung cấp mạng có thể cung cấp cho họ một hoặc nhiều nhóm mạng doanh nghiệp đang hoạt động khác ở nơi có lưu lượng truy cập trên các thiết bị của công ty được định tuyến đến. Từ Android 12, Android cho phép nhà mạng để cung cấp các lát cắt doanh nghiệp thông qua quy tắc URSP, thay vì thiết lập các lát cắt thông qua APN.

Tính năng cắt lát ứng dụng dành cho doanh nghiệp dành cho các thiết bị có hồ sơ công việc

Đối với doanh nghiệp sử dụng hồ sơ công việc Android 12 cho phép các thiết bị định tuyến từ tất cả các ứng dụng trong hồ sơ công việc sang một lát cắt mạng doanh nghiệp. Doanh nghiệp có thể bật chế độ này thông qua một Trình kiểm soát chính sách thiết bị (DPC).

Giải pháp hồ sơ công việc cung cấp cấp độ xác thực tự động và mà doanh nghiệp yêu cầu để đảm bảo chỉ có lưu lượng truy cập từ các ứng dụng doanh nghiệp trong hồ sơ công việc được định tuyến đến lát cắt mạng doanh nghiệp. Bạn không cần sửa đổi các ứng dụng trong hồ sơ công việc để yêu cầu một cách rõ ràng lát cắt mạng doanh nghiệp.

Cách hoạt động của tính năng phân chia mạng 5G trong AOSP (Dự án nguồn mở Android)

Android 12 ra mắt tính năng hỗ trợ tính năng cắt mạng 5G thông qua việc bổ sung cơ sở mã điện thoại trong AOSP và Mô-đun chia sẻ Internet để kết hợp các API kết nối hiện có cần thiết cho việc cắt lát mạng.

Nền tảng điện thoại Android cung cấp API điện thoại và HAL để hỗ trợ chia tách dựa trên các yêu cầu mạng do mã mạng cốt lõi và mạng 5G khả năng cắt lát trong modem. Hình 1 mô tả các thành phần của mạng 5G cắt mạng.

Thành phần cắt mạng 5G

Hình 1. Kiến trúc phân chia mạng 5G trong AOSP.

Nền tảng điện thoại và kết nối hỗ trợ:

  • Chuyển đổi yêu cầu mạng cho các danh mục Lát cắt thành phần mô tả lưu lượng truy cập sau đó được truyền đến modem để so khớp lưu lượng truy cập và định tuyến URSP lựa chọn
  • Quay lại mạng mặc định nếu lát cắt mạng doanh nghiệp không phải là có sẵn
  • Định tuyến lưu lượng truy cập từ tất cả các ứng dụng trong hồ sơ công việc đến kết nối tương ứng

  • Hỗ trợ tính năng phân tách dữ liệu doanh nghiệp

    • Phát hiện sự hiện diện của hồ sơ công việc trên thiết bị
    • Đang kiểm tra quyền hoặc định tuyến chỉ đường được cung cấp từ DPC do quản trị viên CNTT của doanh nghiệp sử dụng

Dịch vụ nối mạng cốt lõi bao gồm những thay đổi sau đây đối với tính năng Chia sẻ Internet mô-đun trong Android 12:

  • Thêm hầu hết android.net.* lớp API công khai hoặc API hệ thống vào tính năng Chia sẻ Internet mô-đun

  • Mở rộng ranh giới mô-đun tính năng chia sẻ Internet để đưa vào:

    • f/b/core/java/android/net/…
    • f/b/services/net/…
    • f/b/services/core/java/com/android/server/connectivity/…
    • f/b/services/core/java/com/android/server/ConnectivityService.java
    • f/b/services/core/java/com/android/server/TestNetworkService.java

  • Di chuyển mã VPN ra khỏi mô-đun Chia sẻ Internet

Android 12 di chuyển mã bằng các khả năng sau vào mô-đun Chia sẻ Internet:

  • Nhận yêu cầu kết nối mạng từ các ứng dụng
  • Nhận yêu cầu từ hệ thống (ví dụ: "đặt các ứng dụng này trên lát cắt doanh nghiệp"; ra mắt trong Android 12)
  • Gửi yêu cầu từ hệ thống đến mã điện thoại cố gắng tìm cách thiết lập mạng hoặc lát cắt bằng cách đi qua API HAL và modem
  • Thông báo rõ ràng về cách định tuyến lưu lượng truy cập trên cơ sở cho mỗi ứng dụng (được giới thiệu trong Android 12)
  • Thông báo cho ứng dụng những gì đang xảy ra đối với lưu lượng truy cập mạng của họ thông qua Các API ConnectivityManager như NetworkCallback, getActiveNetwork, getNetworkCapabilities.

Triển khai

Để hỗ trợ tính năng cắt lát 5G trên một thiết bị, thiết bị đó phải có modem hỗ trợ IRadio 1.6 HAL có setupDataCall_1_6 API. API này thiết lập kết nối dữ liệu và bao gồm các tham số sau để hỗ trợ công nghệ cắt mạng 5G:

  • trafficDescriptor: Chỉ định bộ mô tả lưu lượng truy cập được gửi đến modem
  • sliceInfo: Chỉ định thông tin cho lát cắt mạng sẽ được dùng trong trường hợp chuyển từ EPDG sang 5G
  • matchAllRuleAllowed: Chỉ định xem có sử dụng URSP khớp tất cả mặc định hay không . Điện thoại đặt giá trị này thành true đối với các mạng mặc định nhưng không áp dụng cho lát cắt. Quy tắc so khớp tất cả được áp dụng cho mặc định mạng. Khi một ứng dụng yêu cầu một lát cắt cụ thể không phải là có sẵn, phần cụ thể sẽ được báo cáo là không có. Để dành cho doanh nghiệp, khung Điện thoại có thể quay lại chế độ mặc định mạng nếu không có mạng doanh nghiệp.

Modem cũng phải triển khai getSlicingConfig trừ phi API đó được báo cáo là không được hỗ trợ getHalDeviceCapabilities API.

Yêu cầu đối với doanh nghiệp

Nội dung sau đây mô tả những yêu cầu mà doanh nghiệp cần đáp ứng để sử dụng tính năng cắt mạng 5G trên thiết bị trong quá trình triển khai Android Enterprise.

  • Đảm bảo rằng các thiết bị của nhân viên hoặc thiết bị được quản lý hoàn toàn được thiết lập có hồ sơ công việc có hỗ trợ 5G SA với những modem hỗ trợ setupDataCall_1_6 API.
  • Làm việc với đối tác là nhà mạng về việc thiết lập và thực hiện lát cắt hoặc Thoả thuận mức độ cung cấp dịch vụ (SLA) đặc điểm.

Bật tính năng cắt lát 5G trên các thiết bị được thiết lập bằng hồ sơ công việc

Đối với các thiết bị được thiết lập bằng hồ sơ công việc, tính năng cắt mạng 5G sẽ bị tắt bằng mặc định trong AOSP. Để bật tính năng cắt mạng, quản trị viên CNTT của doanh nghiệp có thể bật hoặc tắt lưu lượng truy cập của ứng dụng hồ sơ công việc và định tuyến đến lát cắt mạng doanh nghiệp trên một cơ sở cho mỗi nhân viên thông qua DPC EMM, công cụ này sử dụng setPreferentialNetworkServiceEnabled trong phần DevicePolicyManager (DPM) API (được giới thiệu trong Android 12).

Nhà cung cấp EMM có DPC tuỳ chỉnh phải tích hợp API DevicePolicyManager để hỗ trợ khách hàng doanh nghiệp.

Quy tắc URSP

Phần này bao gồm thông tin dành cho các nhà mạng về việc định cấu hình quy tắc URSP cho các danh mục lát cắt khác nhau bao gồm doanh nghiệp, CBS, độ trễ thấp, và lưu lượng truy cập băng thông cao. Khi định cấu hình quy tắc URSP cho các danh mục lát cắt khác nhau, nhà cung cấp phải sử dụng các thẻ giá trị.

ID Giá trị Mô tả
Mã hệ điều hành 97a498e3-fc92-5c94-8986-0333d06e4e47 OSId dành cho Android là mã nhận dạng duy nhất (UUID) phiên bản 5 được tạo bằng không gian tên ISO OID và tên "Android".

Nhà mạng phải định cấu hình quy tắc URSP cho từng phần lưu lượng truy cập có lưu lượng truy cập thành phần mô tả là "Mã hệ điều hành + loại mã ứng dụng hệ điều hành". Ví dụ: nhóm "ENTERPRISE" lát cắt phải có giá trị là 0x97A498E3FC925C9489860333D06E4E470A454E5445525052495345. Giá trị này là một chuỗi nối của OSId, độ dài của OSAppId (0x0A), và OSAppId. Để biết thêm thông tin về loại thành phần mô tả lưu lượng truy cập, hãy xem 3GPP TS 24.526 Bảng 5.2.1.

Bảng sau đây mô tả các giá trị OSAppId cho các danh mục lát cắt khác nhau.

Danh mục Lát cắt Mã ứng dụng hệ điều hành Mô tả
DOANH NGHIỆP 0x454E5445525052495345 OSAppId là một mảng byte của chuỗi "ENTERPRISE"
DOANH NGHIỆP 2 0x454E544552505249534532 OSAppId là một mảng byte đại diện cho chuỗi "ENTERPRISE2"
DOANH NGHIỆP 3 0x454E544552505249534533 OSAppId là một mảng byte đại diện cho chuỗi "ENTERPRISE3"
DOANH NGHIỆP4 0x454E544552505249534534 OSAppId là một mảng byte của chuỗi "ENTERPRISE4"
DOANH NGHIỆP 5 0x454E544552505249534535 OSAppId là một mảng byte của chuỗi "ENTERPRISE5"
CBS 0x434253 OSAppId là một mảng byte đại diện cho chuỗi "CBS"
ƯU TIÊN_ĐỪNG BỎ LỠ 0x5052494f524954495a455f4c4154454e4359 OSAppId là một mảng byte của chuỗi "PRIORITIZE_LATENCY"
ƯU TIÊN_BANDWIDTH 0x5052494f524954495a455f42414e445749445448 OSAppId là một mảng byte của chuỗi "PRIORITIZE_BANDWIDTH"

Ví dụ về quy tắc URSP

Các bảng sau đây trình bày các quy tắc URSP mẫu dành cho doanh nghiệp, CBS, độ trễ thấp, băng thông cao và lưu lượng truy cập mặc định.

Doanh nghiệp 1

Tính năng hỗ trợ Enterprise 1 có trên Android 12 trở lên. Sau đây là ví dụ về quy tắc URSP cho lưu lượng truy cập ENTERPRISE1:

Quy tắc URSP #1 (enterprise1)
Quyền ưu tiên 1 (0x01)
Bộ mô tả lưu lượng truy cập #1
Mã hệ điều hành + Loại mã ứng dụng hệ điều hành 0x97A498E3FC925C9489860333D06E4E470A454E5445525052495345
Nội dung mô tả lựa chọn tuyến đường #1
Quyền ưu tiên 1 (0x01)
Thành phần số 1: S-NSSAI SST:XX SD:YYYYYY
Thành phần số 2: DNN doanh nghiệp
Nội dung mô tả lựa chọn tuyến đường #2
Quyền ưu tiên 2 (0x02)
Thành phần số 1: DNN doanh nghiệp

Doanh nghiệp 2

Có hỗ trợ Enterprise 2 trên Android 13 trở lên. Sau đây là ví dụ về quy tắc URSP cho lưu lượng truy cập ENTERPRISE2:

Quy tắc URSP số 2 (enterprise2)
Quyền ưu tiên 2 (0x02)
Bộ mô tả lưu lượng truy cập #1
Mã hệ điều hành + Loại mã ứng dụng hệ điều hành 0x97A498E3FC925C9489860333D06E4E470B454E544552505249534532
Nội dung mô tả lựa chọn tuyến đường #1
Quyền ưu tiên 1 (0x01)
Thành phần số 1: S-NSSAI SST:XX SD:YYYYYY
Thành phần số 2: DNN doanh nghiệp2
Nội dung mô tả lựa chọn tuyến đường #2
Quyền ưu tiên 2 (0x02)
Thành phần số 1: DNN doanh nghiệp2

Doanh nghiệp 3

Tính năng hỗ trợ Enterprise 3 hiện có trên Android 13 trở lên. Sau đây là ví dụ về quy tắc URSP cho lưu lượng truy cập ENTERPRISE3:

Quy tắc URSP số 3 (enterprise3)
Quyền ưu tiên 3 (0x03)
Bộ mô tả lưu lượng truy cập #1
Mã hệ điều hành + Loại mã ứng dụng hệ điều hành 0x97A498E3FC925C9489860333D06E4E470B454E544552505249534533
Nội dung mô tả lựa chọn tuyến đường #1
Quyền ưu tiên 1 (0x01)
Thành phần số 1: S-NSSAI SST:XX SD:YYYYYY
Thành phần số 2: DNN doanh nghiệp 3
Nội dung mô tả lựa chọn tuyến đường #2
Quyền ưu tiên 2 (0x02)
Thành phần số 1: DNN doanh nghiệp 3

Doanh nghiệp 4

Hỗ trợ Enterprise 4 có trên Android 13 trở lên. Sau đây là ví dụ về quy tắc URSP cho lưu lượng truy cập ENTERPRISE4:

Quy tắc URSP số 4 (enterprise4)
Quyền ưu tiên 4 (0x04)
Bộ mô tả lưu lượng truy cập #1
Mã hệ điều hành + Loại mã ứng dụng hệ điều hành 0x97A498E3FC925C9489860333D06E4E470B454E544552505249534534
Nội dung mô tả lựa chọn tuyến đường #1
Quyền ưu tiên 1 (0x01)
Thành phần số 1: S-NSSAI SST:XX SD:YYYYYY
Thành phần số 2: DNN doanh nghiệp 4
Nội dung mô tả lựa chọn tuyến đường #2
Quyền ưu tiên 2 (0x02)
Thành phần số 1: DNN doanh nghiệp 4

Doanh nghiệp 5

Hỗ trợ Enterprise 5 có trên Android 13 trở lên. Sau đây là ví dụ về quy tắc URSP cho lưu lượng truy cập ENTERPRISE5:

Quy tắc URSP số 5 (enterprise5)
Quyền ưu tiên 5 (0x05)
Bộ mô tả lưu lượng truy cập #1
Mã hệ điều hành + Loại mã ứng dụng hệ điều hành 0x97A498E3FC925C9489860333D06E4E470B454E544552505249534535
Nội dung mô tả lựa chọn tuyến đường #1
Quyền ưu tiên 1 (0x01)
Thành phần số 1: S-NSSAI SST:XX SD:YYYYYY
Thành phần số 2: DNN doanh nghiệp 5
Nội dung mô tả lựa chọn tuyến đường #2
Quyền ưu tiên 2 (0x02)
Thành phần số 1: DNN doanh nghiệp 5

CBS

Android 13 trở lên hỗ trợ CBS. Sau đây là ví dụ về quy tắc URSP cho lưu lượng truy cập của CBS:

Quy tắc URSP số 6 (CBS)
Quyền ưu tiên 6 (0x06)
Bộ mô tả lưu lượng truy cập #1
Mã hệ điều hành + Loại mã ứng dụng hệ điều hành 0x97A498E3FC925C9489860333D06E4E4703434253
Nội dung mô tả lựa chọn tuyến đường #1
Quyền ưu tiên 1 (0x01)
Thành phần số 1: S-NSSAI SST:XX SD:YYYYYY
Thành phần số 2: DNN Cb
Nội dung mô tả lựa chọn tuyến đường #2
Quyền ưu tiên 2 (0x02)
Thành phần số 1: DNN Cb

Độ trễ thấp

Tính năng hỗ trợ Độ trễ thấp có trên Android 13 trở lên. Sau đây là ví dụ về quy tắc URSP cho lưu lượng truy cập LOW_LATENCY:

Quy tắc URSP số 7 (độ trễ thấp)
Quyền ưu tiên 7 (0x07)
Bộ mô tả lưu lượng truy cập #1
Mã hệ điều hành + Loại mã ứng dụng hệ điều hành 0x97A498E3FC925C9489860333D06E4E47125052494f524954495a455f4c4154454e4359
Nội dung mô tả lựa chọn tuyến đường #1
Quyền ưu tiên 1 (0x01)
Thành phần số 1: S-NSSAI SST:XX SD:YYYYYY
Thành phần số 2: DNN thời gian chờ
Nội dung mô tả lựa chọn tuyến đường #2
Quyền ưu tiên 2 (0x02)
Thành phần số 1: DNN thời gian chờ

Băng thông cao

Tính năng hỗ trợ băng thông cao có trên Android 13 trở lên. Sau đây là ví dụ về quy tắc URSP cho lưu lượng truy cập HIGH_BANDWIDTH:

Quy tắc URSP #8 (băng thông cao)
Quyền ưu tiên 8 (0x08)
Bộ mô tả lưu lượng truy cập #1
Mã hệ điều hành + Loại mã ứng dụng hệ điều hành 97A498E3FC925C9489860333D06E4E47145052494f524954495a455f42414e445749445448
Nội dung mô tả lựa chọn tuyến đường #1
Quyền ưu tiên 1 (0x01)
Thành phần số 1: S-NSSAI SST:XX SD:YYYYYY
Thành phần số 2: DNN băng thông
Nội dung mô tả lựa chọn tuyến đường #2
Quyền ưu tiên 2 (0x02)
Thành phần số 1: DNN băng thông

Mặc định

Quy tắc URSP #9 (mặc định)
Quyền ưu tiên 9 (0x09)
Bộ mô tả lưu lượng truy cập #1
khớp toàn bộ Không áp dụng
Nội dung mô tả lựa chọn tuyến đường #1
Quyền ưu tiên 1 (0x01)
Thành phần số 1: S-NSSAI SST:XX SD:YYYYYY

Thử nghiệm

Để kiểm tra tính năng cắt mạng 5G, hãy sử dụng quy trình kiểm tra thủ công sau đây.

Để thiết lập thiết bị cho mục đích kiểm thử, hãy làm như sau:

  1. Đảm bảo rằng bạn đã thiết lập chính sách URSP bằng một quy tắc không phải quy tắc mặc định khớp với danh mục doanh nghiệp và lựa chọn tuyến đường tương ứng phần mô tả liên kết danh mục doanh nghiệp với phần doanh nghiệp; và một quy tắc mặc định để hướng lưu lượng truy cập đến lát cắt Internet mặc định.

  2. Đảm bảo rằng bạn đã định cấu hình hồ sơ công việc trên thiết bị.

  3. Chọn sử dụng tính năng cắt mạng thông qua DPC

Để kiểm thử hành vi cắt lát mạng 5G, hãy làm như sau:

  1. Xác minh rằng phiên PDU được thiết lập bằng lát cắt doanh nghiệp (cho ví dụ: bằng cách dùng một địa chỉ IP cụ thể) và ứng dụng trong hồ sơ công việc sử dụng phiên PDU đó.
  2. Xác minh rằng một phiên PDU riêng biệt được thiết lập bằng mạng Internet mặc định lát cắt và ứng dụng trong hồ sơ cá nhân sử dụng phiên PDU.

Bán thêm dịch vụ 5G

Tính năng bán thêm dịch vụ 5G có sẵn tại Android 14-QPR1, cho phép nhà mạng cung cấp mạng nâng cao (độ trễ và băng thông) cho người dùng thông qua công nghệ phân chia mạng 5G.

Tính năng bán thêm dịch vụ 5G cắt lát sử dụng phản hồi TS.43 của nhà mạng máy chủ quyền để thúc đẩy quy trình mua. Nhà mạng có thể sử dụng phản hồi này để chỉ định URL cho chế độ xem web mua hàng của nhà cung cấp dịch vụ, gửi dữ liệu bổ sung cho webview và cho biết liệu lát cắt này đã được cấp phép và có sẵn trên mạng của nhà mạng.

Các nhà mạng có thể tuỳ chỉnh hành vi của tính năng bán thêm dịch vụ 5G bằng cách sử dụng chế độ cấu hình của nhà mạng. Chế độ này kiểm soát việc có thể gửi yêu cầu mua hàng hay không thực hiện, thời điểm ứng dụng được phép yêu cầu các tính năng cao cấp và khoảng thời gian Khung điện thoại chờ phản hồi từ người dùng hoặc mạng.

Tính năng bán thêm dịch vụ 5G cung cấp một giao diện, được gọi là DataBoostWebServiceFlow, để cho phép giao tiếp giữa Android và webview của nhà mạng.

Hình 2 thể hiện quy trình mua thêm dịch vụ 5G bán thêm:

Quy trình mua thêm dịch vụ 5G bán thêm

Hình 2. Quy trình mua thêm dịch vụ 5G để bán thêm.

Quy trình cấp quyền TS.43

Khi người dùng yêu cầu các chức năng nâng cao của mạng, Dịch vụ điện thoại khung yêu cầu cấu hình quyền sử dụng dịch vụ cho các tính năng nâng cao. Nếu phản hồi TS.43 là hợp lệ, khung Điện thoại sẽ sử dụng các trường từ phản hồi HTTP để thúc đẩy yêu cầu mua hàng.

Trường mua Lát cắt

Cấu hình quyền TS.43 bao gồm giao dịch mua lát cắt sau đây trường:

Trạng thái quyền

Phím: EntitlementStatus

Loại: int

Các giá trị được hỗ trợ: 0 (bị tắt), 1 (đã bật), 2 (không tương thích), 3 (cấp phép), 4 (được bao gồm)

Trạng thái cấp phép

Phím: ProvStatus

Loại: int

Các giá trị được hỗ trợ: 0 (không được cấp phép), 1 (được cấp phép), 2 (không có sẵn), 3 (đang tiến hành)

Khung Điện thoại sử dụng kết hợp trạng thái quyền truy cập và trạng thái cấp phép để xác định trạng thái mua lát cắt hiện tại. Kết quả có thể là một trong những trạng thái sau:

Nếu trạng thái quyền là 1 (đã bật) và trạng thái cấp phép là 0 (chưa được cấp phép), khung Điện thoại sẽ hiển thị thông báo bán thêm để người dùng mua ưu đãi tăng cường đó thông qua chế độ xem web của nhà mạng. Bảng sau đây mô tả hành vi của khung Điện thoại đối với các tổ hợp khác nhau giá trị trạng thái cấp phép và quyền.

Trạng thái cấp phép
Chưa được cấp phép (0) Đã cấp phép (1) Không có mặt (2) Đang tiến hành (3)
Trạng thái quyền Đã tắt (0) Không thành công Không thành công Không thành công Không thành công
Đã bật (1) Hiển thị chế độ xem web Đã mua Đã mua Đang diễn ra
Không tương thích (2) Không thành công Không thành công Không thành công Không thành công
Cấp phép (3) Lỗi nhà mạng Lỗi nhà mạng Đang diễn ra Đang diễn ra
Đã bao gồm (4) Lỗi nhà mạng Đã mua Đã mua Lỗi nhà mạng

Trường luồng dịch vụ

Phản hồi TS.43 chỉ định URL, dữ liệu người dùng và loại nội dung cần tuỳ chỉnh hành vi mua qua webview của nhà mạng. Nếu loại nội dung không được chỉ định, URL được tải dưới dạng một yêu cầu GET. Nếu dữ liệu người dùng tồn tại, dữ liệu đó sẽ được thêm vào URL dưới dạng tham số truy vấn (ví dụ: https://www.android.com?encodedValue=Base64EncodedUserData); còn nếu không tồn tại, thì URL sẽ được sử dụng nguyên trạng (ví dụ: https://www.android.com).
Nếu loại nội dung được chỉ định theo định dạng JSON hoặc XML, URL sẽ được tải dưới dạng Yêu cầu POST và dữ liệu người dùng (được giải mã nếu được mã hoá trong Cơ sở 64) được gửi dưới dạng dữ liệu cho yêu cầu POST.

URL

Phím: ServiceFlow_URL

Loại: String

Ví dụ: "https://www.android.com"

Dữ liệu người dùng

Phím: ServiceFlow_UserData

Loại: String

Ví dụ: "encodedValue=Base64EncodedUserData"

Loại nội dung

Phím: ServiceFlow_ContentsType

Loại: String

Giá trị được hỗ trợ: 0 (không chỉ định), 1 (JSON), 2 (XML)

Cấu hình nhà mạng

Sau đây là các cấu hình nhà mạng có sẵn để tuỳ chỉnh hành vi của tính năng bán thêm dịch vụ 5G.

KEY_SUPPORTED_PREMIUM_CAPABILITIES_INT_ARRAY

Danh sách các tính năng nâng cao được hỗ trợ. Đây là một mảng int của TelephonyManager.PremiumCapability. Các tính năng nâng cao này có cùng giá trị với NetworkCapabilities.NetCapability . Nếu bạn yêu cầu một tính năng nâng cao nhưng chức năng đó không nằm trong phạm vi yêu cầu thì yêu cầu mua hàng không thành công với CARRIER_DISABLED kết quả.

Chỉ trong Android 14, PREMIUM_CAPABILITY_PRIORITIZE_LATENCY được hỗ trợ.

KEY_PREMIUM_CAPABILITY_MAXIMUM_DAILY_NOTIFICATION_COUNT_INT

Số lần thông báo bán thêm giao dịch mua được hiển thị trong ngày tối đa hằng ngày người dùng. Nếu đã đạt đến mức tối đa hằng ngày, thông báo bán thêm sẽ không xuất hiện và yêu cầu mua hàng (bao gồm cả yêu cầu máy chủ quyền) bị hạn chế cho đến khi nửa đêm của ngày tiếp theo. Yêu cầu mua hàng được đưa ra sau mức tối đa hằng ngày là đạt được không thành công với PURCHASE_PREMIUM_CAPABILITY_RESULT_THROTTLED kết quả.

KEY_PREMIUM_CAPABILITY_MAXIMUM_MONTHLY_NOTIFICATION_COUNT_INT

Số lần thông báo hiển thị việc bán thêm giao dịch mua tối đa hằng tháng cho người dùng. Nếu đạt đến số lượng tối đa hằng tháng, thông báo bán thêm sẽ không hiển thị và yêu cầu mua hàng (bao gồm cả yêu cầu máy chủ quyền) đều bị điều tiết cho đến ngày đầu tiên của tháng tiếp theo. Yêu cầu mua hàng được đưa ra sau đã đạt đến giới hạn tối đa hàng tháng không thành công với PURCHASE_PREMIUM_CAPABILITY_RESULT_THROTTLED kết quả.

KEY_PREMIUM_CAPABILITY_PURCHASE_URL_STRING

URL mua qua nhà mạng dự phòng để hiển thị cho người dùng khi họ nhấp vào thông báo bán thêm. Nếu không tìm thấy URL mua hàng trong phản hồi TS.43 từ máy chủ quyền, thì giá trị này sẽ được dùng. Nếu không có URL từ phản hồi TS.43 hoặc cấu hình của nhà mạng là hợp lệ, thì yêu cầu mua không thành công với PURCHASE_PREMIUM_CAPABILITY_RESULT_CARRIER_DISABLED kết quả.

KEY_PREMIUM_CAPABILITY_SUPPORTED_ON_LTE_BOOL

Liệu có cho phép mua các tính năng nâng cao khi thiết bị đang kết nối với công nghệ Long-Term Evolution (LTE). Nếu giá trị trả về là true, yêu cầu mua hàng có thể thực hiện trên cả LTE và Radio mới (NR). Nếu false thân mến, chỉ có thể thực hiện yêu cầu mua hàng trên NR và không thực hiện được yêu cầu trên LTE với PURCHASE_PREMIUM_CAPABILITY_RESULT_NETWORK_NOT_AVAILABLE kết quả.

KEY_PREMIUM_CAPABILITY_NOTIFICATION_DISPLAY_TIMEOUT_MILLIS_LONG

Khoảng thời gian hiển thị thông báo bán thêm sản phẩm cho người dùng trước nó sẽ tự động bị huỷ. Khi thông báo bị huỷ, được điều tiết và không thực hiện được với PURCHASE_PREMIUM_CAPABILITY_RESULT_THROTTLED kết quả.

KEY_PREMIUM_CAPABILITY_NOTIFICATION_BACKOFF_HYSTERESIS_TIME_MILLIS_LONG

Khoảng thời gian mà các yêu cầu mua hàng tiếp theo sẽ được điều tiết sau khi lỗi do hết thời gian chờ hoặc do người dùng huỷ. Nếu người dùng không nhấp vào thông báo bán thêm trong thời gian chờ được chỉ định bởi KEY_PREMIUM_CAPABILITY_NOTIFICATION_DISPLAY_TIMEOUT_MILLIS_LONG hoặc nếu họ huỷ hay loại bỏ thông báo, thì bộ tính giờ đợi này sẽ bắt đầu. Trong khi bộ tính giờ này đang hoạt động, nên yêu cầu mua hàng không thành công PURCHASE_PREMIUM_CAPABILITY_RESULT_THROTTLED kết quả.

KEY_PREMIUM_CAPABILITY_PURCHASE_CONDITION_BACKOFF_HYSTERESIS_TIME_MILLIS_LONG

Khoảng thời gian mà các yêu cầu mua hàng tiếp theo sẽ được điều tiết sau khi lỗi do nhà mạng hoặc mạng. Nếu quy trình kiểm tra quyền không thành công, URL không có sẵn hoặc URL mua hàng của nhà mạng cho thấy bị lỗi, thời gian đợi này đồng hồ hẹn giờ đó sẽ bắt đầu. Khi bộ tính giờ này hoạt động, các yêu cầu mua hàng sẽ không thực hiện được với thời gian PURCHASE_PREMIUM_CAPABILITY_RESULT_THROTTLED kết quả.

KEY_PREMIUM_CAPABILITY_NETWORK_SETUP_TIME_MILLIS_LONG

Khoảng thời gian cần thiết để mạng phải thiết lập cấu hình phân chia cho tính năng mua đặc biệt. Trong thời gian này, giao dịch mua tiếp theo các yêu cầu bị chặn và trả về PURCHASE_PREMIUM_CAPABILITY_RESULT_PENDING_NETWORK_SETUP kết quả. Nếu mạng không kịp thời thiết lập cấu hình phân chia, các ứng dụng có thể hãy yêu cầu mua lại các tính năng nâng cao. Điện thoại không coi hoàn tất giao dịch mua cho đến khi cấu hình phân chia tương ứng được gửi, bất kể người dùng có trả tiền cho nhà mạng hay không.

Giao diện JavaScript

Khi người dùng nhấp vào thông báo tăng cường mạng, một đối tượng WebView có URL giao dịch mua qua nhà mạng sẽ được hiển thị cho người dùng. Nhà mạng có thể sử dụng API được cung cấp trong DataBoostWebServiceFlow Giao diện JavaScript trên trang web mua hàng để giao tiếp với nhóm khách hàng mua ứng dụng.

Trang web của nhà mạng có thể lấy tính năng nâng cao đã yêu cầu thông qua phương thức getRequestedCapability().

Nếu giao dịch mua thành công, trang web của nhà mạng phải thông báo cho bộ phận đó mua ứng dụng qua notifyPurchaseSuccessful() hoặc notifyPurchaseSuccessful(duration), trong đó duration là tham số không bắt buộc cho biết thời lượng dự kiến của lát cắt.

Nếu giao dịch mua không thành công, trang web của nhà mạng phải thông báo cho lát cắt mua ứng dụng thông qua phương thức notifyPurchaseFailed(code, reason), trong đó code là mã lỗi cho biết nguyên nhân gây ra lỗi và reason là lý do con người có thể đọc được của lỗi nếu không xác định được mã lỗi.

Nếu một trong hai phương thức phản hồi này không được gọi, giao dịch mua sẽ không được coi là đã hoàn tất và yêu cầu mua hàng cuối cùng hết thời gian.

Sau đây là các mã lỗi hợp lệ mà trang web của nhà mạng có thể trả lại đối với giao dịch mua không thành công:

Khi giao dịch mua hoàn tất, hãng vận chuyển phải cập nhật Quy tắc URSP bằng lát cắt PRIORITIZE_LATENCY cho thiết bị của người dùng.