페이지 이동경로
  • 문서>
  • 메시지>
  • 카카오톡 공유: Flutter

메시지

카카오톡 공유: Flutter

이 문서는 Kakao SDK for Flutter(이하 Flutter SDK)를 사용한 카카오톡 공유 API 구현 방법을 안내합니다.

시작하기 전에

필요한 패키지 설정하기

카카오톡 공유 API를 사용하려면 설치하기를 참고하여 pubspec.yaml 파일에 Flutter SDK 전체 또는 카카오톡 공유 패키지에 대한 의존성을 추가해야 합니다.

카카오톡 공유 패키지 변경

Flutter SDK 1.2.0 버전부터 카카오톡 공유 패키지, 클라이언트, 모델, 메서드명이 변경되었습니다. 자세한 안내는 공지사항을 참고합니다.

구현 방법 선택하기

Step 1. 메시지 API 선택하기

메시지 API는 카카오톡 공유와 카카오톡 메시지 두 가지입니다. 이해하기를 참고해 어떤 API로 메시지 보내기를 구현할 것인지 결정합니다.

Step 2. 메시지 종류 및 구성 방법 선택하기

메시지 템플릿을 참고하여 어떤 메시지 템플릿을 사용할지 결정합니다.

보낼 메시지는 기본 템플릿을 바탕으로 객체 형태로 구성하거나, 서비스에 맞게 직접 구성한 사용자 정의 템플릿을 사용하여 구성할 수 있습니다. 자세한 정보는 메시지 구성 방법에서 확인할 수 있습니다.

Step 3. 메시지 공유 방법 확인하기

카카오톡 공유는 기본적으로 카카오톡을 통해 메시지를 공유하는 기능을 제공하지만, 웹 공유 기능도 지원하므로 디바이스의 카카오톡 설치 여부와 무관하게 사용 가능합니다.

카카오톡 설치 여부 메시지 공유 방법
설치 카카오톡을 통해 메시지 전송 가능

동작 순서:
1. 각 기능 개발 가이드를 참고하여 카카오톡 공유 화면을 실행하는 Uri 생성
2. ShareClientlaunchKakaoTalk() 메서드로 Uri를 실행하여 카카오톡에서 공유하기 화면 출력
미설치 웹 공유 기능을 통해 메시지 전송 가능

동작 순서:
1. 각 기능 개발 가이드를 참고하여 웹 공유 기능을 실행하는 Uri 생성
2. launchBrowserTab() 메서드로 웹에서 공유하기 화면 출력

서비스의 필요에 따라 카카오톡을 통한 공유하기만 지원하려면, ShareClientisKakaoTalkSharingAvailable()를 사용해 카카오톡 설치 여부를 확인할 수 있습니다. 아래 예제를 참고합니다.

bool result = await ShareClient.instance.isKakaoTalkSharingAvailable();
if (result) {
  print('카카오톡으로 공유 가능');
} else {
  print('카카오톡 미설치: 웹 공유 기능 사용 권장');
}

카카오톡이 설치되지 않은 디바이스에서도 카카오톡 공유하기를 지원하려면 웹 공유 기능을 사용합니다. 아래는 웹 공유 기능을 사용해 기본 템플릿 메시지를 공유하는 예제입니다.

try {
  Uri shareUrl = await WebSharerClient.instance
      .makeDefaultUrl(template: defaultFeed);
  await launchBrowserTab(shareUrl);
} catch (error) {
  print('카카오톡 공유 실패 $error');
}
카카오톡 공유 메시지 전송 성공 여부 확인 방법

카카오톡 공유 완료 시 반환되는 값은 없으며, 전송 성공 여부는 카카오톡 공유 전송 성공 알림 설정하기를 통해서만 알 수 있습니다.

프로젝트 설정하기: Android

Android 디바이스에서 카카오톡 공유를 사용하려면 다음 설정이 필요합니다.

프로젝트 설정하기: iOS

