IsolatedService

public abstract class IsolatedService
extends Service

java.lang.Object
android.content.Context
  android.content.ContextWrapper
    android.app.Service
      android.adservices.ondevicepersonalization.IsolatedService


คลาสพื้นฐานสำหรับบริการที่เริ่มต้นโดย ODP ในการเรียกใช้ OnDevicePersonalizationManager#execute(ComponentName, PersistableBundle, java.util.concurrent.Executor, OutcomeReceiver) และทำงานในที่อิสระ กระบวนการ บริการสามารถสร้างเนื้อหาที่จะแสดงใน SurfaceViewในแอปการโทรและเขียนผลลัพธ์ถาวรในอุปกรณ์ ซึ่งสามารถใช้โดย Federated Analytics สำหรับการวิเคราะห์ทางสถิติข้ามอุปกรณ์ หรือ โดยการเรียนรู้แบบสมาพันธ์สำหรับการฝึกโมเดล แอปไคลเอ็นต์ใช้ OnDevicePersonalizationManager เพื่อโต้ตอบกับ IsolatedService

สรุป

ค่าคงที่ที่รับช่วงมา

ช่างก่อสร้างสาธารณะ

IsolatedService()

วิธีการสาธารณะ

final EventUrlProvider getEventUrlProvider(RequestToken requestToken)

แสดงผล EventUrlProvider สำหรับคำขอปัจจุบัน

final FederatedComputeScheduler getFederatedComputeScheduler(RequestToken requestToken)

แสดงผล FederatedComputeScheduler สำหรับคำขอปัจจุบัน

final MutableKeyValueStore getLocalData(RequestToken requestToken)

แสดงผลออบเจ็กต์การเข้าถึงข้อมูลสำหรับตาราง LOCAL_DATA

final LogReader getLogReader(RequestToken requestToken)

แสดง DAO สำหรับตารางคำขอและ EVENTS ที่ระบุ สิทธิ์เข้าถึงแถวที่ IsolatedService อ่านได้

final KeyValueStore getRemoteData(RequestToken requestToken)

แสดงผลออบเจ็กต์การเข้าถึงข้อมูลสำหรับตาราง REMOTE_DATA

final UserData getUserData(RequestToken requestToken)

แสดงผล UserData ที่ได้จากแพลตฟอร์มสำหรับคำขอปัจจุบัน

IBinder onBind(Intent intent)

แฮนเดิลที่เชื่อมโยงกับ IsolatedService

void onCreate()

สร้างแฟ้มสำหรับ IsolatedService

abstract IsolatedWorker onRequest(RequestToken requestToken)

แสดงผลอินสแตนซ์ของ IsolatedWorker ที่จัดการคำขอของไคลเอ็นต์

วิธีการที่รับมา

ช่างก่อสร้างสาธารณะ

IsolatedService

public IsolatedService ()

วิธีการสาธารณะ

getEventUrlProvider

public final EventUrlProvider getEventUrlProvider (RequestToken requestToken)

แสดงผล EventUrlProvider สำหรับคำขอปัจจุบัน EventUrlProvider ระบุ URL ที่สามารถฝังใน HTML เมื่อ HTML แสดงผลใน WebView แพลตฟอร์มจะสกัดกั้นคำขอที่ส่งไปยัง URL เหล่านี้และส่งคำขอ IsolatedWorker#onEvent(EventInput, Consumer)

พารามิเตอร์
requestToken RequestToken: โทเค็นทึบแสงที่ระบุคำขอปัจจุบันไปยังบริการ ค่านี้ต้องไม่เป็น null

คิกรีเทิร์น
EventUrlProvider EventUrlProvider ที่แสดง URL ติดตามเหตุการณ์ ค่านี้ต้องไม่เป็น null

ดูเพิ่มเติม

getFederatedComputeScheduler

public final FederatedComputeScheduler getFederatedComputeScheduler (RequestToken requestToken)

แสดงผล FederatedComputeScheduler สำหรับคำขอปัจจุบัน คุณใช้ FederatedComputeScheduler เพื่อกำหนดเวลาและยกเลิกงานการคำนวณแบบรวมศูนย์ได้ การคำนวณแบบรวมศูนย์จะรวมถึงการเรียนรู้แบบรวมศูนย์และงานการวิเคราะห์แบบสมาพันธ์

พารามิเตอร์
requestToken RequestToken: โทเค็นทึบแสงที่ระบุคำขอปัจจุบันไปยังบริการ ค่านี้ต้องไม่เป็น null

คิกรีเทิร์น
FederatedComputeScheduler FederatedComputeScheduler ที่ส่งคืนงานการคำนวณแบบรวมศูนย์ เครื่องจัดตารางเวลา ค่านี้ต้องไม่เป็น null

ดูเพิ่มเติม

GetLocalData

public final MutableKeyValueStore getLocalData (RequestToken requestToken)

แสดงผลออบเจ็กต์การเข้าถึงข้อมูลสำหรับตาราง LOCAL_DATA ตาราง LOCAL_DATA เป็นแบบถาวร แหล่งเก็บคีย์-ค่าที่บริการสามารถใช้เก็บข้อมูลใดๆ ได้ เนื้อหาของตารางนี้คือ มองเห็นได้เฉพาะบริการที่ทำงานในกระบวนการที่แยกต่างหาก และไม่สามารถส่งภายนอก อุปกรณ์

