5G ağ dilimleme

Android 12 veya sonraki sürümleri çalıştıran cihazlarda Android, 5G ağı dilimleme desteği sunar. Ağ sanallaştırma kullanarak tek ağ bağlantısını, farklı trafik türlerine farklı miktarlarda kaynak sağlayan birden fazla farklı sanal bağlantıya bölmek için kullanılır. 5G ağı dilimleme, ağ operatörlerinin ağın bir kısmını belirli bir müşteri segmenti için belirli özellikler sağlamaya ayırmasına olanak tanır. Android 12, ağ operatörlerinin kurumsal müşterilerine sağlayabileceği aşağıdaki 5G kurumsal ağ dilimleme özelliklerini sunar:

Tümüyle yönetilen cihazlar için kurumsal cihaz dilimleme

Çalışanlarına tamamen yönetilen şirket cihazları sağlayan kuruluşlar için ağ sağlayıcılar, şirket cihazlarındaki trafiğin yönlendirildiği bir veya daha fazla etkin kurumsal ağ dilimi sağlayabilir. Android 12'den itibaren Android, operatörlerin APN'ler aracılığıyla dilimler ayarlamak yerine URSP kuralları aracılığıyla kurumsal dilimler sağlamasına olanak tanır.

İş profilleri olan cihazlar için kurumsal iş uygulaması dilimleme

İş profili çözümünü kullanan kuruluşlar için Android 12, cihazların iş profilindeki tüm uygulamalardan gelen trafiği bir kuruluş ağı dilimiyle yönlendirmesine olanak tanır. Kuruluşlar bu özelliği bir Cihaz Politikası Denetleyicisi (DPC) aracılığıyla etkinleştirebilir.

İş profili çözümü, kuruluşların yalnızca iş profilindeki kurumsal uygulamalardan gelen trafiğin kurumsal ağ dilimlerine yönlendirilmesini sağlamak için ihtiyaç duyduğu otomatik bir kimlik doğrulama ve erişim denetimi düzeyi sağlar. İş profilindeki uygulamaların, kurumsal ağ dilimlerini açıkça isteyecek şekilde değiştirilmesi gerekmez.

AOSP'de 5G ağ dilimleme nasıl çalışır?

Android 12, ağ dilimleme için gereken mevcut bağlantı API'lerini dahil etmek üzere AOSP'deki telefon kod tabanına ve Tethering modülüne yapılan eklemeler sayesinde 5G ağ dilimleme desteği sunar.

Android telefon platformu, temel ağ kodu tarafından gönderilen ağ isteklerine ve modemdeki 5G dilimleme özelliklerine göre dilimlemeyi desteklemek için HAL ve telefon API'leri sağlar. Şekil 1'de 5G ağ dilimleme özelliğinin bileşenleri açıklanmaktadır.

5G ağ dilimi bileşenleri

Şekil 1. AOSP'de 5G ağ dilimleme mimarisi.

Telefon ve bağlantı platformu şunları destekler:

  • Dilim kategorileri için ağ isteklerini, URSP trafik eşleştirme ve rota seçimi için modeme iletilen trafik tanımlayıcılarına dönüştürme
  • Kurumsal ağ dilimi kullanılamıyorsa varsayılan ağa geri dönme
  • İş profili kapsamındaki tüm uygulamalardan gelen trafiği ilgili bağlantıya yönlendirme

  • Kurumsal dilimleme desteği

    • Cihazdaki iş profilinin varlığını algılama
    • Kurumun BT yöneticisinin kullandığıDPC'den sağlanan izinleri veya yönlendirme talimatlarını kontrol ederek

Temel ağ iletişimi hizmeti, Android 12'deki Tethering modülünde yapılan aşağıdaki değişiklikleri içerir:

  • Tethering modülüne android.net.* herkese açık API veya sistem API sınıfının çoğunu ekler

  • Tethering modülü sınırlarını şunları içerecek şekilde genişletir:

    • 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

  • VPN kodunu Tethering modülünden çıkarır