iOS 디바이스에서 카카오톡 공유를 사용하려면 다음 두 가지 설정이 모두 필요합니다.

  • 앱 실행 허용 목록 설정하기
    • ${Project} > ios 폴더를 우클릭하여 Xcode에서 프로젝트를 열고 설정
    • 설정 경로: [TARGET] > [Info] > [Custom iOS Target Properties]
    • 파일을 직접 수정하여 설정 시, Info.plist 파일 경로: ${Project} > ios > Runner > Info.plist
  • URL Schemes 설정하기
    • ${Project} > ios 폴더를 우클릭하여 Xcode에서 프로젝트를 열고 설정
    • 설정 경로: [TARGET] > [Info] > [URL Types] > [URL Schemes]

메시지 만들기

Flutter SDK는 카카오톡 공유 및 카카오톡 메시지를 통해 전송할 기본 템플릿을 생성할 때 DefaultTemplate 인터페이스를 구현한 다섯 가지 클래스를 사용합니다. 다음은 종류별 기본 템플릿 생성 예제입니다.

Feed
List
Location
Commerce
Text
final FeedTemplate defaultFeed = FeedTemplate(
  content: Content(
    title: '딸기 치즈 케익',
    description: '#케익 #딸기 #삼평동 #카페 #분위기 #소개팅',
    imageUrl: Uri.parse(
        'https://mud-kage.kakao.com/dn/Q2iNx/btqgeRgV54P/VLdBs9cvyn8BJXB3o7N8UK/kakaolink40_original.png'),
    link: Link(
        webUrl: Uri.parse('https://developers.kakao.com'),
        mobileWebUrl: Uri.parse('https://developers.kakao.com')),
  ),
  itemContent: ItemContent(
    profileText: 'Kakao',
    profileImageUrl: Uri.parse(
        'https://mud-kage.kakao.com/dn/Q2iNx/btqgeRgV54P/VLdBs9cvyn8BJXB3o7N8UK/kakaolink40_original.png'),
    titleImageUrl: Uri.parse(
        'https://mud-kage.kakao.com/dn/Q2iNx/btqgeRgV54P/VLdBs9cvyn8BJXB3o7N8UK/kakaolink40_original.png'),
    titleImageText: 'Cheese cake',
    titleImageCategory: 'cake',
    items: [
      ItemInfo(item: 'cake1', itemOp: '1000원'),
      ItemInfo(item: 'cake2', itemOp: '2000원'),
      ItemInfo(item: 'cake3', itemOp: '3000원'),
      ItemInfo(item: 'cake4', itemOp: '4000원'),
      ItemInfo(item: 'cake5', itemOp: '5000원')
    ],
    sum: 'total',
    sumOp: '15000원',
  ),
  social: Social(likeCount: 286, commentCount: 45, sharedCount: 845),
  buttons: [
    Button(
      title: '웹으로 보기',
      link: Link(
        webUrl: Uri.parse('https: //developers.kakao.com'),
        mobileWebUrl: Uri.parse('https: //developers.kakao.com'),
      ),
    ),
    Button(
      title: '앱으로보기',
      link: Link(
        androidExecutionParams: {'key1': 'value1', 'key2': 'value2'},
        iosExecutionParams: {'key1': 'value1', 'key2': 'value2'},
      ),
    ),
  ],
);
final ListTemplate defaultList = ListTemplate(
  headerTitle: 'WEEKLY MAGAZINE',
  headerLink: Link(
    webUrl: Uri.parse('https://developers.kakao.com'),
    mobileWebUrl: Uri.parse('https://developers.kakao.com'),
  ),
  contents: [
    Content(
      title: '취미의 특징, 탁구',
      description: '스포츠',
      imageUrl: Uri.parse(
          'https://mud-kage.kakao.com/dn/bDPMIb/btqgeoTRQvd/49BuF1gNo6UXkdbKecx600/kakaolink40_original.png'),
      link: Link(
        webUrl: Uri.parse('https://developers.kakao.com'),
        mobileWebUrl: Uri.parse('https://developers.kakao.com'),
      ),
    ),
    Content(
      title: '크림으로 이해하는 커피이야기',
      description: '음식',
      imageUrl: Uri.parse(
          'https://mud-kage.kakao.com/dn/QPeNt/btqgeSfSsCR/0QJIRuWTtkg4cYc57n8H80/kakaolink40_original.png'),
      link: Link(
        webUrl: Uri.parse('https://developers.kakao.com'),
        mobileWebUrl: Uri.parse('https://developers.kakao.com'),
      ),
    ),
    Content(
      title: '감성이 가득한 분위기',
      description: '사진',
      imageUrl: Uri.parse(
          'https://mud-kage.kakao.com/dn/c7MBX4/btqgeRgWhBy/ZMLnndJFAqyUAnqu4sQHS0/kakaolink40_original.png'),
      link: Link(
        webUrl: Uri.parse('https://developers.kakao.com'),
        mobileWebUrl: Uri.parse('https://developers.kakao.com'),
      ),
    ),
  ],
  buttons: [
    Button(
      title: '웹으로 보기',
      link: Link(
        webUrl: Uri.parse('https://developers.kakao.com'),
        mobileWebUrl: Uri.parse('https://developers.kakao.com'),
      ),
    ),
    Button(
      title: '앱으로 보기',
      link: Link(
        androidExecutionParams: {'key1': 'value1', 'key2': 'value2'},
        iosExecutionParams: {'key1': 'value1', 'key2': 'value2'},
      ),
    ),
  ],
);
final LocationTemplate defaultLocation = LocationTemplate(
  address: '경기 성남시 분당구 판교역로 235 에이치스퀘어 N동 8층',
  content: Content(
    title: '신메뉴 출시❤️ 체리블라썸라떼',
    description: '이번 주는 체리블라썸라떼 1+1',
    imageUrl: Uri.parse(
        'https://mud-kage.kakao.com/dn/bSbH9w/btqgegaEDfW/vD9KKV0hEintg6bZT4v4WK/kakaolink40_original.png'),
    link: Link(
      webUrl: Uri.parse('https://developers.kakao.com'),
      mobileWebUrl: Uri.parse('https://developers.kakao.com'),
    ),
  ),
  social: Social(likeCount: 286, commentCount: 45, sharedCount: 845),
);
final CommerceTemplate defaultCommerce = CommerceTemplate(
  content: Content(
    title: 'Ivory long dress (4 Color)',
    imageUrl: Uri.parse(
        'https://mud-kage.kakao.com/dn/RY8ZN/btqgOGzITp3/uCM1x2xu7GNfr7NS9QvEs0/kakaolink40_original.png'),
    link: Link(
      webUrl: Uri.parse('https://developers.kakao.com'),
      mobileWebUrl: Uri.parse('https://developers.kakao.com'),
    ),
  ),
  commerce: Commerce(
    regularPrice: 208800,
    discountPrice: 146160,
    discountRate: 30,
    productName: "Ivory long dress",
    currencyUnit: "₩",
    currencyUnitPosition: 1,
  ),
  buttons: [
    Button(
      title: '구매하기',
      link: Link(
        webUrl: Uri.parse('https://developers.kakao.com'),
        mobileWebUrl: Uri.parse('https://developers.kakao.com'),
      ),
    ),
    Button(
      title: '공유하기',
      link: Link(
        androidExecutionParams: {'key1': 'value1', 'key2': 'value2'},
        iosExecutionParams: {'key1': 'value1', 'key2': 'value2'},
      ),
    )
  ],
);
final TextTemplate defaultText = TextTemplate(
  text:
      '카카오톡 공유는 카카오 플랫폼 서비스의 대표 기능으로써 사용자의 모바일 기기에 설치된 카카오 플랫폼과 연동하여 다양한 기능을 실행할 수 있습니다.\n현재 이용할 수 있는 카카오톡 공유는 다음과 같습니다.\n카카오톡링크\n카카오톡을 실행하여 사용자가 선택한 채팅방으로 메시지를 전송합니다.\n카카오스토리링크\n카카오스토리 글쓰기 화면으로 연결합니다.',
  link: Link(
    webUrl: Uri.parse('https: //developers.kakao.com'),
    mobileWebUrl: Uri.parse('https: //developers.kakao.com'),
  ),
);

