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 สามารถใช้สําหรับการวิเคราะห์ทางสถิติข้ามอุปกรณ์ หรือ Federated Learning สามารถใช้สําหรับการฝึกโมเดล แอปไคลเอ็นต์ใช้ 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 สําหรับตารางคําขอและเหตุการณ์ที่ให้สิทธิ์เข้าถึงแถวที่ IsolatedService อ่านได้

final KeyValueStore getRemoteData(RequestToken requestToken)

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

final UserData getUserData(RequestToken requestToken)

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

IBinder onBind(Intent intent)

จัดการการเชื่อมโยงกับ IsolatedService

void onCreate()

สร้าง Binder สำหรับ 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 ที่แสดงผลเป็นการดำเนินการแบบบล็อกและควรเรียกใช้จากเทรดผู้ปฏิบัติงาน ไม่ใช่เทรดหลักหรือเทรด Binder ค่านี้ต้องไม่เป็น null

ดูเพิ่มเติม

getLogReader

public final LogReader getLogReader (RequestToken requestToken)

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

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

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

ดูเพิ่มเติม

getRemoteData

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

ดูเพิ่มเติม

getUserData

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

onCreate

public void onCreate ()

สร้าง Binder สำหรับ IsolatedService

onRequest

public abstract IsolatedWorker onRequest (RequestToken requestToken)

แสดงผลอินสแตนซ์ของ IsolatedWorker ที่จัดการคําขอของลูกค้า

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

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