Use Cases

Quick-start guides showing minimal implementations of common AddressBook tasks using PlayMaker custom actions.

Available Use Cases

1. Check Permission and Read Contacts

• What it does: Verify contact access permission and read all contacts

• Complexity: Basic

• Actions: 3 (GetContactsAccessStatus, ReadContacts, GetReadContactsSuccessResult)

• Best for: First-time setup, permission flow testing

---

2. Display Contact List

• What it does: Read contacts and display all names in a UI list

• Complexity: Basic with iteration

• Actions: 3 (ReadContacts, GetReadContactsSuccessResult, GetContactInfo in loop)

• Best for: Simple contact pickers, small contact lists (<50 contacts)

---

3. Paginated Contact Loading

• What it does: Load large contact lists efficiently in pages (e.g., 20 at a time)

• Complexity: Intermediate

• Actions: 3 (ReadContacts with pagination, GetReadContactsSuccessResult, GetContactInfo in loop)

• Best for: Large contact lists (50+ contacts), performance-sensitive apps

---

4. Show Contact with Photo

• What it does: Display contact details including profile photo

• Complexity: Intermediate

• Actions: 4 (ReadContacts, GetReadContactsSuccessResult, GetContactInfo, LoadContactImage)

• Best for: Contact detail views, rich contact UI

---

Choosing the Right Use Case

Start Here:

• New to AddressBook? → Use Case 1

• Building a simple contact picker? → Use Case 2

• Handling many contacts (50+)? → Use Case 3

• Need to show contact photos? → Use Case 4

Quick Action Reference

Action	Purpose	Used In
AddressBookGetContactsAccessStatus	Check permission	Use Case 1
AddressBookReadContacts	Fetch contacts	All use cases
AddressBookGetReadContactsSuccessResult	Get count/metadata	All use cases
AddressBookGetReadContactsError	Get error details	Error handling
AddressBookGetContactInfo	Extract contact data	Use Cases 2, 3, 4
AddressBookLoadContactImage	Load profile photo	Use Case 4

Related Documentation

• README.md - Actions + quick flow