기본 템플릿으로 메시지 보내기

기본 정보

사전 설정 레퍼런스
플랫폼 등록 shareDefault()
makeDefaultUrl()
FeedTemplate
ListTemplate
LocationTemplate
CommerceTemplate
TextTemplate

기본 템플릿을 사용해 카카오톡으로 메시지를 공유합니다. 메시지 공유 방법 확인하기와 예제를 참고하여 다음 중 원하는 방법으로 공유하기를 구현합니다. 두 가지 공유 방법을 모두 사용하도록 구현할 수도 있습니다.

공통 파라미터
Name Type Description Required
defaultTemplate DefaultTemplate 전송할 메시지 템플릿 객체
원하는 템플릿에 맞는 클래스로 객체를 생성해야 함
메시지 만들기 참고
O
serverCallbackArgs Map<String, String> 메시지 전송 성공 시 서비스 서버로 알림을 보내고 싶을 때 사용
카카오톡 공유 전송 성공 알림 설정하기 참고
X
카카오톡에서 공유하기

ShareClientshareDefault()을 호출합니다. 요청 성공 시, 카카오톡에서 기본 템플릿으로 메시지를 공유하는 화면으로 이동할 수 있는 Uri가 반환됩니다. 반환된 Uri를 전달하여 ShareClientlaunchKakaoTalk() 메서드를 호출해 공유하기를 실행합니다.

