안드로이드 카카오스토리 공유 하기

http://www.kakao.com/services/api/story_link

텍스트 / URL 포스팅

외부 앱, 모바일웹에서 텍스트 혹은 url 포함 텍스트를 카카오스토리로 포스팅할 수 있습니다. 본문에 url이 포함되어 있을 경우 해당 페이지의 썸네일 이미지, 제목, 설명이 자동으로 스크랩되어 포스팅 됩니다.
원하는 정보를 전달하려면 파라미터 중 urlinfo를 활용할 수 있습니다.

지원 OS : iOS, Android, 모바일웹

이미지 포스팅

외부 앱에서 카카오스토리에 이미지를 포스팅할 수 있습니다. Custom URL Scheme 형태가 아닌 OS Content Type 공유를 통해 포스팅 됩니다.

지원 OS : iOS, Android

• 아이폰
• 안드로이드폰
• 모바일웹

안드로이드

Android에서는 Intents and Intent Filters을 사용하여 스토리링크를 호출합니다. 
라이브러리와 샘플 앱의 최신 버전은 GitHub의 kakaolink-android 프로젝트 에서 확인하실 수 있습니다.

텍스트 / URL 포스팅

Custom URL Scheme

storylink://posting?post=[post]&appid=[appid]&appver=[appver]&apiver=[apiver]&appname=[appname]&urlinfo= [urlinfo]

파라미터 설명

파라미터 이름	Type	필수여부	설명	비고
post	String	O	Article 사용자 메시지 내용(UTF-8) 또는 URL * 본문에 url이 포함되어 있을 경우 해당 페이지의 썸네일 이미지, 제목, 설명이 자동으로  스크랩되어 포스팅 됩니다. 원하는 정보를 전달하려면  파라미터 중 urlinfo를 활용할 수 있습니다. * 본문에 url이 없는 경우 urlinfo를 보내도 동작하지 않습니다.	* 스토리 앱 버전 2.2.0  이후부터는 이미지가 없는경우 및 해상도에 따라서  최적화된 UI 제공  (예시 참고)
appid	String	O	App일 경우 bundle id, 모바일 사이트일 경우 domain
appver	String	O	app 또는 모바일 사이트의 버전
apiver	String	O	스토리링크 API 버전	1.0(고정값)
appname	String	O	app또는 모바일 사이트의 정확한 이름	host(출저)로 이용하니 정확히 기재
urlinfo	String	X	스크랩 기능을 동작할 경우 원하는 정보를 전달하기 위한 url 정보.

urlinfo 설명

파라미터 이름	필수여부	설명	종류
title	O	스크랩 형태에 표시되는 제목
desc	X	스크랩 형태에 표시되는 설명	* 스토리 앱 버전 2.2.0  이후부터는 이미지가 없는 경우에만 노출(예시 참고)
imageurl	X	스크랩 형태에 표시되는 대표이미지 url (JSON Object의 String Array 형식으로 지원)
type	X	스크랩 형태에 사용되는 type	video, music, book, article, profile, website 기본값은 website

스크랩이란?

본문에 url이 포함되어 있을 경우 해당 페이지의 썸네일 이미지, 제목, 설명 정보를 서버에서 자동으로 parsing 후 포스트의 정보에 삽입하는 것을 말합니다. 자동으로 스크랩하지 않고 원하는 정보를 지정하여 전달하려면, 파라미터 중 urlinfo를 활용할 수 있습니다. urlinfo의 'imageurl', 'title', 'desc'을 설정하면 아래 예시의 각 영역에 원하는 결과를 노출시킬 수 있습니다.

예시

1.스토리 앱 변경된 UI 조건 (2.2.0버전 이후)

	유형	사이즈(px)및 기준	예시
이미지조건	A 큰이미지	560x280이상   632x316이상
	B 작은이미지	122x122이상 A이하   144x144이상 A이하
노출정보	이미지 있을때	제목 2줄(*우선순위) + 주소
		제목 1줄일때 + 설명 1줄 + 주소
	이미지 없을때	제목 2줄 + 설명 3줄 + 주소

2. URL정보 활용 예시

URL정보 미적용 시 

URL정보 적용 시

1. 1imageurl : 썸네일 이미지
2. 2title : 제목
3. 3desc : 설명
4. #appname : host

안드로이드 OS 공유기능 활용

위 방법 외에도 안드로이드에서 제공하는 공유 기능을 활용하여 텍스트/url, 이미지를 포스팅할 수 있습니다.
구체적인 정의는 http://developer.android.com/reference/android/content/Intent.html#ACTION_SEND를 참조하세요.

사용예

// Image를 전송할 때 
Intent intent = new Intent(Intent.ACTION_SEND); 
intent.setType("image/png"); 
intent.putExtra(Intent.EXTRA_STREAM, Uri.parse(path)); 

// Kakao Story로 바로 보내시려면 아래 코드를 추가합니다. 
intent.setPackage("com.kakao.story");

다운로드

개발자용 카카오톡 B.I 다운로드: kakaostory_icon_guide.zip

*B.I는 스토리링크를 이용하여 카카오스토리로 포스팅하는 기능을 안내하는 버튼/페이지에 한하여 사용하셔야 하며, 
다른 페이지나 메뉴 등에서 위 이미지를 그대로 또는 일부 변형하여 사용자가 카카오 제작 앱으로 혼동하게 하시면 안됩니다.

개발자용 소스코드 다운로드: https://github.com/kakao/kakaolink-android