친구 피커와 관련된 함수들이 포함되어 있습니다.
Methods
(static) cleanup()
친구 피커를 호출하기 위해 사용한 리소스를 해제합니다.
(static) selectFriend(settings)
한 명의 친구를 선택할 때 사용합니다.
Example
Kakao.Picker.selectFriend({
pickerFriendFilter: 'none',
pickerFriendType: 'talk',
properties: {
title: '친구 선택',
enableSearch: true,
searchPlaceHolderText: '친구를 검색하세요',
countryCodes: ['kr', 'us'],
usingOsFilter: 'all',
showMyProfile: true,
showFavorite: true,
disableSelectReasons: ['msgBlocked'],
},
success: function (res) {},
fail: function (error) {},
})
Parameters:
Name | Type | Description | |||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
settings |
Object | 친구 피커와 관련된 설정을 key/value로 전달합니다. Properties
|
(static) selectFriends(settings)
여러 명의 친구를 선택할 때 사용합니다.
Example
Kakao.Picker.selectFriends({
pickerFriendFilter: 'none',
pickerFriendType: 'talk',
properties: {
title: '친구 선택',
enableSearch: true,
searchPlaceHolderText: '친구를 검색하세요',
countryCodes: ['kr', 'us'],
usingOsFilter: 'all',
showMyProfile: true,
showFavorite: true,
disableSelectReasons: ['msgBlocked'],
showPickedFriend: true,
maxPickableCount: 10,
minPickableCount: 1,
},
success: function (res) {},
fail: function (error) {},
})
Parameters:
Name | Type | Description | |||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
settings |
Object | 친구 피커와 관련된 설정을 key/value로 전달합니다. Properties
|
Type Definitions
Friend
Properties:
Name | Type | Attributes | Description |
---|---|---|---|
uuid |
String | 고유 식별자 |
|
profile_nickname |
String | 닉네임 (앱 미가입자의 경우 마스킹된 닉네임) |
|
profile_thumbnail_image |
String |
<optional> |
프로필 이미지 (앱 가입자만 제공) |
id |
String |
<optional> |
회원번호 (앱 가입자만 제공) |
favorite |
Boolean |
<optional> |
즐겨찾기 설정 여부 (앱 가입자만 제공) |
PickerFailCallback(error)
Parameters:
Name | Type | Description | |||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
error |
Object |
Properties
|
PickerSuccessCallback(response)
Parameters:
Name | Type | Description |
---|---|---|
response |
Array.<Friend> |
RequestMultiPickerParams
Properties:
Name | Type | Attributes | Default | Description |
---|---|---|---|---|
showPickedFriend |
Boolean |
<optional> |
true
|
선택된 친구 표시 여부 |
maxPickableCount |
Number |
<optional> |
30
|
최대 선택 가능 친구 수 (최대 100명) |
minPickableCount |
Number |
<optional> |
1
|
최소 선택 가능 친구 수 (최대 100명) |
Type:
RequestPickerParams
Properties:
Name | Type | Attributes | Default | Description |
---|---|---|---|---|
title |
String |
<optional> |
"카카오톡 친구 선택"
|
친구 피커 타이틀 영역에 표시될 텍스트 |
enableSearch |
Boolean |
<optional> |
true
|
검색 기능 사용 여부 |
searchPlaceHolderText |
String |
<optional> |
"이름, 닉네임 검색"
|
검색 창에 표시될 placeholder |
countryCodes |
Array.<String> |
<optional> |
[]
|
국가 코드 필터 ex) ["kr", "us", "jp", "cn"] |
usingOsFilter |
String |
<optional> |
"all"
|
모바일 환경 필터, "all"|"ios"|"android" |
showMyProfile |
Boolean |
<optional> |
true
|
내 프로필 표시 여부 |
showFavorite |
Boolean |
<optional> |
true
|
즐겨찾기 표시 여부 |
disableSelectReasons |
Array.<String> |
<optional> |
[]
|
메시지 수신거부 노출 여부 ex) ["msgBlocked"] |
displayAllProfile |
Boolean |
<optional> |
false
|
권한이 있는 앱에 한하여 개인 정보 마스킹 해제 여부 |