ContactKeyClient

public interface ContactKeyClient extends HasApiKey

ไคลเอ็นต์สำหรับ Contact Key API

สรุป

เมธอดสาธารณะ
abstract @NonNull Flow<@NonNull List<@NonNull E2eeAccountContactKeyParcelable>>
@RequiresPermission(value = "android.permission.READ_CONTACTS")
getAccountContactKeysFlow(@NonNull List<@NonNull String> accountIds)

แสดงผลการอัปเดตคีย์รายชื่อติดต่อของบัญชี
abstract @NonNull Task<@NonNull E2eeContactKeyListParcelable>
@RequiresPermission(value = "android.permission.READ_CONTACTS")
getAllE2eeContactKeys(@NonNull String lookupKey)

เรียกข้อมูลรายการคีย์ผู้ติดต่อสำหรับการเข้ารหัสจากต้นทางถึงปลายทางทั้งหมดที่เป็นของแอปที่ผู้โทรเห็น
abstract @NonNull Task<@NonNull E2eeSelfKeyListParcelable>
@RequiresPermission(value = "android.permission.READ_CONTACTS")
getAllE2eeSelfKeys()

แสดงผลรายการคีย์ด้วยตนเองสำหรับการเข้ารหัสจากต้นทางถึงปลายทางทั้งหมดที่เป็นของแอปที่ผู้โทรเห็น
abstract @NonNull Task<@NonNull ImmutableList<@NonNull E2eeAccountContactKeyParcelable>>
@RequiresPermission(value = "android.permission.READ_CONTACTS")
getAllOwnerE2eeAccountContactKeys()

เรียกคีย์รายชื่อติดต่อของบัญชีการเข้ารหัสจากต้นทางถึงปลายทางทั้งหมดที่เป็นของแอปผู้โทร ไม่ว่าจะเชื่อมโยงกับรายชื่อติดต่อหรือไม่ก็ตาม
abstract @NonNull Task<@NonNull E2eeContactKeyListParcelable>
@RequiresPermission(value = "android.permission.READ_CONTACTS")
getAllOwnerE2eeContactKeys()

เรียกคีย์ติดต่อสำหรับการเข้ารหัสจากต้นทางถึงปลายทางทั้งหมดที่เป็นของแอปที่โทรในรายชื่อติดต่อทั้งหมด
abstract @NonNull Task<@NonNull ImmutableList<@NonNull E2eeAccountContactKeyParcelable>>
@RequiresPermission(value = "android.permission.READ_CONTACTS")
getE2eeAccountKeysForAccount(@NonNull String accountId)

เรียกข้อมูลรายการคีย์รายชื่อติดต่อสำหรับการเข้ารหัสจากต้นทางถึงปลายทางทั้งหมดที่เป็นของแอปที่โทรและบัญชีของผู้โทรในรายชื่อติดต่อทั้งหมด
abstract @NonNull Task<E2eeContactKeyParcelable>
@RequiresPermission(value = "android.permission.READ_CONTACTS")
getE2eeContactKey(
    @NonNull String lookupKey,
    @NonNull String deviceId,
    @NonNull String accountId
)

เรียกข้อมูลรายการคีย์รายชื่อติดต่อสำหรับการเข้ารหัสจากต้นทางถึงปลายทางโดยระบุ lookupKey, deviceId, accountId และชื่อแพ็กเกจของผู้โทรที่อนุมาน
abstract @NonNull Task<E2eeSelfKeyParcelable>
@RequiresPermission(value = "android.permission.READ_CONTACTS")
getE2eeSelfKey(@NonNull String deviceId, @NonNull String accountId)

แสดงรายการคีย์การเข้ารหัสจากต้นทางถึงปลายทางของตัวเองเมื่อระบุ deviceId, accountId และชื่อแพ็กเกจที่อนุมานของผู้โทร
abstract @NonNull Task<@NonNull Integer>

แสดงผลขนาดสูงสุดที่อนุญาตของคีย์เป็นไบต์
abstract @NonNull Task<@NonNull PendingIntent>
getOnboardingIntent(
    @NonNull OnboardingNextActivity nextActivity,
    String lookupKey,
    String packageName
)

แสดงผล Intent เพื่อแสดงกิจกรรมการเริ่มต้นใช้งาน และทำเครื่องหมายว่าการเริ่มต้นใช้งานแสดงในอุปกรณ์นี้แล้ว
abstract @NonNull Task<@NonNull E2eeContactKeyListParcelable>
@RequiresPermission(value = "android.permission.READ_CONTACTS")
getOwnerE2eeContactKeys(@NonNull String lookupKey)