Android 12, aşağıdaki özelliklere sahip kodu Tethering modülüne taşır:

  • Uygulamalardan ağ bağlantıları için istek alma
  • Sistemden istek alma (örneğin, Android 12'de kullanıma sunulan "bu uygulamaları bir kurumsal dilime yerleştir")
  • Sistemden HAL API ve modem üzerinden ağ veya dilim kurmaya çalışan telefon koduna istek gönderme
  • netd'ye trafiğin uygulama bazında nasıl yönlendirileceğini bildirme (Android 12'de kullanıma sunulmuştur)
  • NetworkCallback, getActiveNetwork, getNetworkCapabilities gibi ConnectivityManager API'leri aracılığıyla uygulamaları ağ trafikleriyle ilgili gelişmelerden haberdar etme

Uygulama

Bir cihazda 5G dilimlemenin desteklenmesi için cihazda setupDataCall_1_6 API'ye sahip IRadio 1.6 HAL'yi destekleyen bir modem olmalıdır. Bu API, bir veri bağlantısı oluşturur ve 5G dilimleme desteği için aşağıdaki parametreleri içerir:

  • trafficDescriptor: Modeme gönderilen trafik tanımlayıcısını belirtir
  • sliceInfo: EPDG'den 5G'ye geçiş durumunda kullanılacak ağ dilimi bilgilerini belirtir
  • matchAllRuleAllowed: Varsayılan bir her şeyi eşleyen URSP kuralının kullanılmasına izin verilip verilmeyeceğini belirtir. Telefon, bu değeri varsayılan ağlar için doğru olarak ayarlar ancak dilimler için ayarlamaz. Tümünü eşle kuralı, varsayılan ağlara uygulanır. Bir uygulama, mevcut olmayan belirli bir dilim istediğinde söz konusu dilim mevcut değil olarak raporlanır. Kuruluş uygulamaları için Telephony çerçevesi, kuruluş ağı kullanılamıyorsa varsayılan ağa geri dönebilir.

Modemler, getHalDeviceCapabilities API tarafından desteklenmediği bildirilmediği sürece getSlicingConfig API'yi de uygulamalıdır.

Enterprise koşulları

Aşağıda, işletmelerin Android Enterprise dağıtımındaki cihazlarda 5G ağ dilimleme özelliğini kullanması için geçerli olan gereksinimler açıklanmaktadır.

  • İş profiliyle ayarlanmış tümüyle yönetilen veya çalışan cihazların, setupDataCall_1_6 API'yi destekleyen modemlerle 5G SA özellikli olduğundan emin olun.
  • Dilim kurulumu ve performansı ya da hizmet düzeyi sözleşmesi özellikleri konusunda operatör iş ortağıyla çalışın.

İş profiliyle ayarlanmış cihazlarda 5G dilimleme özelliğini etkinleştirme