try {
  Uri uri =
      await ShareClient.instance.shareDefault(template: defaultFeed);
  await ShareClient.instance.launchKakaoTalk(uri);
  print('카카오톡 공유 완료');
} catch (error) {
  print('카카오톡 공유 실패 $error');
}
웹 공유 기능 사용하기

WebSharerClientmakeDefaultUrl()를 호출합니다. 요청 성공 시, 웹 공유 기능을 실행하는 Uri가 반환됩니다. 반환된 Uri를 전달하여 launchBrowserTab() 메서드를 호출해 공유하기를 실행합니다.

try {
  Uri shareUrl = await WebSharerClient.instance
      .makeDefaultUrl(template: defaultFeed);
  await launchBrowserTab(shareUrl);
} catch (error) {
  print('카카오톡 공유 실패 $error');
}

사용자 정의 템플릿으로 메시지 보내기

기본 정보

사전 설정 레퍼런스
플랫폼 등록
메시지 템플릿
shareCustom()
makeCustomUrl()

[도구] > [메시지 템플릿]에서 직접 구성한 사용자 정의 템플릿을 사용해 카카오톡으로 메시지를 공유합니다. 메시지 공유 방법 확인하기와 예제를 참고하여 다음 중 원하는 방법으로 공유하기를 구현합니다. 두 가지 공유 방법을 모두 사용하도록 구현할 수도 있습니다.

공통 파라미터
Name Type Description Required
templateId int 메시지 템플릿 도구에서 구성한 사용자 정의 템플릿의 ID O
templateArgs Map<String, String> templateId로 지정한 템플릿에 사용자 인자(User argument)가 포함되어 있는 경우 대입할 값
(key:value 형식)
X
serverCallbackArgs Map<String, String> 메시지 전송 성공 시 서비스 서버로 알림을 보내고 싶을 때 사용
카카오톡 공유 전송 성공 알림 설정하기 참고
X
카카오톡에서 공유하기

ShareClientshareCustom()을 호출합니다. 요청 성공 시, 카카오톡에서 기본 템플릿으로 메시지를 공유하는 화면으로 이동할 수 있는 Uri가 반환됩니다. 반환된 Uri를 전달하여 ShareClientlaunchKakaoTalk() 메서드를 호출해 공유하기를 실행합니다.

// 사용자 정의 템플릿 ID
int templateId = '${YOUR_CUSTOM_TEMPLATE_ID}';