ดึงข้อมูลรายการคีย์ผู้ติดต่อที่เข้ารหัสจากต้นทางถึงปลายทางทั้งหมดสำหรับ lookupKey ที่กำหนดซึ่งเป็นของแอปผู้โทร
abstract @NonNull Task<@NonNull E2eeSelfKeyListParcelable>
@RequiresPermission(value = "android.permission.READ_CONTACTS")
getOwnerE2eeSelfKeys()

แสดงผลรายการคีย์ด้วยตนเองสำหรับการเข้ารหัสจากต้นทางถึงปลายทางทั้งหมดที่เป็นของแอปที่โทร
abstract @NonNull Task<@NonNull PendingIntent>
getScanQrCodeIntent(@NonNull String lookupKey, boolean skipOnboarding)

แสดงผล Intent ไปยังกิจกรรม "สแกนคิวอาร์โค้ด"
abstract @NonNull Task<@NonNull PendingIntent>
getScanQrCodeIntentForAccount(
    @NonNull String packageName,
    @NonNull String accountId
)

แสดงผลความตั้งใจไปยังกิจกรรม "สแกนคิวอาร์โค้ด" สำหรับบัญชีที่เฉพาะเจาะจง
abstract @NonNull Task<@NonNull PendingIntent>
getShowQrCodeIntent(String packageName, boolean skipOnboarding)

แสดงผล Intent ไปยังกิจกรรม "แสดงคิวอาร์โค้ด"
abstract @NonNull Task<@NonNull Boolean>

แสดงผล Task ที่เสร็จสมบูรณ์ไม่ว่าจะใช้ API ได้หรือไม่ก็ตาม
abstract @NonNull Task<@NonNull Void>
@RequiresPermission(value = "android.permission.READ_CONTACTS")
registerAccountContactKeysListener(
    @NonNull List<@NonNull String> accountIds,
    @NonNull OnAccountContactKeysUpdatedListener listener
)

ลงทะเบียน Listener สำหรับการอัปเดตคีย์ผู้ติดต่อของบัญชี
abstract @NonNull Task<@NonNull Void>
@RequiresPermission(value = "android.permission.WRITE_CONTACTS")
removeE2eeAccountContactKey(
    @NonNull String deviceId,
    @NonNull String accountId
)

นำรายการคีย์ติดต่อบัญชีการเข้ารหัสจากต้นทางถึงปลายทางที่เป็นของแอปผู้โทรออก
abstract @NonNull Task<@NonNull Void>
@RequiresPermission(value = "android.permission.WRITE_CONTACTS")
removeE2eeContactKey(
    @NonNull String lookupKey,
    @NonNull String deviceId,
    @NonNull String accountId
)

นำรายการคีย์ของผู้ติดต่อที่ใช้การเข้ารหัสจากต้นทางถึงปลายทางซึ่งเป็นของแอปของผู้โทรออก
abstract @NonNull Task<@NonNull Void>
@RequiresPermission(value = "android.permission.WRITE_CONTACTS")
removeE2eeSelfKey(@NonNull String deviceId, @NonNull String accountId)

นำรายการคีย์ด้วยตนเองสำหรับการเข้ารหัสจากต้นทางถึงปลายทางออกโดยพิจารณาจาก deviceId และชื่อแพ็กเกจที่อนุมานของผู้โทร
abstract @NonNull Task<@NonNull Boolean>

ยกเลิกการลงทะเบียน Listener สำหรับการอัปเดตคีย์ติดต่อของบัญชี
abstract @NonNull Task<@NonNull Void>
@RequiresPermission(allOf = ["android.permission.READ_CONTACTS", "android.permission.WRITE_CONTACTS"])
updateAllE2eeAccountKeys(
    @NonNull List<@NonNull E2eeAccountKeyInfo> accountKeyInfos
)

แทรกคีย์ติดต่อบัญชีเป็นกลุ่ม
abstract @NonNull Task<@NonNull Void>
@RequiresPermission(allOf = ["android.permission.READ_CONTACTS", "android.permission.WRITE_CONTACTS"])
updateOrInsertE2eeContactKey(
    @NonNull String lookupKey,
    @NonNull String deviceId,
    @NonNull String accountId,
    @NonNull byte[] keyValue
)

