เครื่องมือจัดการ ProtectedSignals

public class ProtectedSignalsManager
extends Object

java.lang.Object
↳	android.adservices.signals.ProtectedSignalsManager

ProtectedSignalsManager มี API สำหรับแอปและ Ad-SDK เพื่อจัดการสัญญาณที่มีการป้องกัน

สรุป

วิธีการสาธารณะ
`static ProtectedSignalsManager`	`get(Context context)` วิธีการจากโรงงานสำหรับการสร้างอินสแตนซ์ของ ProtectedSignalsManager
`void`	`updateSignals(UpdateSignalsRequest updateSignalsRequest, Executor executor, OutcomeReceiver<Object, Exception> receiver)` UpdateSignals API จะเรียก JSON จาก URI ที่อธิบายถึงสัญญาณที่ควรเพิ่ม หรือนำออก

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

จากชั้นเรียน วันที่


        
          java.lang.Object

`Object`	`clone()` สร้างและแสดงผลสำเนาของออบเจ็กต์นี้
`boolean`	`equals(Object obj)` ระบุว่าออบเจ็กต์อื่นบางรายการเป็น "เท่ากับ" หรือไม่ อันนี้
`void`	`finalize()` เรียกใช้โดยผู้เก็บขยะในออบเจ็กต์เมื่อเก็บรวบรวมขยะ ทำให้ทราบว่าไม่มีการอ้างอิงไปยังออบเจ็กต์นั้นแล้ว
`final Class<?>`	`getClass()` แสดงผลคลาสรันไทม์ของ `Object` นี้
`int`	`hashCode()` แสดงผลค่ารหัสแฮชสำหรับออบเจ็กต์
`final void`	`notify()` สร้างชุดข้อความเดียวที่รออยู่ในออบเจ็กต์นี้ จอภาพ
`final void`	`notifyAll()` ปลุกชุดข้อความทั้งหมดที่รออยู่บนจอภาพของออบเจ็กต์นี้
`String`	`toString()` แสดงผลตัวแทนสตริงของออบเจ็กต์
`final void`	`wait(long timeoutMillis, int nanos)` ทำให้เทรดปัจจุบันต้องรอจนกว่าจะมีการปลุก ซึ่งโดยปกติแล้ว ด้วยการแจ้งหรือรบกวน หรือจนกว่า เวลาแบบเรียลไทม์ผ่านไปแล้ว
`final void`	`wait(long timeoutMillis)` ทำให้เทรดปัจจุบันต้องรอจนกว่าจะมีการปลุก ซึ่งโดยปกติแล้ว ด้วยการแจ้งหรือรบกวน หรือจนกว่า เวลาแบบเรียลไทม์ผ่านไปแล้ว
`final void`	`wait()` ทำให้เทรดปัจจุบันต้องรอจนกว่าจะมีการปลุก ซึ่งโดยปกติแล้ว ด้วยการแจ้งหรือรบกวน

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

รับ

เพิ่มใน Android UpsideDownCakePrivacySandbox

public static ProtectedSignalsManager get (Context context)

วิธีการจากโรงงานสำหรับการสร้างอินสแตนซ์ของ ProtectedSignalsManager

พารามิเตอร์
`context`	`Context`: `Context` ที่จะใช้ ค่านี้ต้องไม่เป็น `null`

คิกรีเทิร์น
`ProtectedSignalsManager`	อินสแตนซ์ `ProtectedSignalsManager` ค่านี้ต้องไม่เป็น `null`

สัญญาณอัปเดต

เพิ่มใน Android UpsideDownCakePrivacySandbox

public void updateSignals (UpdateSignalsRequest updateSignalsRequest, 
                Executor executor, 
                OutcomeReceiver<Object, Exception> receiver)

UpdateSignals API จะเรียก JSON จาก URI ที่อธิบายถึงสัญญาณที่ควรเพิ่ม หรือนำออก API นี้ยังอนุญาตให้ลงทะเบียนอุปกรณ์ปลายทางของโปรแกรมเปลี่ยนไฟล์ได้ด้วย ระบบใช้ปลายทางเพื่อ ดาวน์โหลดตรรกะการเข้ารหัส ซึ่งจะเปิดใช้การเข้ารหัสสัญญาณ

คีย์ระดับบนสุดของ JSON ต้องสอดคล้องกับคำสั่ง 1 ใน 5 ข้อต่อไปนี้

"put" - เพิ่มสัญญาณใหม่ โดยเขียนทับสัญญาณที่มีอยู่ด้วยคีย์เดียวกัน ค่า เพราะเป็นออบเจ็กต์ JSON ซึ่งคีย์เป็นสตริงฐาน 64 ที่สอดคล้องกับคีย์ที่ใส่ for และค่าจะเป็นสตริงฐาน 64 ที่ตรงกับค่าที่จะใส่