try {
  Uri uri =
      await ShareClient.instance.shareCustom(templateId: templateId);
  await ShareClient.instance.launchKakaoTalk(uri);
  print('카카오톡 공유 완료');
} catch (error) {
  print('카카오톡 공유 실패 $error');
}
웹 공유 기능 사용하기

WebSharerClientmakeCustomUrl()를 호출합니다. 요청 성공 시, 웹 공유 기능을 실행하는 Uri가 반환됩니다. 반환된 Uri를 전달하여 launchBrowserTab() 메서드를 호출해 공유하기를 실행합니다.

// 사용자 정의 템플릿 ID
int templateId = '${YOUR_CUSTOM_TEMPLATE_ID}';

try {
  Uri shareUrl = await WebSharerClient.instance.makeCustomUrl(
      templateId: templateId, templateArgs: {'key1': 'value1'});
  await launchBrowserTab(shareUrl);
} catch (error) {
  print('카카오톡 공유 실패 $error');
}

기본 템플릿으로 스크랩 메시지 보내기

기본 정보

사전 설정 레퍼런스
플랫폼 등록 shareScrap()
makeScrapUrl()
FeedTemplate
ListTemplate
LocationTemplate
CommerceTemplate
TextTemplate

지정한 웹 페이지를 스크랩한 정보로 스크랩 메시지를 구성하여 공유합니다. 메시지 공유 방법 확인하기와 예제를 참고하여 다음 중 원하는 방법으로 공유하기를 구현합니다. 두 가지 공유 방법을 모두 사용하도록 구현할 수도 있습니다.

공통 파라미터
Name Type Description Required
url String 스크랩할 웹 페이지 URL

주의: [내 애플리케이션] > [플랫폼] > [Web]에 등록된 도메인만 사용 가능
O
serverCallbackArgs Map<String, String> 메시지 전송 성공 시 서비스 서버로 알림을 보내고 싶을 때 사용
카카오톡 공유 전송 성공 알림 설정하기 참고
X
카카오톡에서 공유하기

ShareClientshareScrap()을 호출합니다. 요청 성공 시, 카카오톡에서 기본 템플릿으로 메시지를 공유하는 화면으로 이동할 수 있는 Uri가 반환됩니다. 반환된 Uri를 전달하여 ShareClientlaunchKakaoTalk() 메서드를 호출해 공유하기를 실행합니다.

// 스크랩할 웹 페이지 URL
String url = "https://developers.kakao.com";

try {
  Uri uri = await ShareClient.instance.shareScrap(url: url);
  await ShareClient.instance.launchKakaoTalk(uri);
  print('카카오톡 공유 완료');
} catch (error) {
  print('카카오톡 공유 실패 $error');
}
웹 공유 기능 사용하기

WebSharerClientmakeScrapUrl()를 호출합니다. 요청 성공 시, 웹 공유 기능을 실행하는 Uri가 반환됩니다. 반환된 Uri를 전달하여 launchBrowserTab() 메서드를 호출해 공유하기를 실행합니다.

// 스크랩할 웹 페이지 URL
String url = "https://developers.kakao.com";

try {
  Uri shareUrl = await WebSharerClient.instance
      .makeScrapUrl(url: url, templateArgs: {'key1': 'value1'});
  await launchBrowserTab(shareUrl);
} catch (error) {
  print('카카오톡 공유 실패 $error');
}

사용자 정의 템플릿으로 스크랩 메시지 보내기

기본 정보

사전 설정 레퍼런스
플랫폼 등록
메시지 템플릿
shareScrap()
makeScrapUrl()

[도구] > [메시지 템플릿]에서 직접 구성한 사용자 정의 템플릿에 지정한 웹 페이지의 스크랩 정보를 대입해 메시지를 구성하고 공유합니다. 메시지 공유 방법 확인하기와 예제를 참고하여 다음 중 원하는 방법으로 공유하기를 구현합니다. 두 가지 공유 방법을 모두 사용하도록 구현할 수도 있습니다.

공통 파라미터
Name Type Description Required
url String 스크랩할 웹 페이지 URL