แทรกรายการใหม่ลงในตารางคีย์ติดต่อสำหรับการเข้ารหัสจากต้นทางถึงปลายทาง หรืออัปเดตรายการที่มีอยู่
abstract @NonNull Task<@NonNull Void>
@RequiresPermission(allOf = ["android.permission.READ_CONTACTS", "android.permission.WRITE_CONTACTS"])
updateOrInsertE2eeContactKey(
    @NonNull List<@NonNull String> lookupKeys,
    @NonNull String deviceId,
    @NonNull String accountId,
    @NonNull byte[] keyValue
)

แทรกรายการใหม่ลงในตารางคีย์ติดต่อสำหรับการเข้ารหัสจากต้นทางถึงปลายทาง หรืออัปเดตรายการที่มีอยู่
abstract @NonNull Task<@NonNull Void>
@RequiresPermission(value = "android.permission.WRITE_CONTACTS")
updateOrInsertE2eeSelfKey(
    @NonNull String deviceId,
    @NonNull String accountId,
    @NonNull byte[] keyValue
)

แทรกรายการใหม่ลงในตารางคีย์ที่เข้ารหัสจากต้นทางถึงปลายทางด้วยตนเอง หรืออัปเดตรายการที่มีอยู่แล้ว

เมธอดสาธารณะ

getAccountContactKeysFlow

@RequiresPermission(value = "android.permission.READ_CONTACTS")
abstract @NonNull Flow<@NonNull List<@NonNull E2eeAccountContactKeyParcelable>> getAccountContactKeysFlow(@NonNull List<@NonNull String> accountIds)

แสดงผลการอัปเดตคีย์รายชื่อติดต่อของบัญชี

โฟลว์จะส่งเมื่อมีการอัปเดต เพิ่ม หรือนำคีย์สำหรับ accountId ที่ระบุออก โดยจะแสดงรายการคีย์ทั้งหมดสำหรับ accountIds ที่ระบุ ไม่ใช่เฉพาะคีย์ที่อัปเดต

พารามิเตอร์
@NonNull List<@NonNull String> accountIds

รายการรหัสบัญชีที่จะฟังการอัปเดต
คิกรีเทิร์น
@NonNull Flow<@NonNull List<@NonNull E2eeAccountContactKeyParcelable>>

โฟลว์ที่ปล่อยรายการ E2eeAccountContactKeyParcelable สำหรับ accountIds ที่ระบุทุกครั้งที่มีการอัปเดต เพิ่ม หรือนำคีย์ออก
ส่ง
com.google.android.libraries.sdkcoroutines.flow.CallbackChannelFullException

หากการประมวลผลเหตุการณ์การเรียกกลับช้าเกินไป

getAllE2eeContactKeys

@RequiresPermission(value = "android.permission.READ_CONTACTS")
abstract @NonNull Task<@NonNull E2eeContactKeyListParcelable> getAllE2eeContactKeys(@NonNull String lookupKey)

เรียกข้อมูลรายการคีย์ผู้ติดต่อสำหรับการเข้ารหัสจากต้นทางถึงปลายทางทั้งหมดที่เป็นของแอปที่ผู้โทรเห็น ระบบจะนำข้อมูล deviceId, timeUpdated และ keyValue ออกจากคีย์

พารามิเตอร์
@NonNull String lookupKey

ค่าที่อ้างอิงถึงรายชื่อติดต่อ
คิกรีเทิร์น
@NonNull Task<@NonNull E2eeContactKeyListParcelable>

E2eeContactKeyListParcelable ที่มีรายการข้อมูลคีย์รายชื่อติดต่อสำหรับการเข้ารหัสจากต้นทางถึงปลายทาง หรือรายการที่ว่างเปล่าหากไม่พบคีย์

getAllE2eeSelfKeys

@RequiresPermission(value = "android.permission.READ_CONTACTS")
abstract @NonNull Task<@NonNull E2eeSelfKeyListParcelable> getAllE2eeSelfKeys()

แสดงผลรายการคีย์ด้วยตนเองสำหรับการเข้ารหัสจากต้นทางถึงปลายทางทั้งหมดที่เป็นของแอปที่ผู้โทรเห็น ระบบจะนำข้อมูล deviceId, timeUpdated และ keyValue ออกจากคีย์

คิกรีเทิร์น
@NonNull Task<@NonNull E2eeSelfKeyListParcelable>