İş profilleriyle ayarlanan cihazlarda, AOSP'de 5G ağ dilimleme varsayılan olarak devre dışıdır. Kurumsal BT yöneticileri, ağ dilimleme özelliğini etkinleştirmek için DevicePolicyManager (DPM) API'sinde (Android 12'de kullanıma sunulmuştur) setPreferentialNetworkServiceEnabled yöntemini kullanan EMM DPC aracılığıyla iş profili uygulama trafiğinin kurumsal ağ dilimlerine yönlendirilmesini çalışan başına etkinleştirebilir veya devre dışı bırakabilir.

Özel DPC'lere sahip EMM tedarikçileri, kurumsal istemcileri desteklemek için DevicePolicyManager API'yi entegre etmelidir.

URSP kuralları

Bu bölümde, operatörlere yönelik olarak kurumsal, CBS, düşük gecikme süresi ve yüksek bant genişliği trafiği gibi farklı dilim kategorileri için URSP kurallarının yapılandırılmasıyla ilgili bilgiler yer almaktadır. Farklı dilim kategorileri için URSP kurallarını yapılandırırken operatörler aşağıdaki Android'e özgü değerleri kullanmalıdır.

Kimlik Değer Açıklama
OSId 97a498e3-fc92-5c94-8986-0333d06e4e47 Android için OSId, ISOOID ad alanı ve "Android" adıyla oluşturulan 5. sürüm bir UUID'dir.

Operatörler, her dilim trafiği için URSP kurallarını trafik tanımlayıcısı bileşeni "OS kimliği + OS uygulama kimliği türü" olarak yapılandırmalıdır. Örneğin, "ENTERPRISE" dilimi 0x97A498E3FC925C9489860333D06E4E470A454E5445525052495345 değerine sahip olmalıdır. Bu değer, OSId, OSAppId'nin uzunluğu (0x0A) ve OSAppId'nin bir araya getirilmesidir. Trafik tanımlayıcısı bileşen türü hakkında daha fazla bilgi için 3GPP TS 24.526 Tablo 5.2.1'e bakın.

Aşağıdaki tabloda, farklı dilim kategorileri için OSAppId değerleri açıklanmaktadır.

Dilim kategorisi OSAppId Açıklama
ENTERPRISE 0x454E5445525052495345 OSAppId, "ENTERPRISE" dizesinin bayt dizisi temsilidir.
KURUMSAL2 0x454E544552505249534532 OSAppId, "ENTERPRISE2" dizesinin bayt dizisi gösterimidir.
ENTERPRISE3 0x454E544552505249534533 OSAppId, "ENTERPRISE3" dizesinin bayt dizisi temsilidir.
ENTERPRISE4 0x454E544552505249534534 OSAppId, "ENTERPRISE4" dizesinin bayt dizisi temsilidir.
KURUMSAL5 0x454E544552505249534535 OSAppId, "ENTERPRISE5" dizesinin bayt dizisi temsilidir.
CBS 0x434253 OSAppId, "CBS" dizesinin bayt dizisi gösterimidir.
PRIORITIZE_LATENCY 0x5052494f524954495a455f4c4154454e4359 OSAppId, "PRIORITIZE_LATENCY" dizesinin bayt dizisi gösterimidir.
PRIORITIZE_BANDGENİŞLİK 0x5052494f524954495a455f42414e445749445448 OSAppId, "PRIORITIZE_BANDWIDTH" dizesinin bayt dizisi gösterimidir.

Örnek URSP kuralları

Aşağıdaki tablolarda kurumsal, CBS, düşük gecikme süresi, yüksek bant genişliği ve varsayılan trafik için örnek URSP kuralları gösterilmektedir.

Enterprise 1

Enterprise 1 desteği Android 12 ve sonraki sürümlerde kullanılabilir. Aşağıda, ENTERPRISE1 trafiği için örnek bir URSP kuralı verilmiştir:

URSP kuralı 1 (kuruluş1)
Öncelik 1 (0x01)
Trafik tanımlayıcısı #1
OS Id + OS App Id türü 0x97A498E3FC925C9489860333D06E4E470A454E5445525052495345
Rota seçimi tanımlayıcısı 1
Öncelik 1 (0x01)
1. Bileşen: S-NSSAI SST:XX SD:YYYYYY
2. Bileşen: DNN Enterprise
Rota seçimi tanımlayıcısı #2
Öncelik 2 (0x02)
1. Bileşen: DNN işletme

Enterprise 2

Enterprise 2 desteği Android 13 ve sonraki sürümlerde kullanılabilir. Aşağıda, ENTERPRISE2 trafiği için örnek bir URSP kuralı verilmiştir:

URSP kuralı #2 (enterprise2)
Öncelik 2 (0x02)
Trafik tanımlayıcısı #1
OS Id + OS App Id türü 0x97A498E3FC925C9489860333D06E4E470B454E544552505249534532
Rota seçimi tanımlayıcısı 1
Öncelik 1 (0x01)
1. Bileşen: S-NSSAI SST:XX SD:YYYYYY
2. Bileşen: DNN kuruluş2
Rota seçimi tanımlayıcısı #2
Öncelik 2 (0x02)
1. bileşen: DNN enterprise2

Kurum 3

Enterprise 3 desteği Android 13 ve sonraki sürümlerde kullanılabilir. Aşağıda, ENTERPRISE3 trafiği için örnek bir URSP kuralı gösterilmektedir:

URSP kuralı 3 (enterprise3)
Öncelik 3 (0x03)
Trafik tanımlayıcısı #1
OS Id + OS App Id türü 0x97A498E3FC925C9489860333D06E4E470B454E544552505249534533
Rota seçimi tanımlayıcısı 1
Öncelik 1 (0x01)
1. Bileşen: S-NSSAI SST:XX SD:YYYYYY
2. Bileşen: DNN kurumsal3
Rota seçimi açıklayıcı 2
Öncelik 2 (0x02)
1. bileşen: DNN kuruluş3

Enterprise 4

Enterprise 4 desteği, Android 13 ve sonraki sürümlerde mevcuttur. Aşağıda, ENTERPRISE4 trafiği için örnek bir URSP kuralı verilmiştir:

4. URSP kuralı (kuruluş4)
Öncelik 4 (0x04)
Trafik tanımlayıcısı 1
OS Id + OS App Id türü 0x97A498E3FC925C9489860333D06E4E470B454E544552505249534534
Rota seçimi tanımlayıcısı 1
Öncelik 1 (0x01)
1. Bileşen: S-NSSAI SST:XX SD:YYYYYY
2. Bileşen: DNN kurumsal4
Rota seçimi açıklayıcı 2
Öncelik 2 (0x02)
1. bileşen: DNN kurumsal4

Enterprise 5

Enterprise 5 desteği Android 13 ve sonraki sürümlerde kullanılabilir. Aşağıda, ENTERPRISE5 trafiği için örnek bir URSP kuralı verilmiştir:

URSP kuralı 5 (kurumsal5)
Öncelik 5 (0x05)
Trafik tanımlayıcısı 1
OS Id + OS App Id türü 0x97A498E3FC925C9489860333D06E4E470B454E544552505249534535
Rota seçimi tanımlayıcısı 1
Öncelik 1 (0x01)
1. Bileşen: S-NSSAI SST:XX SD:YYYYYY
2. Bileşen: DNN kurumsal5
Rota seçimi tanımlayıcısı #2
Öncelik 2 (0x02)
1. bileşen: DNN kuruluş5

CBS

CBS desteği Android 13 ve sonraki sürümlerde kullanılabilir. Aşağıda, CBS trafiği için örnek bir URSP kuralı verilmiştir:

6. URSP kuralı (CBS)
Öncelik 6 (0x06)
Trafik tanımlayıcısı #1
OS Id + OS App Id türü 0x97A498E3FC925C9489860333D06E4E4703434253
Rota seçimi tanımlayıcısı 1
Öncelik 1 (0x01)
1. Bileşen: S-NSSAI SST:XX SD:YYYYYY
2. Bileşen: DNN cbs
Rota seçimi tanımlayıcısı #2
Öncelik 2 (0x02)
1. Bileşen: DNN cbs

Düşük gecikme

Düşük Gecikme desteği, Android 13 ve sonraki sürümlerde mevcuttur. Aşağıda, LOW_LATENCY trafiği için örnek bir URSP kuralı verilmiştir:

URSP kuralı 7 (düşük gecikme)
Öncelik 7 (0x07)
Trafik tanımlayıcısı #1
OS Id + OS App Id türü 0x97A498E3FC925C9489860333D06E4E47125052494f524954495a455f4c4154454e4359
Güzergah seçimi açıklayıcısı 1
Öncelik 1 (0x01)
1. Bileşen: S-NSSAI SST:XX SD:YYYYYY
2. Bileşen: DNN gecikme
Rota seçimi tanımlayıcısı #2
Öncelik 2 (0x02)
1. bileşen: DNN gecikme

Yüksek bant genişliği

Yüksek bant genişliği desteği Android 13 ve sonraki sürümlerde kullanılabilir. Aşağıda, HIGH_BANDWIDTH trafiği için örnek bir URSP kuralı verilmiştir:

URSP kuralı 8 (yüksek bant genişliği)
Öncelik 8 (0x08)
Trafik tanımlayıcısı #1
OS Id + OS App Id türü 97A498E3FC925C9489860333D06E4E47145052494f524954495a455f42414e445749445448
Rota seçimi tanımlayıcısı 1
Öncelik 1 (0x01)
1. Bileşen: S-NSSAI SST:XX SD:YYYYYY
2. Bileşen: DNN bant genişliği
Rota seçimi tanımlayıcısı #2
Öncelik 2 (0x02)
1. bileşen: DNN bant genişliği

Varsayılan

9. URSP kuralı (varsayılan)
Öncelik 9 (0x09)
Trafik tanımlayıcısı 1
tümünü eşleştir Yok
Rota seçimi tanımlayıcısı 1
Öncelik 1 (0x01)
1. Bileşen: S-NSSAI SST:XX SD:YYYYYY

Test

5G ağ dilimleme işlemini test etmek için aşağıdaki manuel testi kullanın.

Bir cihazı test için ayarlamak üzere aşağıdakileri yapın:

  1. URSP politikasının, kuruluş kategorisiyle eşleşen varsayılan olmayan bir kuralla yapılandırıldığından ve ilgili rota seçimi tanımlayıcının, kuruluş kategorisini kuruluş dilimiyle eşleştirdiğinden ve trafiği varsayılan internet dilimiyle yönlendiren bir varsayılan kuraldan oluştuğundan emin olun.

  2. Cihazda bir iş profilinin yapılandırıldığından emin olun.

  3. DPC üzerinden ağ dilimlemeyi kullanmayı etkinleştir

5G ağ dilimleme davranışını test etmek için aşağıdakileri yapın:

  1. Enterprise slice ile bir PDU oturumunun kurulduğunu (ör. belirli bir IP adresi kullanılarak) ve iş profilindeki uygulamaların bu PDU oturumunu kullandığını doğrulayın.
  2. Varsayılan internet dilimiyle ayrı bir PDU oturumu oluşturulduğunu ve kişisel profildeki uygulamaların PDU oturumunu kullandığını doğrulayın.

5G dilimleme için upsell

Android 14-QPR1'den itibaren kullanılabilen 5G dilimleme upsell özelliği, operatörlerin 5G ağ dilimleme aracılığıyla kullanıcılarına gelişmiş ağ özellikleri (gecikme ve bant genişliği) sunmasına olanak tanır.

5G dilimleme upsell özelliği, satın alma akışını yönlendirmek için operatör uygunluk sunucusundan gelen TS.43 yanıtını kullanır. Operatörler, yanıtı kullanarak operatörün satın alma web görünümünün URL'sini belirtebilir, web görünümüne ek veri gönderebilir ve dilimin operatör ağında yapılandırılıp yapılandırılmadığını ve kullanılıp kullanılamayacağını belirtebilir.

Operatörler, satın alma isteklerinin yapılıp yapılamayacağını, uygulamaların ne zaman premium özellikler istemesine izin verileceğini ve Telefon çerçevesinin kullanıcıdan veya ağdan yanıt bekleme süresini kontrol eden operatör yapılandırmalarını kullanarak 5G dilimleme upsell özelliğinin davranışını özelleştirebilir.

5G dilimleme upsell özelliği, Android ile operatörün web görünümü arasında iletişime izin vermek için DataBoostWebServiceFlow adlı bir arayüz sağlar.

Şekil 2'de 5G dilimleme upsell satın alma akışı gösterilmektedir:

5G dilimleme upsell satın alma akışı

Şekil 2. 5G dilimleme upsell satın alma akışı.

TS.43 uygunluk süreci

Bir kullanıcı gelişmiş ağ özellikleri için istekte bulunduğunda, Telefon çerçevesi istenen premium özellik için hizmet yararlanma hakkı yapılandırmasını ister. TS.43 yanıtı geçerliyse Telephony çerçevesi, satın alma isteğini yönlendirmek için HTTP yanıtındaki alanları kullanır.

Satın alma dilimi alanları

TS.43 hak tanımlaması aşağıdaki dilim satın alma alanlarını içerir:

Yararlanma hakkı durumu

Tuş: EntitlementStatus

Tür: int

Desteklenen değerler: 0 (devre dışı), 1 (etkin), 2 (uyumlu değil), 3 (tanımlama), 4 (dahil)

Temel hazırlık durumu

Tuş: ProvStatus

Tür: int

Desteklenen değerler: 0 (destek sağlanmadı), 1 (destek sağlandı), 2 (kullanılamıyor), 3 (devam ediyor)

Telefon çerçevesi, mevcut dilim satın alma durumunu belirlemek için yararlanma hakkı durumu ile temel hazırlık durumunun kombinasyonunu kullanır. Sonuç aşağıdakilerden biri olabilir:

Hak durumu 1 (etkin) ve temel hazırlama durumu 0 (temel hazırlama yapılmadı) ise Telephony çerçevesi, kullanıcıya operatör web görünümü üzerinden artırmayı satın alması için bir upsell bildirimi gösterir. Aşağıdaki tabloda, temel hazırlama ve uygunluk durumu değerlerinin farklı kombinasyonları için Telefon çerçevesinin davranışı açıklanmaktadır.

Temel hazırlık durumu
Temel hazırlığı yapılmadı (0) Hazırlanmış (1) Mevcut değil (2) Devam ediyor (3)
Yararlanma hakkı durumu Devre dışı bırakılan (0) Başarısız Başarısız Başarısız Başarısız
Etkin (1) Web görünümünü gösterme Zaten satın alındı Zaten satın alındı Devam ediyor
Uyumlu değil (2) Başarısız Başarısız Başarısız Başarısız
Hazırlama (3) Operatör hatası Operatör hatası Devam ediyor Devam ediyor
Dahildir (4) Operatör hatası Zaten satın alındı Zaten satın alındı Operatör hatası

Hizmet akışı alanları

TS.43 yanıtı, operatör satın alma işlemi web görünümü davranışını özelleştirmek için URL'yi, kullanıcı verilerini ve içerik türünü belirtir. İçerik türü belirtilmezse URL, GET isteği olarak yüklenir. Kullanıcı verileri varsa URL'ye sorgu parametresi olarak eklenir (örneğin, https://www.android.com?encodedValue=Base64EncodedUserData); yoksa URL olduğu gibi kullanılır (örneğin, https://www.android.com).
İçerik türü JSON veya XML biçiminde belirtilirse URL bir POST isteği olarak yüklenir ve kullanıcı verileri (Base 64 ile kodlanmışsa kodu çözülür) POST isteği verileri olarak gönderilir.

URL

Tuş: ServiceFlow_URL

Tür: String

Örnek: "https://www.android.com"

Kullanıcı verileri

Tuş: ServiceFlow_UserData

Tür: String

Örnek: "encodedValue=Base64EncodedUserData"

İçerik türü

Tuş: ServiceFlow_ContentsType

Tür: String

Desteklenen değerler: 0 (belirtilmemiş), 1 (JSON), 2 (XML)

Operatör yapılandırmaları

Aşağıda, 5G dilimleme upsell özelliğinin davranışını özelleştirmek için kullanılabilen operatör yapılandırmaları verilmiştir.

KEY_SUPPORTED_PREMIUM_CAPABILITIES_INT_ARRAY

Desteklenen premium özelliklerin listesi. Bu, TelephonyManager.PremiumCapability öğesinin bir int dizisidir. Bu premium özellikler, ilgili NetworkCapabilities.NetCapability sınıfıyla aynı değere sahiptir. Premium özellik istenir ve bu yapılandırmaya dahil edilmezse satın alma isteği CARRIER_DISABLED sonucuyla başarısız olur.

Android 14'te yalnızca PREMIUM_CAPABILITY_PRIORITIZE_LATENCY desteklenir.

KEY_PREMIUM_CAPABILITY_MAXIMUM_DAILY_NOTIFICATION_COUNT_INT

Satın alma işlemiyle ilgili upsell bildiriminin kullanıcıya gösterilebileceği maksimum günlük sayı. Günlük maksimum değer karşılanırsa upsell bildirimi gösterilmez ve satın alma istekleri (hak kazanma sunucusu istekleri dahil) ertesi günün gece yarısına kadar sınırlandırılır. Günlük maksimum değere ulaşıldığında yapılan satın alma istekleri PURCHASE_PREMIUM_CAPABILITY_RESULT_THROTTLED sonucuyla başarısız olur.

KEY_PREMIUM_CAPABILITY_MAXIMUM_MONTHLY_NOTIFICATION_COUNT_INT

Satın alma işlemiyle ilgili upsell bildiriminin kullanıcıya aylık maksimum gösterilme sayısı. Aylık maksimum değer karşılanırsa upsell bildirimi gösterilmez ve satın alma istekleri (hak kazanma sunucusu istekleri dahil) sonraki ayın ilk gününe kadar sınırlandırılır. Aylık maksimum değere ulaşıldığında yapılan satın alma istekleri PURCHASE_PREMIUM_CAPABILITY_RESULT_THROTTLED sonucuyla başarısız olur.

KEY_PREMIUM_CAPABILITY_PURCHASE_URL_STRING

Kullanıcı, upsell bildirimini tıkladığında gösterilecek yedek operatör satın alma URL'si. Satın alma URL'si, uygunluk sunucusundan gelen TS.43 yanıtında bulunamazsa bunun yerine bu değer kullanılır. TS.43 yanıtındaki URL veya operatör yapılandırması geçerli değilse satın alma isteği PURCHASE_PREMIUM_CAPABILITY_RESULT_CARRIER_DISABLED sonucuyla başarısız olur.

KEY_PREMIUM_CAPABILITY_SUPPORTED_ON_LTE_BOOL

Cihaz Long-Term Evolution'a (LTE) bağlıyken premium özelliklerin satın alınmasına izin verilip verilmeyeceğini belirtir. true ise satın alma istekleri hem LTE hem de Yeni Radyo (NR) üzerinden gönderilebilir. false ise satın alma istekleri yalnızca NR'de gönderilebilir ve LTE'de yapılan istekler PURCHASE_PREMIUM_CAPABILITY_RESULT_NETWORK_NOT_AVAILABLE sonucuyla birlikte başarısız olur.

KEY_PREMIUM_CAPABILITY_NOTIFICATION_DISPLAY_TIMEOUT_MILLIS_LONG

Otomatik olarak iptal edilmeden önce satın alma upsell bildiriminin kullanıcıya gösterileceği süre. Bildirim iptal edildiğinde, sonraki istekler sınırlanır ve PURCHASE_PREMIUM_CAPABILITY_RESULT_THROTTLED sonucuyla başarısız olur.

KEY_PREMIUM_CAPABILITY_NOTIFICATION_BACKOFF_HYSTERESIS_TIME_MILLIS_LONG

Zaman aşımı veya kullanıcının iptal etmesi nedeniyle başarısız olan bir satın alma işleminin ardından sonraki satın alma isteklerinin sınırlandırılması gereken süre. Kullanıcı, KEY_PREMIUM_CAPABILITY_NOTIFICATION_DISPLAY_TIMEOUT_MILLIS_LONG tarafından belirtilen zaman aşımı içinde satın alma işlemiyle ilgili upsell bildirimini tıklamazsa veya bildirimi iptal eder ya da kapatırsa bu geri çekilme zamanlayıcısı başlar. Bu zamanlayıcı etkinken satın alma istekleri PURCHASE_PREMIUM_CAPABILITY_RESULT_THROTTLED sonucuyla başarısız olur.

KEY_PREMIUM_CAPABILITY_PURCHASE_CONDITION_BACKOFF_HYSTERESIS_TIME_MILLIS_LONG

Operatör veya ağ nedeniyle başarısız olan bir satın alma işleminden sonra sonraki satın alma isteklerinin sınırlandırılması gereken süre. Yetkilendirme kontrolü başarısız olursa, URL kullanılamıyorsa veya operatör satın alma URL'si bir hata gösteriyorsa bu geri çekilme zamanlayıcısı başlar. Bu zamanlayıcı etkinken satın alma istekleri PURCHASE_PREMIUM_CAPABILITY_RESULT_THROTTLED sonucuyla başarısız olur.

KEY_PREMIUM_CAPABILITY_NETWORK_SETUP_TIME_MILLIS_LONG

Ağın, satın alma premium özelliği için bir dilimleme yapılandırması oluşturması gereken süre. Bu süre zarfında, sonraki satın alma istekleri engellenir ve PURCHASE_PREMIUM_CAPABILITY_RESULT_PENDING_NETWORK_SETUP sonucu döndürülür. Ağ, dilimleme yapılandırmasını zamanında oluşturamazsa uygulamalar, premium özellikleri tekrar satın almayı isteyebilir. Kullanıcının operatöre ödeme yapıp yapmadığına bakılmaksızın, telefon hizmeti, ilgili dilim yapılandırması gönderilene kadar satın alma işlemini tamamlanmış olarak kabul etmez.

JavaScript arayüzü

Kullanıcı, ağ güçlendirme bildirimini tıkladığında operatör satın alma URL'sini içeren bir WebView nesnesi gösterilir. Operatörler, satın alma web sitelerindeki DataBoostWebServiceFlow JavaScript arayüzünde sağlanan API'leri kullanarak dilim satın alma uygulamasıyla iletişim kurabilir.

Operatör web sitesi, istenen premium özelliği getRequestedCapability() yöntemi aracılığıyla alabilir.

Satın alma işlemi başarılı olursa operatör web sitesi, notifyPurchaseSuccessful() veya notifyPurchaseSuccessful(duration) üzerinden dilim satın alma uygulamasını bilgilendirmelidir. Burada duration, dilimin amaçlanan süresini belirten isteğe bağlı bir parametredir.

Satın alma işlemi başarılı olmazsa operatör web sitesi, notifyPurchaseFailed(code, reason) yöntemini kullanarak dilim satın alma uygulamasını bilgilendirmelidir. Burada code, hatanın nedenini belirten hata kodudur ve reason, hata kodu bilinmiyorsa hatanın kullanıcı tarafından okunabilir nedenidir.

Bu yanıt yöntemlerinden hiçbiri çağrılmazsa satın alma işlemi tamamlanmış olarak kabul edilmez ve satın alma isteği zaman aşımına uğrar.

Aşağıda, satın alma işleminin başarısız olması durumunda operatör web sitesinin döndürebileceği geçerli hata kodları verilmiştir:

Satın alma işlemi tamamlandığında operatör, PRIORITIZE_LATENCY dilimiyle birlikte URSP kurallarını kullanıcının cihazında güncellemelidir.