주의: [내 애플리케이션] > [플랫폼] > [Web]에 등록된 도메인만 사용 가능
O
templateId int 스크랩한 정보를 반영할 사용자 정의 템플릿 ID([도구] > [메시지 템플릿]에서 구성한 템플릿의 ID)
스크랩 메시지 참고
O
templateArgs Map<String, String> templateId로 지정한 템플릿에 사용자 인자(User argument)가 포함되어 있는 경우 대입할 값
(key:value 형식)

참고: 스크랩 결과를 덮어쓰기(overwrite) 할 수는 없음
X
serverCallbackArgs Map<String, String> 메시지 전송 성공 시 서비스 서버로 알림을 보내고 싶을 때 사용
카카오톡 공유 전송 성공 알림 설정하기 참고
X
카카오톡에서 공유하기

ShareClientshareScrap()을 호출합니다. 웹 페이지 스크랩 정보를 대입할 사용자 정의 템플릿의 ID를 반드시 전달해야 합니다.

요청 성공 시, 카카오톡에서 기본 템플릿으로 메시지를 공유하는 화면으로 이동할 수 있는 Uri가 반환됩니다. 반환된 Uri를 전달하여 ShareClientlaunchKakaoTalk() 메서드를 호출해 공유하기를 실행합니다.

// 사용자 정의 템플릿 ID
int templateId = '${YOUR_CUSTOM_TEMPLATE_ID}';
// 스크랩할 웹 페이지 URL
String url = "https://developers.kakao.com";

try {
  Uri uri = await ShareClient.instance.shareScrap(url: url, templateId: templateId);
  await ShareClient.instance.launchKakaoTalk(uri);
  print('카카오톡 공유 완료');
} catch (error) {
  print('카카오톡 공유 실패 $error');
}
웹 공유 기능 사용하기

WebSharerClientmakeScrapUrl()를 호출합니다. 웹 페이지 스크랩 정보를 대입할 사용자 정의 템플릿의 ID를 반드시 전달해야 합니다.

요청 성공 시, 웹 공유 기능을 실행하는 Uri가 반환됩니다. 반환된 Uri를 전달하여 launchBrowserTab() 메서드를 호출해 공유하기를 실행합니다.

// 사용자 정의 템플릿 ID
int templateId = '${YOUR_CUSTOM_TEMPLATE_ID}';
// 스크랩할 웹 페이지 URL
String url = "https://developers.kakao.com";

try {
  Uri shareUrl = await WebSharerClient.instance
      .makeScrapUrl(url: url, templateId: templateId, templateArgs: {'key1': 'value1'});
  await launchBrowserTab(shareUrl);
} catch (error) {
  print('카카오톡 공유 실패 $error');
}

전송 성공 알림 설정하기

전송 성공 알림은 사용자가 선택한 친구나 채팅방으로 카카오톡 공유 메시지가 성공적으로 전달된 경우, 개발자 웹사이트에 설정된 콜백 URL로 메시지가 성공적으로 전달되었음을 알려주는 기능입니다.

전송 성공 알림은 카카오톡 공유 메시지 전송 시에만 사용할 수 있고, 카카오톡 메시지 전송에는 지원되지 않습니다. 카카오톡 공유는 사용자가 카카오톡에서 메시지를 전송하므로 서비스에서 전송 성공 여부를 직접 확인할 수 없기 때문에 메시지 전송 성공 시 알림을 받는 서버 콜백(Callback) 기능을 제공합니다.

이 기능을 사용하려면 다음을 수행해야 합니다.

  1. 카카오톡 공유 전송 성공 알림 설정을 참고하여 콜백 URL과 요청 방법(Method) 설정
  2. 카카오톡 공유 콜백을 받을 서버 구현
  3. 카카오톡 공유 API 호출 시 사용자 정의(Custom) 파라미터 전달
  4. 서비스 서버의 콜백 URL로 전달되는 알림에 대한 처리 구현