E2eeSelfKeyListParcelable ที่มีรายการข้อมูลคีย์ของตัวเองสำหรับการเข้ารหัสจากต้นทางถึงปลายทาง หรือรายการที่ว่างเปล่าหากไม่พบคีย์ของตัวเอง

getAllOwnerE2eeAccountContactKeys

@RequiresPermission(value = "android.permission.READ_CONTACTS")
abstract @NonNull Task<@NonNull ImmutableList<@NonNull E2eeAccountContactKeyParcelable>> getAllOwnerE2eeAccountContactKeys()

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

คิกรีเทิร์น
@NonNull Task<@NonNull ImmutableList<@NonNull E2eeAccountContactKeyParcelable>>

รายการออบเจ็กต์ E2eeAccountContactKeyParcelable ที่มีข้อมูลคีย์ติดต่อสำหรับการเข้ารหัสจากต้นทางถึงปลายทาง หรือรายการที่ว่างเปล่าหากไม่พบคีย์

getAllOwnerE2eeContactKeys

@RequiresPermission(value = "android.permission.READ_CONTACTS")
abstract @NonNull Task<@NonNull E2eeContactKeyListParcelable> getAllOwnerE2eeContactKeys()

เรียกคีย์ติดต่อสำหรับการเข้ารหัสจากต้นทางถึงปลายทางทั้งหมดที่เป็นของแอปที่โทรในรายชื่อติดต่อทั้งหมด

ควรใช้วิธีนี้เพื่อดึงข้อมูลคีย์ที่มีรายชื่อติดต่ออย่างน้อย 1 รายที่เชื่อมโยงกับคีย์นั้นๆ เท่านั้น หากต้องการเรียกคีย์ที่ไม่ได้เชื่อมโยงกับรายชื่อติดต่อใดๆ ให้ใช้ getAllOwnerE2eeAccountContactKeys แทน

คิกรีเทิร์น
@NonNull Task<@NonNull E2eeContactKeyListParcelable>

E2eeContactKeyListParcelable ที่มีรายการข้อมูลคีย์รายชื่อติดต่อสำหรับการเข้ารหัสจากต้นทางถึงปลายทาง หรือรายการที่ว่างเปล่าหากไม่พบคีย์

getE2eeAccountKeysForAccount

@RequiresPermission(value = "android.permission.READ_CONTACTS")
abstract @NonNull Task<@NonNull ImmutableList<@NonNull E2eeAccountContactKeyParcelable>> getE2eeAccountKeysForAccount(@NonNull String accountId)

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

คิกรีเทิร์น
@NonNull Task<@NonNull ImmutableList<@NonNull E2eeAccountContactKeyParcelable>>

รายการออบเจ็กต์ E2eeAccountContactKeyParcelable ที่มีข้อมูลคีย์ติดต่อสำหรับการเข้ารหัสจากต้นทางถึงปลายทาง หรือรายการที่ว่างเปล่าหากไม่พบคีย์

getE2eeContactKey

@RequiresPermission(value = "android.permission.READ_CONTACTS")
abstract @NonNull Task<E2eeContactKeyParcelable> getE2eeContactKey(
    @NonNull String lookupKey,
    @NonNull String deviceId,
    @NonNull String accountId
)

เรียกข้อมูลรายการคีย์รายชื่อติดต่อสำหรับการเข้ารหัสจากต้นทางถึงปลายทางโดยระบุ lookupKey, deviceId, accountId และชื่อแพ็กเกจของผู้โทรที่อนุมาน

พารามิเตอร์
@NonNull String lookupKey

ค่าที่อ้างอิงถึงรายชื่อติดต่อ
@NonNull String deviceId

ตัวระบุที่แอปกำหนดสำหรับอุปกรณ์
@NonNull String accountId

ตัวระบุที่แอประบุสำหรับบัญชี
คิกรีเทิร์น
@NonNull Task<E2eeContactKeyParcelable>

E2eeContactKeyParcelable ที่มีข้อมูลคีย์ติดต่อ หรือ null หากไม่พบคีย์ติดต่อ

getE2eeSelfKey

@RequiresPermission(value = "android.permission.READ_CONTACTS")
abstract @NonNull Task<E2eeSelfKeyParcelable> getE2eeSelfKey(@NonNull String deviceId, @NonNull String accountId)

แสดงรายการคีย์การเข้ารหัสจากต้นทางถึงปลายทางของตัวเองเมื่อระบุ deviceId, accountId และชื่อแพ็กเกจที่อนุมานของผู้โทร

