Picker

Kakao. Picker

친구 피커와 관련된 함수들이 포함되어 있습니다.

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
Name Type Attributes Default Description
pickerFriendFilter String <optional>
"none"

앱 기준 친구 상태 필터 (앱 미가입/앱 가입/전체), "invitable"|"registered"|"none"

pickerFriendType String <optional>
"talk"

친구 관계 유형 (카카오톡/카카오스토리/카카오톡 & 카카오스토리), "talk"|"story"|"talkstory"

pickerFriendOrder String <optional>
""

친구 목록 정렬 기준, "age"

properties RequestPickerParams <optional>

친구 피커를 실행할 때 필요한 세부 옵션

success PickerSuccessCallback <optional>

선택된 친구에 대한 정보를 받을 콜백 함수

fail PickerFailCallback <optional>

에러를 받을 콜백 함수

always PickerSuccessCallback | PickerFailCallback <optional>

성공 여부와 관계 없이 항상 호출되는 콜백 함수

returnUrl String <optional>

선택한 친구 정보를 받을 서비스 URL

(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
Name Type Attributes Default Description
pickerFriendFilter String <optional>
"none"

앱 기준 친구 상태 필터 (앱 미가입/앱 가입/전체), "invitable"|"registered"|"none"

pickerFriendType String <optional>
"talk"

친구 관계 유형 (카카오톡/카카오스토리/카카오톡 & 카카오스토리), "talk"|"story"|"talkstory"

pickerFriendOrder String <optional>
""

친구 목록 정렬 기준, "age"

properties RequestMultiPickerParams <optional>

친구 피커를 실행할 때 필요한 세부 옵션

success PickerSuccessCallback <optional>

선택된 친구에 대한 정보를 받을 콜백 함수

fail PickerFailCallback <optional>

에러를 받을 콜백 함수

always PickerSuccessCallback | PickerFailCallback <optional>

성공 여부와 관계 없이 항상 호출되는 콜백 함수

returnUrl String <optional>

선택한 친구 정보를 받을 서비스 URL

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
Name Type Description
code String
msg String

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

권한이 있는 앱에 한하여 개인 정보 마스킹 해제 여부