서비스 서버로 보내지는 카카오톡 공유 전송 성공 알림은 자세한 메시지 전송 관련 정보를 포함하지 않습니다. 어떤 메시지의 전송 결과인지, 사용자가 어떤 콘텐츠를 공유했는지 등 서비스에서 필요한 추가 정보를 파악하려면 사용자 정의(Custom) 파라미터를 사용해야 합니다. 또한, 사용자 정의 파라미터를 포함하지 않은 카카오톡 공유 메시지는 카카오톡 공유 전송 성공 알림이 전달되지 않습니다.

사용자 정의 파라미터는 serverCallbackArgs 파라미터를 통해 카카오톡 공유 요청 시에 전달합니다. 다음은 사용자 정의 파라미터를 포함한 카카오톡 공유 요청 예제입니다.

try {
  // serverCallbackArgs 파라미터로 사용자 정의 파라미터 전달
  // 해당 파라미터 미사용 시 카카오톡 공유 전송 성공 알림 전달되지 않음
  Uri uri =
      await ShareClient.instance.defaultTemplate(template: defaultFeed, serverCallbackArgs: {'key1': 'value1'});
  await ShareClient.instance.launchKakaoTalk(uri);
  print('카카오톡 공유 완료');
} catch (error) {
  print('카카오톡 공유 실패 $error');
}

이미지 업로드하기

기본 정보

사전 설정 레퍼런스
플랫폼 등록 uploadImage()
scrapImage()
ImageUploadResult
ImageInfo

메시지에 넣을 이미지는 URL 형태로 메시지 템플릿 구성 시에 첨부하거나, 메시지 템플릿 도구에서 미리 업로드할 수 있습니다. 이미지 파일은 카카오 서버에 업로드하거나 스크랩해야 메시지 전송에 사용할 수 있습니다.

ShareClient에서 제공하는 메서드를 사용해 카카오 서버에 이미지를 업로드하거나 스크랩할 수 있습니다.

주의: 파일 용량

파일 용량 2MB 이하 이미지만 업로드할 수 있습니다.

이미지 파일을 카카오 서버에 업로드하려면 uploadImage()를 호출합니다. 요청 성공 시 ImageUploadResult 객체가 반환됩니다. 해당 객체 내부의 ImageInfo에서 메시지 전송에 사용할 이미지 URL 등 업로드된 이미지 정보를 확인할 수 있습니다.

// 로컬 이미지 파일
// 이 예제에서는 프로젝트 리소스로 추가한 이미지 파일을 사용했습니다.
// 갤러리 등 서비스에 필요한 사진 파일을 준비합니다.
ByteData byteData = await rootBundle.load('assets/images/cat1.png');

// 이 예제에서는 path_provider를 사용해 프로젝트 리소스를 이미지 파일로 저장했습니다.
File tempFile =
    File('${(await getTemporaryDirectory()).path}/cat1.png');
File file = await tempFile.writeAsBytes(byteData.buffer
    .asUint8List(byteData.offsetInBytes, byteData.lengthInBytes));

try {
  // 카카오 이미지 서버로 업로드
  ImageUploadResult imageUploadResult =
      await ShareClient.instance.uploadImage(image: file);
  print('이미지 업로드 성공'
        '\n${imageUploadResult.infos.original}');
} catch (error) {
  print('이미지 업로드 실패 $error');
}

웹 상의 이미지를 카카오 서버에 스크랩하려면 scrapImage()를 호출합니다. 요청 성공 시, 업로드된 이미지 정보를 포함한 ImageUploadResult 객체가 반환됩니다.

// 원본 이미지 URL
String url =
    'https://t1.kakaocdn.net/kakaocorp/Service/KakaoTalk/pc/slide/talkpc_theme_01.jpg';

try {
  // 카카오 서버에 이미지 스크랩
  ImageUploadResult imageUploadResult =
      await ShareClient.instance.scrapImage(imageUrl: url);
  print('이미지 스크랩 성공'
        '\n${imageUploadResult.infos.original}');
} catch (error) {
  print('이미지 스크랩 실패 $error');
}

더보기