พารามิเตอร์
@NonNull String deviceId

ตัวระบุที่แอปกำหนดสำหรับอุปกรณ์
@NonNull String accountId

ตัวระบุที่แอประบุสำหรับบัญชี
คิกรีเทิร์น
@NonNull Task<E2eeSelfKeyParcelable>

E2eeSelfKeyParcelable ที่มีข้อมูลคีย์ของตัวเองสำหรับการเข้ารหัสแบบจุดต่อจุด หรือ null หากไม่พบคีย์ของตัวเอง

getMaxKeySizeBytes

abstract @NonNull Task<@NonNull Integer> getMaxKeySizeBytes()

แสดงผลขนาดสูงสุดที่อนุญาตของคีย์เป็นไบต์

getOnboardingIntent

abstract @NonNull Task<@NonNull PendingIntent> getOnboardingIntent(
    @NonNull OnboardingNextActivity nextActivity,
    String lookupKey,
    String packageName
)

แสดงผล Intent เพื่อแสดงกิจกรรมการเริ่มต้นใช้งาน และทำเครื่องหมายว่าการเริ่มต้นใช้งานแสดงในอุปกรณ์นี้แล้ว ซึ่งต้องใช้ nextActivity ซึ่งอาจเป็นสตริง show หรือ scan หากเป็น scan คุณต้องระบุ lookupKey ของรายชื่อติดต่อที่จะสแกน

พารามิเตอร์
@NonNull OnboardingNextActivity nextActivity

กิจกรรมถัดไปที่จะแสดงหลังจากกิจกรรมการเริ่มต้นใช้งาน ต้องเป็น show หรือ scan
String lookupKey

ค่าที่อ้างอิงถึงรายชื่อติดต่อ ต้องระบุหาก nextActivity เป็น scan
String packageName

ชื่อแพ็กเกจที่เชื่อมโยงกับแอปที่ต้องใช้คีย์ (ไม่บังคับ)

getOwnerE2eeContactKeys

@RequiresPermission(value = "android.permission.READ_CONTACTS")
abstract @NonNull Task<@NonNull E2eeContactKeyListParcelable> getOwnerE2eeContactKeys(@NonNull String lookupKey)

ดึงข้อมูลรายการคีย์ผู้ติดต่อที่เข้ารหัสจากต้นทางถึงปลายทางทั้งหมดสำหรับ lookupKey ที่กำหนดซึ่งเป็นของแอปผู้โทร

พารามิเตอร์
@NonNull String lookupKey

ค่าที่อ้างอิงถึงรายชื่อติดต่อ
คิกรีเทิร์น
@NonNull Task<@NonNull E2eeContactKeyListParcelable>

E2eeContactKeyListParcelable ที่มีรายการข้อมูลคีย์รายชื่อติดต่อสำหรับการเข้ารหัสจากต้นทางถึงปลายทาง หรือรายการที่ว่างเปล่าหากไม่พบคีย์

getOwnerE2eeSelfKeys

@RequiresPermission(value = "android.permission.READ_CONTACTS")
abstract @NonNull Task<@NonNull E2eeSelfKeyListParcelable> getOwnerE2eeSelfKeys()

แสดงผลรายการคีย์ด้วยตนเองสำหรับการเข้ารหัสจากต้นทางถึงปลายทางทั้งหมดที่เป็นของแอปที่โทร

คิกรีเทิร์น
@NonNull Task<@NonNull E2eeSelfKeyListParcelable>

E2eeSelfKeyListParcelableที่มีข้อมูลคีย์ของตัวเองสำหรับการเข้ารหัสจากต้นทางถึงปลายทาง หรือรายการที่ว่างเปล่าหากไม่พบคีย์ของตัวเอง

getScanQrCodeIntent

abstract @NonNull Task<@NonNull PendingIntent> getScanQrCodeIntent(@NonNull String lookupKey, boolean skipOnboarding)

แสดงผล Intent ไปยังกิจกรรม "สแกนคิวอาร์โค้ด"

พารามิเตอร์
@NonNull String lookupKey

ค่าที่อ้างอิงถึงรายชื่อติดต่อ
boolean skipOnboarding

ขณะนี้ยังไม่มีการใช้งาน

getScanQrCodeIntentForAccount