พารามิเตอร์
requestToken RequestToken: โทเค็นทึบแสงที่ระบุคำขอปัจจุบันไปยังบริการ ค่านี้ต้องไม่เป็น null

คิกรีเทิร์น
MutableKeyValueStore ออบเจ็กต์ MutableKeyValueStore ที่ให้สิทธิ์เข้าถึงตาราง LOCAL_DATA เมธอดใน MutableKeyValueStore ที่แสดงผลกำลังบล็อกการดำเนินการและ ควรถูกเรียกจากเธรดผู้ปฏิบัติงาน ไม่ใช่เทรดหลักหรือเธรดตัวยึด ค่านี้ต้องไม่เป็น null

ดูเพิ่มเติม

getLogReader

public final LogReader getLogReader (RequestToken requestToken)

แสดง DAO สำหรับตารางคำขอและ EVENTS ที่ระบุ สิทธิ์เข้าถึงแถวที่ IsolatedService อ่านได้

พารามิเตอร์
requestToken RequestToken: โทเค็นทึบแสงที่ระบุคำขอปัจจุบันไปยังบริการ ค่านี้ต้องไม่เป็น null

คิกรีเทิร์น
LogReader ออบเจ็กต์ LogReader ที่ให้สิทธิ์เข้าถึงตารางคำขอและเหตุการณ์ เมธอดใน LogReader ที่แสดงผลกำลังบล็อกการดำเนินการและ ควรถูกเรียกจากเธรดผู้ปฏิบัติงาน ไม่ใช่เทรดหลักหรือเธรดตัวยึด ค่านี้ต้องไม่เป็น null

ดูเพิ่มเติม

รับข้อมูลระยะไกล

public final KeyValueStore getRemoteData (RequestToken requestToken)

แสดงผลออบเจ็กต์การเข้าถึงข้อมูลสำหรับตาราง REMOTE_DATA ตาราง REMOTE_DATA เป็นแบบอ่านอย่างเดียว แหล่งเก็บคีย์-ค่าที่มีข้อมูลซึ่งดาวน์โหลดเป็นระยะๆ จากปลายทางที่ประกาศ ในแท็ก ในไฟล์ Manifest ODP ของบริการ ดังที่ปรากฏในตัวอย่างต่อไปนี้

<!-- Contents of res/xml/OdpSettings.xml -->
 <on-device-personalization>
 <!-- Name of the service subclass -->
 <service "com.example.odpsample.SampleService">
   <!-- If this tag is present, ODP will periodically poll this URL and
    download content to populate REMOTE_DATA. Adopters that do not need to
    download content from their servers can skip this tag. -->
   <download-settings url="https://example.com/get" />
 </service>
 </on-device-personalization>
 

พารามิเตอร์
requestToken RequestToken: โทเค็นทึบแสงที่ระบุคำขอปัจจุบันไปยังบริการ ค่านี้ต้องไม่เป็น null

คิกรีเทิร์น
KeyValueStore ออบเจ็กต์ KeyValueStore ที่ให้สิทธิ์เข้าถึงตาราง REMOTE_DATA ใน KeyValueStore ที่แสดงผลกำลังบล็อกการดำเนินการและ ถูกเรียกจากเทรดของผู้ปฏิบัติงาน ไม่ใช่เทรดหลักหรือเทรด Binder ค่านี้ต้องไม่เป็น null

ดูเพิ่มเติม

รับข้อมูลผู้ใช้

public final UserData getUserData (RequestToken requestToken)

แสดงผล UserData ที่ได้จากแพลตฟอร์มสำหรับคำขอปัจจุบัน

พารามิเตอร์
requestToken RequestToken: โทเค็นทึบแสงที่ระบุคำขอปัจจุบันไปยังบริการ ค่านี้ต้องไม่เป็น null

คิกรีเทิร์น
UserData ออบเจ็กต์ UserData ค่านี้อาจเป็น null

ดูเพิ่มเติม

onBind

public IBinder onBind (Intent intent)

แฮนเดิลที่เชื่อมโยงกับ IsolatedService

พารามิเตอร์
intent Intent: Intent ที่ใช้เพื่อเชื่อมโยงกับบริการนี้ ตามที่มอบให้แก่ Context.bindService โปรดทราบว่าส่วนเพิ่มเติมใดๆ ที่ ซึ่งรวมอยู่กับ Intent ณ จุดนั้น จะไม่เห็นที่นี่ ค่านี้ต้องไม่เป็น null

คิกรีเทิร์น
IBinder ค่านี้อาจเป็น null

เมื่อสร้าง

public void onCreate ()

สร้างแฟ้มสำหรับ IsolatedService

ตามคำขอ

public abstract IsolatedWorker onRequest (RequestToken requestToken)

แสดงผลอินสแตนซ์ของ IsolatedWorker ที่จัดการคำขอของไคลเอ็นต์

พารามิเตอร์
requestToken RequestToken: โทเค็นทึบแสงที่ระบุคำขอปัจจุบันไปยังบริการที่ ต้องส่งผ่านไปยังเมธอดบริการที่ขึ้นอยู่กับสถานะตามคำขอ ค่านี้ต้องไม่เป็น null

คิกรีเทิร์น
IsolatedWorker ค่านี้ต้องไม่เป็น null