"ต่อท้าย" - เพิ่มสัญญาณ/สัญญาณใหม่ต่อท้ายอนุกรมเวลา โดยนำสัญญาณที่เก่าที่สุดออก เพื่อเพิ่มพื้นที่ว่างสำหรับรายการใหม่ ถ้าขนาดของชุดหนังสือเกินขนาดสูงสุดที่กำหนด ค่าสำหรับกรณีนี้คือออบเจ็กต์ JSON ซึ่งคีย์เป็นสตริงฐาน 64 ที่สอดคล้องกับ คีย์ที่จะต่อท้ายและค่าคือออบเจ็กต์ที่มี 2 ช่อง ได้แก่ "ค่า" และ "maxSignals" ที่ใช้เวลาเพียง 2 นาที "ค่า" คือรายการสตริงฐาน 64 สตริงตามค่าสัญญาณที่จะต่อท้ายเวลา ซีรีส์ "maxSignals" คือจำนวนค่าสูงสุดที่อนุญาตในอนุกรมเวลานี้ ถ้า จำนวนสัญญาณปัจจุบันที่เชื่อมโยงกับคีย์เกิน maxSignals สัญญาณที่เก่าที่สุด จะถูกลบ โปรดทราบว่าคุณสามารถเพิ่มคีย์ที่เพิ่มด้วยคำว่า "put" ได้ ไม่ใช่ว่าการเพิ่มมากกว่า จำนวนค่าสูงสุดจะทำให้การทำงานล้มเหลว

"put_if_not_present" - เพิ่มสัญญาณใหม่เฉพาะกรณีที่ไม่มีสัญญาณเดิมที่มี คีย์เดียวกัน ค่าสำหรับกรณีนี้เป็นออบเจ็กต์ JSON ซึ่งคีย์เป็นสตริงฐาน 64 ตรงกับคีย์ที่จะใส่ และค่าจะเป็นสตริงฐาน 64 ที่สอดคล้องกับ ที่ควรใส่

"นำออก" - นำสัญญาณของคีย์ออก ค่าของรายการนี้คือรายการสตริงฐาน 64 ตามคีย์ของสัญญาณที่ควรลบ

"update_encoder" - มีการทำงานในการอัปเดตปลายทาง และ URI ที่สามารถใช้ได้ เพื่อเรียกตรรกะการเข้ารหัส คีย์ย่อยสำหรับระบุการดำเนินการอัปเดตคือ "action" และ ค่าที่รองรับในปัจจุบัน ได้แก่

"ลงทะเบียน" : ลงทะเบียนอุปกรณ์ปลายทางของโปรแกรมเปลี่ยนไฟล์ หากให้ไว้เป็นครั้งแรก หรือ เขียนทับรายการที่มีอยู่ด้วยปลายทางที่ระบุใหม่ การระบุ "ปลายทาง" เป็นข้อมูลที่จำเป็นสำหรับขั้นตอน "REGISTER" การดำเนินการ

คีย์ย่อยสำหรับการระบุอุปกรณ์ปลายทางของโปรแกรมเปลี่ยนไฟล์คือ "ปลายทาง" และค่าคือ URI สำหรับปลายทาง

คีย์จะใช้งานได้ด้วยคำสั่ง 1 คำสั่งต่อ JSON เท่านั้น หากมีคำสั่ง 2 รายการที่พยายามดำเนินการ คีย์เดียวกัน วิธีนี้จะดำเนินการผ่าน IllegalArgumentException

การโทรนี้จะล้มเหลวโดยมี SecurityException หาก

ownerPackageName ไม่ได้เรียกชื่อแพ็กเกจของแอปและ/หรือ
ผู้ซื้อไม่ได้รับอนุญาตให้ใช้ API

การโทรนี้จะล้มเหลวโดยมี IllegalArgumentException หาก

JSON ที่ดึงมาจากเซิร์ฟเวอร์ไม่ถูกต้อง
URI ที่ระบุไม่ถูกต้อง

การโทรนี้ล้มเหลวโดยมี LimitExceededException ถ้าแพ็กเกจการโทรเกิน ขีดจำกัดของอัตราที่อนุญาตและถูกควบคุม

การเรียกใช้นี้จะล้มเหลวโดยมี IllegalStateException หากข้อผิดพลาดเกี่ยวกับบริการภายในคือ ที่พบ
ต้องใช้ AdServicesPermissions.ACCESS_ADSERVICES_CUSTOM_AUDIENCE

พารามิเตอร์
`updateSignalsRequest`	`UpdateSignalsRequest`: ค่านี้ต้องไม่เป็น `null`
`executor`	`Executor`: ค่านี้ต้องไม่เป็น `null` ระบบจะส่งเหตุการณ์ Callback และ Listener ผ่านรายการนี้ `Executor` มอบวิธีง่ายๆ ในการควบคุมชุดข้อความที่ ในการส่งกิจกรรมผ่านชุดข้อความหลักของ คุณสามารถใช้ `Context.getMainExecutor()` หรือระบุ `Executor` ที่ส่งไปยังชุดข้อความที่เหมาะสม
`receiver`	`OutcomeReceiver`: ค่านี้ต้องไม่เป็น `null`