abstract @NonNull Task<@NonNull PendingIntent> getScanQrCodeIntentForAccount(
    @NonNull String packageName,
    @NonNull String accountId
)

แสดงผลความตั้งใจไปยังกิจกรรม "สแกนคิวอาร์โค้ด" สำหรับบัญชีที่เฉพาะเจาะจง

พารามิเตอร์
@NonNull String packageName

ชื่อแพ็กเกจที่เชื่อมโยงกับบัญชีที่ผู้ใช้ต้องการยืนยัน
@NonNull String accountId

รหัสบัญชีที่เชื่อมโยงกับบัญชีที่ผู้ใช้ต้องการยืนยัน

getShowQrCodeIntent

abstract @NonNull Task<@NonNull PendingIntent> getShowQrCodeIntent(String packageName, boolean skipOnboarding)

แสดงผล Intent ไปยังกิจกรรม "แสดงคิวอาร์โค้ด"

พารามิเตอร์
String packageName

ชื่อแพ็กเกจที่เชื่อมโยงกับแอปที่ต้องใช้คีย์ (ไม่บังคับ)
boolean skipOnboarding

ขณะนี้ยังไม่มีการใช้งาน

isEnabled

abstract @NonNull Task<@NonNull Boolean> isEnabled()

แสดงผล Task ที่เสร็จสมบูรณ์ไม่ว่าจะใช้ API ได้หรือไม่ก็ตาม

หาก API พร้อมใช้งาน งานที่ส่งคืนจะมีผลลัพธ์เป็นจริง มิเช่นนั้นจะเป็นเท็จ

ระบบจะตรวจจับข้อยกเว้นที่มักจะเกิดขึ้นเมื่อ API ไม่พร้อมใช้งาน และจะแสดงผลงานที่ส่งคืนค่าเป็นเท็จสำเร็จแทน

registerAccountContactKeysListener

@RequiresPermission(value = "android.permission.READ_CONTACTS")
abstract @NonNull Task<@NonNull Void> registerAccountContactKeysListener(
    @NonNull List<@NonNull String> accountIds,
    @NonNull OnAccountContactKeysUpdatedListener listener
)

ลงทะเบียน Listener สำหรับการอัปเดตคีย์ผู้ติดต่อของบัญชี

ระบบจะเรียกใช้ Listener เมื่อมีการอัปเดต เพิ่ม หรือนำคีย์สำหรับ accountId ที่ระบุออก โดยจะเรียกใช้พร้อมกับรายการคีย์ทั้งหมดสำหรับ accountIds ที่ระบุ ไม่ใช่เฉพาะคีย์ที่อัปเดตเท่านั้น

พารามิเตอร์
@NonNull List<@NonNull String> accountIds

รายการรหัสบัญชีที่จะลงทะเบียน Listener
@NonNull OnAccountContactKeysUpdatedListener listener

ผู้ฟังให้ลงทะเบียน

removeE2eeAccountContactKey

@RequiresPermission(value = "android.permission.WRITE_CONTACTS")
abstract @NonNull Task<@NonNull Void> removeE2eeAccountContactKey(
    @NonNull String deviceId,
    @NonNull String accountId
)

นำรายการคีย์ติดต่อบัญชีการเข้ารหัสจากต้นทางถึงปลายทางที่เป็นของแอปผู้โทรออก

พารามิเตอร์
@NonNull String deviceId

ตัวระบุที่แอปกำหนดสำหรับอุปกรณ์
@NonNull String accountId

ตัวระบุที่แอประบุสำหรับบัญชี

removeE2eeContactKey

@RequiresPermission(value = "android.permission.WRITE_CONTACTS")
abstract @NonNull Task<@NonNull Void> removeE2eeContactKey(
    @NonNull String lookupKey,
    @NonNull String deviceId,
    @NonNull String accountId
)

นำรายการคีย์ของผู้ติดต่อที่ใช้การเข้ารหัสจากต้นทางถึงปลายทางซึ่งเป็นของแอปของผู้โทรออก

พารามิเตอร์
@NonNull String lookupKey

ค่าที่อ้างอิงถึงรายชื่อติดต่อ
@NonNull String deviceId

ตัวระบุที่แอปกำหนดสำหรับอุปกรณ์
@NonNull String accountId

ตัวระบุที่แอประบุสำหรับบัญชี

removeE2eeSelfKey

@RequiresPermission(value = "android.permission.WRITE_CONTACTS")
abstract @NonNull Task<@NonNull Void> removeE2eeSelfKey(@NonNull String deviceId, @NonNull String accountId)

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

