SDK 설치

Classic/VPC 환경에서 이용 가능합니다.

Android/iOS/Unity SDK 사용에 대해 안내합니다.
SDK를 설치하고 환경을 구성함으로써 채팅과 대시보드를 연동할 수 있습니다.

요구 사양

Javascript/Typescript

Microsoft Edge 13 이상
Chrome 16 이상
Firefox 11 이상
Safari 7 이상
Opera 12.1 이상
iOS Safari 7 이상
Android Browser 4.4 (Kitkat) 이상

Unity

최소 사양: 2020 이상 (하위 버전의 Unity 지원이 필요할 경우 문의채널로 문의해 주십시오.)
2020.3.X / 2021.1.X 버전의 Unity 에디터 사용자는 2020.3.15f2 이상 / 2021.1.16f1 이상 버전을 사용해 주십시오(AAB 버전 빌드 시 Unity 에디터 버그 수정 버전).

Android (Kotlin)

컴파일 그리고 타겟 SDK 버전 33

iOS (Swift)

iOS 12.0 이상
Xcode 15.0 이상 (출처)
Cocoapods

SDK 설치 및 환경 구성

Javascript/Typescript

https://unpkg.com/ncloudchat/ncloudchat.min.js

CDN 을 통해 제공해 드리는 스크립트를 head와 head 사이에 추가해 주십시오.

<head>
    <script src="https://unpkg.com/ncloudchat/ncloudchat.min.js"></script>
</head>

참고

버전 정보는 https://www.npmjs.com/package/ncloudchat를 통해 확인 수 있습니다.

Ncloud Chat Javascript SDK는 npm 패키지로 제공되며 yarn을 통해서도 사용할 수 있습니다.

# using npm
npm install ncloudchat

# using yarn
yarn add ncloudchat

Android (Kotlin)

Firebase Console 에서 Andoird 앱을 추가 후, 다운로드한 "google-services.json' 파일을 프로젝트 앱 모듈의 루트 폴더에 추가합니다.

파일 추가 후 프로젝트의 settings.gradle.kts 내 아래 내용을 추가합니다.

dependencyResolutionManagement {
    repositories {
        ...
        google()
        // nbase repo
        maven(url = "https://repo.nbase.io/repository/nbase-releases")
        ...
    }
}

app 모듈의 bundle.gradle.kts 내 아래 내용을 추가합니다.

plugins {
    ...
    id("com.google.gms.google-services")
}

 dependencies {
    implementation("io.nbase:nbasesdk:latest.release")
    implementation("io.nbase:nbase-adapter-cloudchat:latest.release")
    implementation("com.google.firebase:firebase-messaging-ktx:23.2.1")
}

proguard 를 사용하신다면 proguard-rules 내 아래 내용을 추가합니다.

-dontwarn com.nbase.**
-dontwarn com.samsung.**
-keep class com.nbase.** { *; }

iOS (Swift)

Podfile 을 열고 다음과 같이 추가합니다.

platform :ios, '12.0'

# 프로젝트 메인 타겟
target '프로젝트 메인 타겟' do
...

  pod 'Socket.IO-Client-Swift', '16.1.0'
  pod 'NChat', '3.0.28'
...
end

pod install 를 실행하여 SDK 설치를 완료합니다.

참고

Apollo 패키지 매니저 추가
No such module 'Apollo' 오류 발생 시에 Swift Package Manager 실행 후 Apollo 프레임워크를 추가해 주십시오.

'+' 버튼 클릭 후에 Add Package Collection ' https://github.com/apollographql/apollo-ios.git ' 추가 후
apollo-ios 선택 후 Add Package 에서 프로젝트 메인 타겟을 선택해 주세요.

Unity

Ncloud Chat Unity SDK를 다운로드하고 Unity에서 프로젝트를 구성하는 방법은 다음과 같습니다.

네네이버 클라우드 플랫폼 콘솔에서 > Services > Business Applications > Ncloud Chat 메뉴를 차례대로 클릭해 주십시오.
프로젝트의 관리페이지 URL을 클릭하여 대시보드에 로그인해 주십시오.
GitHub 리포지스토리의 페이지에서 다운로드해 주십시오.
샘플 또한 GitHub 리포지스토리의 페이지에서 다운로드해 주십시오.
Unity 프로그램을 실행한 후 프로젝트를 생성해 주십시오.
Unity에서 Assets > Import Package > Custom Package... 메뉴를 차례대로 클릭해 주십시오.
대시보드에서 다운로드한 'NcloudChat.Unity.SDK.[version].unitypackage' 파일을 불러와 주십시오.
패키지에 있는 모든 파일을 선택한 후 [Import] 버튼을 클릭해 주십시오.
프로젝트를 저장해 주십시오.