플러스친구

플러스친구 SDK는 손쉽게 유저들이 플러스친구를 추가하거나 1대1 채팅을 할 수 있도록 해줍니다. 앱에서 SDK를 호출하게 되면 플러스친구 브릿지 페이지를 통하여 카카오톡을 실행하게 됩니다.

현재 제공되는 기능은 다음과 같습니다.

시작하기 전에

플러스친구 SDK를 사용하기 위해서는 다음과 같은 설정을 해주어야 합니다.

1. 앱 생성 가이드를 참고하여 앱 설정에 빠진 부분이 없는 지 확인합니다.

앱 등록 과정을 통해 보다 정확한 통계를 제공받을 수 있게 됩니다.

AndroidManifest.xmlcom.kakao.sdk.AppKey 이름으로 앱키를 등록합니다. [strings.xml]

<resources>
    <string name="kakao_app_key">AAAAAAAAAAAAAAAAAAAAAA</string>
</resources>

[AndroidManifest.xml]

<uses-permission android:name="android.permission.INTERNET" />

<application>
  ...
  <meta-data
    android:name="com.kakao.sdk.AppKey"
    android:value="@string/kakao_app_key" />
    ...
    <activity
        android:name=".SampleLoginActivity">
        <intent-filter>
            <action android:name="android.intent.action.MAIN" />
            <category android:name="android.intent.category.LAUNCHER" />
        </intent-filter>
    </activity>
    ...
</application>

2. 플러스친구 SDK를 사용하기 위해서는 키해시를 등록하여야 하므로, 앱 생성 에 나와 있는대로 키해시 등록 절차를 거치셔야 합니다.

파라미터 구성

플러스친구 SDK는 아래와 같은 파라미터들을 사용합니다.

Name Type Description
context Context 컨텍스트
plusFriendId String 플러스친구 홈 URL에 명시된 id

플러스친구 추가하기

플러스친구 추가 기능은 아래와 같이 동작합니다.

  • 브라우저로 플러스친구 브릿지 페이지 실행
  • 웹페이지에서 플러스친구 추가 카카오톡 커스텀 스킴 실행
try {
    PlusFriendService.getInstance().addFriend(PlusFriendActivity.this, "_xcLqmC");
} catch (KakaoException e) {
    // 에러 처리 (앱키 미설정 등등)
    Toast.makeText(getApplicationContext(), e.getMessage(), Toast.LENGTH_LONG).show();
}

플러스친구 1:1 채팅

플러스친구 1:1채팅 기능은 아래와 같이 동작합니다.

  • 브라우저로 플러스친구 브릿지 페이지 실행
  • 웹페이지에서 1:1 채팅 카카오톡 커스텀 스킴 실행
try {
    PlusFriendService.getInstance().chat(PlusFriendActivity.this, "_xcLqmC");
} catch (KakaoException e) {
    // 에러 처리 (앱키 미설정 등등)
    Toast.makeText(getApplicationContext(), e.getMessage(), Toast.LENGTH_LONG).show();
}

Url 직접 얻기

만약 브릿지 페이지를 호출하는 url만 얻고 싶다면 아래와 같이 사용할 수 있습니다. 이 때 얻을 수 있는 url은 카카오톡의 커스텀 스킴이 아닌 브릿지 페이지의 url입니다.

try {
    String addFriendUrl = PlusFriendService.getInstance().addFriendUrl(PlusFriendActivity.this, "_xcLqmC");
    String chatUrl = PlusFriendService.getInstance().chatUrl(PlusFriendActivity.this, "_xcLqmC");
    ...

} catch (KakaoException e) {
    // 에러 처리 (앱키 미설정 등등)
    Toast.makeText(getApplicationContext(), e.getMessage(), Toast.LENGTH_LONG).show();
}

Last Modified : 2018-07-12