พารามิเตอร์
@NonNull String deviceId

ตัวระบุที่แอปกำหนดสำหรับอุปกรณ์
@NonNull String accountId

ตัวระบุที่แอประบุสำหรับบัญชี

unregisterAccountContactKeysListener

@CanIgnoreReturnValue
abstract @NonNull Task<@NonNull Boolean> unregisterAccountContactKeysListener(
    @NonNull OnAccountContactKeysUpdatedListener listener
)

ยกเลิกการลงทะเบียน Listener สำหรับการอัปเดตคีย์ติดต่อของบัญชี

พารามิเตอร์
@NonNull OnAccountContactKeysUpdatedListener listener

ผู้ฟังเพื่อยกเลิกการลงทะเบียน

updateAllE2eeAccountKeys

@RequiresPermission(allOf = ["android.permission.READ_CONTACTS", "android.permission.WRITE_CONTACTS"])
abstract @NonNull Task<@NonNull Void> updateAllE2eeAccountKeys(
    @NonNull List<@NonNull E2eeAccountKeyInfo> accountKeyInfos
)

แทรกคีย์ติดต่อบัญชีเป็นกลุ่ม

ทำงานคล้ายกับ updateOrInsertE2eeContactKey แต่ช่วยให้แทรก/อัปเดตคีย์หลายรายการพร้อมกันได้ ระบบจะแทรกคีย์แต่ละรายการในธุรกรรมของตัวเอง ดังนั้นคีย์บางรายการอาจได้รับการแทรกแม้ว่างานจะส่งข้อยกเว้นก็ตาม

ไคลเอ็นต์อาจเลือกจัดการความล้มเหลวชั่วคราวโดยการส่งทั้งกลุ่มอีกครั้ง เนื่องจาก API นี้จะไม่ส่งผลต่อสถานะของคีย์ที่แทรกไปแล้ว

สำหรับแต่ละคีย์ หากมีการระบุ lookupKey แต่ไม่มีข้อมูลพื้นฐานของรายชื่อติดต่อ (displayName, phoneNumber, emailAddress) API นี้จะพยายามดึงชื่อ หมายเลขโทรศัพท์ และอีเมลของรายชื่อติดต่อจากผู้ให้บริการรายชื่อติดต่อด้วย เมื่อเรียกคีย์ แอปการจัดการรายชื่อติดต่อควรใช้ข้อมูลนี้เพื่อให้แน่ใจว่าคีย์จะใช้สำหรับรายชื่อติดต่อที่ตั้งใจไว้เท่านั้น

แอปการยืนยันคีย์ของ Android จะจัดเก็บข้อมูลนี้ไว้ในอุปกรณ์และจะแสดงต่อผู้เรียก API ที่มีREAD_CONTACTSสิทธิ์เท่านั้น

หากไม่ได้ระบุ lookupKey สำหรับคีย์ API นี้จะจัดเก็บคีย์ที่ไม่ได้เชื่อมโยงกับผู้ติดต่อใดๆ

พารามิเตอร์
@NonNull List<@NonNull E2eeAccountKeyInfo> accountKeyInfos

รายการออบเจ็กต์ E2eeAccountKeyInfo ที่มีข้อมูลคีย์ติดต่อสำหรับการเข้ารหัสจากต้นทางถึงปลายทาง

updateOrInsertE2eeContactKey

@RequiresPermission(allOf = ["android.permission.READ_CONTACTS", "android.permission.WRITE_CONTACTS"])
abstract @NonNull Task<@NonNull Void> updateOrInsertE2eeContactKey(
    @NonNull String lookupKey,
    @NonNull String deviceId,
    @NonNull String accountId,
    @NonNull byte[] keyValue
)

แทรกรายการใหม่ลงในตารางคีย์ติดต่อสำหรับการเข้ารหัสจากต้นทางถึงปลายทาง หรืออัปเดตรายการที่มีอยู่ คีย์ผู้ติดต่อสำหรับการเข้ารหัสจากต้นทางถึงปลายทางที่แทรก/อัปเดตเป็นของแอปที่โทร

นอกจากนี้ API นี้จะจัดเก็บชื่อ หมายเลขโทรศัพท์ และอีเมลของรายชื่อติดต่อจากผู้ให้บริการรายชื่อติดต่อไว้ข้างๆ คีย์ด้วย เมื่อเรียกคีย์ แอปการจัดการรายชื่อติดต่อควรใช้ข้อมูลนี้เพื่อให้แน่ใจว่าคีย์จะใช้สำหรับรายชื่อติดต่อที่ตั้งใจไว้เท่านั้น

แอปการยืนยันคีย์ของ Android จะจัดเก็บข้อมูลนี้ไว้ในอุปกรณ์และจะแสดงต่อผู้เรียก API ที่มีREAD_CONTACTSสิทธิ์เท่านั้น

พารามิเตอร์
@NonNull String lookupKey

ค่าที่อ้างอิงถึงรายชื่อติดต่อ
@NonNull String deviceId

ตัวระบุที่แอปกำหนดสำหรับอุปกรณ์
@NonNull String accountId

ตัวระบุที่แอประบุสำหรับบัญชี
@NonNull byte[] keyValue

ไบต์ดิบสำหรับคีย์ (ขนาดสูงสุดคือ getMaxKeySizeBytes ไบต์)

updateOrInsertE2eeContactKey

@RequiresPermission(allOf = ["android.permission.READ_CONTACTS", "android.permission.WRITE_CONTACTS"])
abstract @NonNull Task<@NonNull Void> updateOrInsertE2eeContactKey(
    @NonNull List<@NonNull String> lookupKeys,
    @NonNull String deviceId,
    @NonNull String accountId,
    @NonNull byte[] keyValue
)

แทรกรายการใหม่ลงในตารางคีย์ติดต่อสำหรับการเข้ารหัสจากต้นทางถึงปลายทาง หรืออัปเดตรายการที่มีอยู่ คีย์ผู้ติดต่อสำหรับการเข้ารหัสจากต้นทางถึงปลายทางที่แทรก/อัปเดตเป็นของแอปที่โทร

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

แอปการยืนยันคีย์ของ Android จะจัดเก็บข้อมูลนี้ไว้ในอุปกรณ์และจะแสดงต่อผู้เรียก API ที่มีREAD_CONTACTSสิทธิ์เท่านั้น

หากรายการคีย์การค้นหาว่างเปล่า API นี้จะจัดเก็บคีย์ที่ไม่ได้เชื่อมโยงกับรายชื่อติดต่อใดๆ

การเรียก API นี้ด้วยคีย์การค้นหาอย่างน้อย 1 รายการจะอัปเดตข้อมูลเมตาของคีย์เพื่อเชื่อมโยงกับรายชื่อติดต่อที่ระบุ แต่จะไม่นำการเชื่อมโยงที่มีอยู่สำหรับรายชื่อติดต่อที่ไม่ได้ระบุในรายการออก หากต้องการนำการเชื่อมโยงระหว่างรายชื่อติดต่อกับคีย์ออก ให้เรียกใช้ removeE2eeContactKey พร้อมคีย์การค้นหาที่เหมาะสม

พารามิเตอร์
@NonNull List<@NonNull String> lookupKeys

รายการคีย์การค้นหา CP2 ที่อาจว่างเปล่าซึ่งอ้างอิงถึงผู้ติดต่อที่คีย์เชื่อมโยงด้วย
@NonNull String deviceId

ตัวระบุที่แอปกำหนดสำหรับอุปกรณ์
@NonNull String accountId

ตัวระบุที่แอประบุสำหรับบัญชี
@NonNull byte[] keyValue

ไบต์ดิบสำหรับคีย์ (ขนาดสูงสุดคือ getMaxKeySizeBytes ไบต์)

updateOrInsertE2eeSelfKey

@RequiresPermission(value = "android.permission.WRITE_CONTACTS")
abstract @NonNull Task<@NonNull Void> updateOrInsertE2eeSelfKey(
    @NonNull String deviceId,
    @NonNull String accountId,
    @NonNull byte[] keyValue
)

แทรกรายการใหม่ลงในตารางคีย์ที่เข้ารหัสจากต้นทางถึงปลายทางด้วยตนเอง หรืออัปเดตรายการที่มีอยู่แล้ว

พารามิเตอร์
@NonNull String deviceId

ตัวระบุที่แอปกำหนดสำหรับอุปกรณ์
@NonNull String accountId

ตัวระบุที่แอประบุสำหรับบัญชี
@NonNull byte[] keyValue

ไบต์ดิบสำหรับคีย์ (ขนาดสูงสุดคือ getMaxKeySizeBytes ไบต์)