1 of 19

Migration Guides

The following pages contain the migration guides of our SDKs

Web SDK v5.0.0 Migration Guide

iOS UIKit V3.0 Migration Guide

UIKit v3.0.0 is the major release of our UIKit with AmitySDK v6.5.0.

The guide will cover all the breaking changes and migration to this version.

Installation:

Manual Installation:

UIKit v3.0.0 will require RealmSwift.xcframework along with the existing frameworks.

Behavior Changes:

AmityUIKItManager:

Property | Methods

Changes

Remarks

setup(apiKey:, httpUrl:, socketUrl:)

Removed

use setup(apiKey:, endpoint:) instead

registerDevice(userId:, displayName:, authToken:, completion:)

Removed

Use registerDevice(userId:, displayName:, authToken:, sessionHandler:, completion:) instead.

AmityChannelEventHandler:

Property | Methods

Changes

Remarks

channelDidTap(from:, channelId:)

Removed

Override channelDidTap(from:, channelId:, subChannelId:) instead.

AmityEventHandler:

Property | Methods

Changes

Remarks

communityChannelDidTap(from:, channelId:)

Removed

Override communityChannelDidTap(from:, channelId:, subChannelId:) instead.

AmityMessageListViewController:

Property | Methods

Changes

Remarks

make(channelId:, settings:)

Removed

Use make(channelId:, subChannelId:, settings:) instead.

AmityCommunityProfilePageViewController:

Property | Methods

Changes

Remarks

make(withCommunityId:, settings:)

Removed

Use make(withCommunityId:) instead.

iOS SDK v6.0.0 Migration Guide

This guide is to provide information about breaking changes and how to migrate to the AmitySDK iOS 6.0.0 version.

Installation

Manual Installation

AmitySDK 6.x.x version requires RealmSwift.xcframework along with existing frameworks.

Behaviour Changes

Channel

Channel Creation

Support for Providing custom ID when creating channel is now removed.

Sub Channels:

Now you can create multiple sub-channels inside a channel. Each Sub Channels acts as a separate container for message. The channel itself would act as a default Sub Channel. You can access this default sub channel id through defaultSubChannelId property in class AmityChannel.

Messages

Sending a message in a Channel or Sub Channel now requires subchannelId. If you want to send message in default subchannel (i.e the default channel itself), please use defaultSubChannelId property from AmityChannel.

For sending message in particular AmitySubchannel, you can get its id from subChannelId property.

Interface Changes:

@objc support for all interfaces such as classes, enums, methods, properties are removed. Please create a swift wrapper class to interact with the SDK if your project still uses Objective-C.

All Enums with rawType UInt has been changed to Int
Swift classes

AmityCollection

AmityReaction

AmityClient

AmityContentSettings

Channel

AmityChannel

AmityChannelParticipation

AmityMessage

AmityMessageRepository

AmityMessageEditor

AmityPost

AmityPollRepository

AmityPoll

AmityPollAnswer

AmityPostRepository

AmityFeedRepository

AmityCommunityRepository

AmityCommunity

AmityCommentRepository

AmityComment

AmityUser

AmityUserFollowManager

iOS SDK v6.9.0 Deprecation Note

Deprecated APIs

Deprecated APIs in AmityClient:

Method

Remark

Deprecated APIs in AmityUserNotificationsManager:

Method

Remark

Deprecated APIs in AmityPostRepository:

Method

Remark

Deprecated APIs in AmityCommunityRepository:

Method

Remark

Deprecated APIs in AmityChannelRepository:

Method

Remark

Deprecated APIs in AmitySubChannelRepository:

Method

Remark

Deprecated APIs in AmityCommentRepository:

Method

Remark

Deprecated APIs in AmityChannelModeration:

Deprecated APIs in AmityMessageRepository:

Deprecated APIs in AmityStreamBroadcaster. Use the `AmityVideoBroadcaster` class instead:

iOS SDK v6.8.0 Deprecation Note

Deprecated APIs

AmityCommentRepository:

Methods

Remarks

AmityCommentFlagger

Deprecated APIs in AmityCommentFlagger class. Use APIs in AmityCommentRepository instead.

Methods

Remarks

AmityUserFollowManager

Deprecated APIs in AmityUserFollowManager class. Use APIs in AmityUserRelationship instead.

Methods

Remarks

AmityChannelParticipation

Deprecated APIs in AmityChannelParticipation class. Use APIs in AmityChannelMembership instead.

AmityChannelModeration

AmityMessageEditor

Deprecated APIs in AmityMessageFlagger class. Use APIs in AmityMessageRepository instead.

AmityMessageFlagger

AmitySubChannelRepository

AmityClient

AmityMessageRepository

AmityFeedRepository

AmitySteamRepository

AmityStreamBroadcaster

iOS SDK v6.7.0 Deprecation Note

Deprecated APIs

AmityCommunityRepository:

Methods

Remarks

createCommunity(options:, completion:)

Use async createCommunity( options:)instead.

joinCommunity(communityId:, completion:)

Use async joinCommunity(communityId:)instead.

leaveCommunity(communityId:, completion:)

Use async leaveCommunity(communityId:)instead.

updateCommunity(id:, options:, completion:)

Use async updateCommunity(id:, options:)instead.

AmityCommunityParticipation

Deprecated AmityCommunityParticipation class. Use AmityCommunityMembership instead.

Methods

Remarks

addMembers(userIds:, completion:)

Use async addMembers(userIds:)in AmityCommunityMembership instead.

removeMembers(userIds:, completion:)

Use async removeMembers(userIds:)in AmityCommunityMembership instead.

getMember(userId:)

Use async getMember(userId:) in AmityCommunityMembership instead.

getMembers(membershipOptions: , roles:, sortBy:)

Use async getMembers(membershipOptions: , roles:, sortBy:)in AmityCommunityMembership instead.

AmityCommunityModeration

Methods

Remarks

banMembers(userIds:, completion: )

Use async banMembers(userIds:)instead.

unbanMembers(userIds:, completion:)

Use async unbanMembers(userIds:)instead.

addRoles(roles:, userIds:, completion:)

Use async leaveCommunity(communityId:)instead.

removeRoles(roles:, userIds:, completion:)

Use async removeRoles(roles:, userIds:)instead.

AmityPostRepository

Methods

Remarks

createPost(builder:, targetId:, targetType:, completion:)

Use async createPost(builder:, targetId:, targetType:)instead.

createPost(builder:, targetId:, targetType:, metadata:, mentionees:, completion:)

Use async createPost(builder:, targetId:, targetType:, metadata:, mentionees:)instead.

updatePost(postId:, builder:, completion:)

Use async editPost(postId:, builder:)instead.

updatePost(postId:, builder:, metadata:, mentionees:, completion:)

Use async editPost(postId:, builder:, metadata:, mentionees:)instead.

deletePost(postId:, parentId:, hardDelete:, completion:)

Use async softDeletePost(postId:, parentId:) or hardDeletePost(postId:, parentId:) instead.

approvePost(postId:, completion:)

Use async approvePost(postId:) instead.

declinePost(postId:, completion:)

Use async declinePost(postId:)instead.

AmityPostFlagger

Deprecated APIs in AmityPostFlagger class. Use APIs in AmityPostRepository instead.

Methods

Remarks

flagPost(completion:)

Use async flagPost(postId:) in AmityPostRepository instead.

unflagPost(completion:)

Use async unflagPost(postId:) in AmityPostRepository instead.

isPostFlaggedByMe(completion:)

Use async isFlaggedByMe(postId:)in AmityPostRepository instead.

AmityUserFlagger

Deprecated APIs in AmityUserFlagger class. Use APIs in AmityUserRepository instead.

Methods

Remarks

flag(completion:)

Use async flagUser(userId:) in AmityUserRepository instead.

unflag(completion:)

Use async unflagUser(userId:) in AmityUserRepository instead.

isFlaggedByMe(completion:)

Use async isUserFlaggedByMe(userId:)in AmityUserRepository instead.

AmityPollRepository

Methods

Remarks

createPoll(options:, completion:)

Use async createPoll(options:)instead.

closePoll(pollId:, completion:)

Use async closePoll(pollId:)instead.

votePoll(pollId:, answerIds:, completion:)

Use async votePoll(pollId:, answerIds:)instead.

deletePoll(pollId:, completion:)

Use async deletePoll(pollId:)instead.

iOS SDK v6.5.0 Deprecation Note

Deprecated APIs

AmityClient

Methods

Remarks

AmityMessageRepository

Methods

Remarks

AmityUserFlagger

Methods

Remarks

Android SDK v.6.20.0 Deprecation Note

Deprecated APIs

AmityMessageRepository

Methods

Remarks

createImageMessage(subChannelId: String, imageUri: Uri)

Use createImageMessage(subChannelId: String, attachment: AmityMessageAttachment) instead

createVideoMessage(subChannelId: String, videoUri: Uri)

Use createVideoMessage(subChannelId: String, attachment: AmityMessageAttachment) instead

createFileMessage(subChannelId: String, fileUri: Uri)

Use createFileMessage(subChannelId: String, attachment: AmityMessageAttachment) instead

createAudioMessage(subChannelId: String, audioUri: Uri)

Use createAudioMessage(subChannelId: String, attachment: AmityMessageAttachment) instead

Android SDK v.6.19.0 Deprecation Note

Deprecated APIs

AmityVideoPlayer

Methods

Remarks

play(streamId: String, url: String)

Use play(streamId: String) instead

AmityStream

Methods

Remarks

getRecordings()

Use play(streamId: String) instead

getWatcherData()

Use play(streamId: String) instead

Android SDK v6.9.0 Deprecation Note

Deprecated APIs

AmityChannelRepository

Methods

Remarks

updateChannel()

Use editChannel() instead

AmityMessageRepository

Methods

Remarks

createMessage()

Use createTextMessage()

or createImageMessage()

or createFileMessage()

or createVideoMessage()

or createAudioMessage()

or createCustomMessage()

instead

AmityMessage

Methods

delete()

Use AmityChatClient.newMessageRepostiory().softDeleteMessage() instead

AmityMessage.Data.TEXT

Methods

Remarks

edit()

Use AmityChatClient.newMessageRepostiory().editTextMessage()

instead

AmityMessage.Data.CUSTOM

Methods

Remarks

edit()

Use AmityChatClient.newMessageRepostiory().editCustomMessage()

instead

AmityMessageFlagger()

Methods

Remarks

flag()

Use AmityChatClient.newMessageRepostiory().flagMessage() instead

unflag()

Use AmityChatClient.newMessageRepostiory().unflagMessage() instead

AmitySubChannelRepository

Methods

Remarks

deleteSubChannel()

Use softDeleteSubChannel()

or hardDeleteSubChannel() instead

updateSubChannel()

Use editSubChannel() instead

AmityPostRepository

Methods

Remarks

createPost()

Use createTextPost()

or createImagePost()

or createFilePost()

or createVideoPost()

or createPollPost()

or createLiveStreamPost()

instead

Android SDK v6.5.0 Deprecation Note

Deprecated APIs

AmityCoreClient

Methods

Remarks

AmityChannelRepository

Methods

Remarks

AmityCommunityRepository

Methods

Remarks

AmityCommentRepository

Methods

Remarks

AmityComment

AmityMessageRepository

AmityMessage

AmityPostRepository

AmityPost

AmityUserRepository

Enum

TS SDK v6.4.6 Deprecation Note

Deprecated APIs

AmityStreamRepository

Methods

Remarks

AmityCommunityRepository

Methods

Remarks

TS SDK v6.8.0 Deprecation Note

Deprecated APIs

getTotalUnreadCount

Methods

Remarks

Web SDK v5.0.0 Migration Guide

This guide is to provide information about breaking changes and how to migrate to the AmitySDK Web 5.0.0 version.

Installation

Following the recent changes with Amity Social Cloud, the Web SDK is now published under a different name.

To install the new v5 version, you will have to run the following commands:

npm uninstall eko-sdk # uninstall version 4
npm install --save @amityco/js-sdk # install version 5

After that, you'll have to change your imports accordingly. You can easily do this by performing a global "search and replace" and put eko-sdk as input and @amityco/js-sdk as output. You should end up with a diff looking like this:

-import Client from 'eko-sdk'
+import Client from '@amityco/js-sdk'

After that, we also renamed the sets of constants for consistency.

Handling Breaking Changes

Don't worry, we didn't change much! Only errors and constants were impacted since we used to prefix them. Aside from this, we did not introduce any change in SDK's logic.

If you are looking for a quick win which will fit 90% of the projects, we recommend you to perform a quick "search and replace" and erase the "Eko" prefix from your code wherever you used it. That is that simple!

For the most precautious, here's an exhaustive list of the names we changed.

Eko Client (optional)

The main object you'll interact with is our SDK Client. This class can be freely renamed since it is the default export of our package (ie: import EkoClient from "eko-sdk") so there should be no problem keeping it like this if you prefer.

In the eventuality that you'd like to keep the name we gave in the source code, please find that we rename the class to ASCClient.

Errors (optional)

Globally found, there will be no need to adapt your code except if you specifically added try catch blocks for those error classes.

Constants (mandatory)

All these can be found as named exports at the root of our package (ie: import { EkoFileType } from "eko-sdk"). You will have to manually change those.

Client

LiveObject

User

File

Reactions

Channel

Message

Community

Post

Comment

Conflicting Names

In case you're already using any of those names in your own codebase, you can easily manage by renaming the named imports with the as keyword.

import { CommentDataType } from './my-own-module'

// use "as" to rename as you see fit and avoid conflicts.
import {
  CommentDataType as ASCCommentDataType,
} from '@amityco/js-sdk'

Flutter SDK beta Migration Guide

TS SDK v6.0.0 Migration Guide

This guide is to provide information about breaking changes and how to migrate to the Amity TS SDK 6.0.0 version.

Installation

Using NPM

npm i @amityco/ts-sdk@^6.0.0

Using Yarn

yarn add @amityco/ts-sdk@^6.0.0

Deprecation of RunQuery / CreateQuery

Starting from 6.0.0 we recommend to use API's asynchronously. As it will soon be deprecated. Example:

// before
import { updatePost, runQuery, createQuery } from '@amityco/ts-sdk';

const query = createQuery(updatePost, 'postId', { ...updatedPost });

runQuery(query, callback);

// after v6.0.0
import { PostRepository } from '@amityco/ts-sdk'

const updatedPost = await PostRepository.updatePost('postId', { ...updatedPost });

Real Time Events

The real time events are supported via MQTT, which has a crucial difference in how it works compared to web sockets. This is, events are not broadcast-ed to all users. So this means that you only get real time event updates to those topics that you subscribe to.

Note: Some exceptions to this are message events and smart feed events. If you are unsure if subscription is required for a particular topic, check the code-snippet for that particular API for details.

There are also other limitations to getting RTE's, example: you cannot subscribe to events for a community that you are not a member of. Check documentation for full details.

You can read more about MQTT here: https://mqtt.org/

/*
 * Whenever you notice similar code block in the code snippets it indicates that you 
 * subscribing to a particular topic, which in turn let's the server know that you
 * would require real time events for this topic
*/

subscribeTopic(getUserTopic(user, SubscriptionLevels.POST), () => {
    // use callback to handle errors with event subscription
}),

Live Object

Although live objects were introduced prior to v6. All getter methods for singular objects (example getPost) will now return a subscribe-able object.

This means that if an object gets updated and you have subscribed to real time events, the object will get updated automatically via real time events.

If for your use case you don't require any real time updates, you can unsubscribe immediately. For further information about Live Object, please visit #live-object page.

Getting Real Time Updates for an Object

import { PostRepository, subscribeTopic, getPostTopic } from '@amityco/ts-sdk';
import { FC, useEffect, useState } from 'react';

const disposer: Amity.Unsubscriber[] = [];

const GetPost: FC<{ postId: string }> = ({ postId }) => {
  const [post, setPost] = useState<Amity.Post>();

  useEffect(() => {

    const unsubscribePost = PostRepository.getPost(postId, ({ data }) => {
     const { post, loading, error } = data
     
     if (post) {
       /*
       * This step is important if you wish to recieve real time updates
       * Here, you are letting the server know that you wish to recieve real time
       * updates regarding this post
       */
       disposers.push(subscribeTopic(getPostTopic(post)))
       
       setPost(post)
     }
    });
    
    disposers.push(unsubscribePost);
  }, [postId]);

  return null;
};

Getting the object only once

import { PostRepository } from '@amityco/ts-sdk';
import { FC, useEffect, useState } from 'react';

const GetPostOnce: FC<{ postId: string }> = ({ postId }) => {
  const [post, setPost] = useState<Amity.Post>();

  useEffect(() => {
    const unsubscribePost = PostRepository.getPost(postId, ({ data }) => {
     const { post, loading, error } = data
     
     if (post) {       
       setPost(post)
     }
    });
    
    unsubscribePost()
  }, [postId]);

  return null;
};

Live Collection

Although live collections were introduced prior to v6. All query methods for collection of objects (example getPosts) will now return a subscribe-able collection.

This means that if an object in the collection gets updated and you have subscribed to real time events, the collection will get updated automatically via real time events.

If for your use case you don't require any real time updates, you can unsubscribe immediately. Similar to live objects above. For further information about Live Object, please visit #live-collection page.

Getting Real Time updates for a collection

import {
  PostRepository,
  subscribeTopic,
  getUserTopic,
  getCommunityTopic,
  SubscriptionLevels,
} from '@amityco/ts-sdk';
import { FC, useEffect, useState } from 'react';

const disposers: Amity.Unsubscriber[] = [];

const GetPosts: FC<{ targetId: string; targetType: string }> = 
({ targetId, targetType }) => {
  const [posts, setPosts] = useState<Amity.Post[]>();

  useEffect(() => {
    const unsubscribe = PostRepository.getPosts(
      { targetId, targetType },
      ({ data: posts, onNextPage, hasNextPage, loading, error }) => {
        setPosts(posts);
        /*
         * this is only required if you want real time updates for each
         * post in the collection
         */
        subscribePostTopic(targetType, targetId);
      },
    );

    disposers.push(unsubscribe);

    return () => {
      disposers.forEach(fn => fn());
    };
  });

  return null;
};

const subscribePostTopic = (targetType: string, targetId: string) => {
  if (isSubscribed) return;

  if (targetType === 'user') {
    const user = {} as Amity.User; // use getUser to get user by targetId
    disposers.push(
      subscribeTopic(getUserTopic(user, SubscriptionLevels.POST), () => {
        // use callback to handle errors with event subscription
      }),
    );
    return;
  }

  if (targetType === 'community') {
    // use getCommunity to get community by targetId
    const community = {} as Amity.Community; 
    disposers.push(
      subscribeTopic(getCommunityTopic(community, SubscriptionLevels.POST), () => {
        // use callback to handle errors with event subscription
      }),
    );
  }
};

Getting paginated collection without and real time updates

import {
  PostRepository,
  subscribeTopic,
  getUserTopic,
  getCommunityTopic,
  SubscriptionLevels,
} from '@amityco/ts-sdk';
import { FC, useEffect, useState } from 'react';

const GetPosts: FC<{ targetId: string; targetType: string }> = 
({ targetId, targetType }) => {
  const [posts, setPosts] = useState<Amity.Post[]>();

  useEffect(() => {
    const unsubscribe = PostRepository.getPosts(
      { targetId, targetType },
      ({ data: posts, onNextPage, hasNextPage, loading, error }) => {
        if (posts)
          setPosts(posts);
        
        // to get next page use onNextPage()
      },
    );

    unsubscribe()
  });

  return null;
};

Introducing Repositories

Starting from 6.0.0, you will no longer be able to import individual SDK API's. You'll need to import the required API from it's respective Repositories.

Client

import { Client } from '@amityco/ts-sdk

Method

Changed To

createClient

Client.createClient

connectClient

Client.login

disconnectClient

Client.logout

subscribeTopic

Client.SubscribeTopic

UserRepository

import { UserRepository } from '@amityco/ts-sdk

Method

Changed To

Type

liveUser

UserRepository.getUser

Live Object

liveUsers

UserRepository.getUsers

Live Collection

updateUser

UserRepository.updateUser

createReport

UserRepository.flagUser

deleteReport

UserRepository.unFlagUser

liveFollowers

UserRepository.Relationship.getFollowers

Live Collection

liveFollowings

UserRepository.Relationship.getFollowings

Live Collection

liveFollowInfo

UserRepository.Relationship.getFollowInfo

Live Object

acceptFollower

UserRepository.Relationship.acceptFollower

declineFollower

UserRepository.Relationship.declineFollower

UserRepository.Relationship.follow

unfollow

UserRepository.Relationship.unfollow

FileRepository

import { FileRepository } from '@amityco/ts-sdk

Method

Changed To

getFile

FileRepository.getFile

deleteFile

FileRepository.deleteFile

ReactionRepository

import { ReactionRepository } from '@amityco/ts-sdk

Method

Changed To

Type

queryReactions

ReactionRepository.getReactions

Live Collection

addReaction

ReactionRepository.addReaction

removeReaction

ReactionRepository.removeReaction

CommunityRepository

import { CommunityRepository } from '@amityco/ts-sdk

Method

Changed To

Type

createCommunity

CommunityRepository.createCommunity

joinCommunity

CommunityRepository.joinCommunity

leaveCommunity

CommunityRepository.leaveCommunity

liveCommunity

CommunityRepository.getCommunity

Live Object

liveCommunities

CommunityRepository.getCommunities

Live Collection

updateCommunity

CommunityRepository.updateCommunity

liveCommunityMembers

CommunityRepository.Membership.getMembers

Live Collection

addCommunityMembers

CommunityRepository.Membership.addMembers

removeCommunityMembers

CommunityRepository.Membership.removeMembers

addCommunityMemberRoles

CommunityRepository.Membership.addRoles

removeCommunityMemberRoles

CommunityRepository.Membership.removeRoles

liveCategories

CommunityRepository.getCategories

Live Collection

deleteCommunity

CommunityRepository.deleteCommunity

getRecommendedCommunities

CommunityRepository.getRecommendedCommunities

getTopTrendingCommunities

CommunityRepository.getTopTrendingCommunities

StreamRepository

import { StreamRepository } from '@amityco/ts-sdk

Method

Changed To

getStream

StreamRepository.getStream

queryStreams

StreamRepository.getStreams

createStream

StreamRepository.createStream

PostRepository

import { PostRepository } from '@amityco/ts-sdk

Method

Changed To

Type

createPost

PostRepository.createPost

updatePost

PostRepository.updatePost

deletePost

PostRepository.deletePost

livePost

PostRepository.getPost

Live Object

livePosts

PostRepository.getPosts

Live Collection

approvePost

PostRepository.approvePost

declinePost

PostRepository.declinePost

CommentRepository

import { CommentRepository } from '@amityco/ts-sdk

Method

Changed To

Type

createComment

CommentRepository.createComment

updateComment

CommentRepository.updateComment

deleteComment

CommentRepository.deleteComment

liveComment

CommentRepository.getComment

Live Object

liveComments

CommentRepository.getComments

Live Collection

PollRepository

import { PollRepository } from '@amityco/ts-sdk

Method

Changed To

createPoll

PollRepository.createPoll

closePoll

PollRepository.closePoll

getPoll

PollRepository.getPoll

votePoll

PollRepository.votePoll

deletePoll

PollRepository.deletePoll

ChannelRepository

import { ChannelRepository } from '@amityco/ts-sdk

Method

ChangedTo

Type

createChannel

ChannelRepository.createChannel

liveChannel

ChannelRepository.getChannel

Live Object

liveChannels

ChannelRepository.getChannels

Live Collection

joinChannel

ChannelRepository.joinChannel

leaveChannel

ChannelRepository.leaveChannel

addChannelMembers

ChannelRepository.Membership.addMembers

removeChannelMembers

ChannelRepository.Membership.removeMembers

getChannelMembers

ChannelRepository.Membership.getMembers

Live Collection

MessageRepository

import { MessageRepository } from '@amityco/ts-sdk

Method

Changed To

Type

createMessage

MessageRepository.createMessage

updateMessage

MessageRepository.updateMessage

deleteMessage

MessageRepository.deleteMessage

liveMessage

MessageRepository.getMessage

Live Object

liveMessages

MessageRepository.getMessages

Live Collection

Android SDK v6.0.0 Migration Guide

This guide is to provide information about breaking changes and how to migrate to the AmitySDK Android 6.0.0 version.

Live Objects / Live Collections Changes

As announced here, Deprecation announcements, this version replaces PagedList and RxJava2 with PagingData and RxJava3.

Live capability has been upgraded with RxJava3. Include RxJava3 to your project with this guide, RxJava Getting Started, or use SDK’s extension function to Rx2() to bridge the SDK functions back to RxJava2.

The Paginated collection has been upgraded with PagingData. To consume PaginData, replace Android’s PagedListAdapter with PagingDataAdapter following this guide, Paging V3 migration.

Behaviour Changes

Channel

Create

Channel creation with custom id is no longer supported

Message

Query

Message query from channel is no longer supported. Messages from each channel are migrated to the corresponding channel’s default sub-channel. Refer to Subchannel feature documentation.

StackFromEnd option is no longer supported. To achieve Chat room behaviour, use sortyBy() with the value AmityMessageQuerySortOption.LAST_CREATED and reverse the RecyclerView.

Create

Message creation on the channels is no longer supported. Messages must be created on Subchannels only. Refer to Subchannel feature documentation.

RTE

Automatic subscription to messages on Live and Broadcast channels is no longer supported. To receive real time updates on these channels, explicitly subscribe to the channel. Refer to RTE documentation.

Comment

Create

Comment creation with custom id is no longer supported.

Package Changes

All SDK classes are required to be newly imported into your project as API classes are relocated to com.amity.socialcloud.sdk.api and model classes are relocated to com.amity.socialcloud.sdk.model

Interface Changes

API

AmityChannelRepository

Methods

Changes

Remarks

createChannel()

createChannel(displayName: String)

Channel creation with custom id is no longer supported.

Channel creation requires displayName

fetchChannel(channelId: String)

Removed

Use getChannel(channelId: String) instead

observeChannel(channelId: String)

Removed

Use getChannel(channelId: String) instead

getTotalUnreadCount()

AmityChannel.getDefaultSubChannelUnreadCount()

AmityChannelParticipation

Methods

Changes

Remarks

startReading()

Removed

stopReading()

Removed

AmityChannelMembershipQuery

Methods

Changes

Remarks

query()

Return Flowable<PagingData<X>> instead of Flowable<PagedList<X>>

getPagingData()

Removed

AmityChannelMemberSearch

Methods

Changes

Remarks

query()

Return Flowable<PagingData<X>> instead of Flowable<PagedList<X>>

getPagingData()

Removed

AmityMessageRepository

Methods

Changes

Remarks

createMessage(channelId: String)

createMessage(subChannelId: String)

getMessages(channelId: String)

getMessages(subChannelId: String)

AmityMessageQuery

Methods

Changes

Remarks

query()

Return Flowable<PagingData<X>> instead of Flowable<PagedList<X>>

getPagingData()

Removed

AmityMessageQuery.Builder

Methods

Changes

Remarks

stackFromEnd(stackFromEnd: Boolean)

Removed

Use sortBy(sortOption: AmityMessageQuerySortOption) instead

AmityMessageReactionQuery

Methods

Changes

Remarks

query()

Return Flowable<PagingData<X>> instead of Flowable<PagedList<X>>

getPagingData()

Removed

AmityCoreClient

Methods

Changes

Remarks

setup(apiKey: String, httpEndpoint: String, socketEndpoint: String)

Removed

Use

setup(apiKey: String, endpoint: AmityEndpoint) instead.

For custom endpoint, use AmityEndpoint.CUSTOM()

unregisterDeviceForPushNotification(userId: String)

Removed

Use unregisterDeviceForPushNotification() instead

AmityFileRepository

Methods

Changes

Remarks

uploadAudio(uri : Uri)

Return

Flowable<AmityUploadResult<AmityAudio>> instead of

AmityAudioUploadService.Builder

uploadFile(uri: Uri)

Return

Flowable<AmityUploadResult<AmityFile>> instead of

AmityFileUploadService.Builder

uploadImage(uri: Uri)

Return

Flowable<AmityUploadResult<AmityImage>> instead of

AmityImageUploadService.Builder

uploadVideo(uri: Uri)

Removed

Use uploadVideo(uri: Uri, contentFeedType: AmityContentFeedType) instead

uploadVideo(uri: Uri, contentFeedType: AmityContentFeedType)

Return

Flowable<AmityUploadResult<AmityVideo>> instead of

AmityVideoUploadService.Builder

AmityMyFollowersQuery

Methods

Changes

Remarks

query()

Return Flowable<PagingData<X>> instead of Flowable<PagedList<X>>

getPagingData()

Removed

AmityMyFollowingsQuery

Methods

Changes

Remarks

query()

Return Flowable<PagingData<X>> instead of Flowable<PagedList<X>>

getPagingData()

Removed

AmityUserFollowersQuery

Methods

Changes

Remarks

query()

Return Flowable<PagingData<X>> instead of Flowable<PagedList<X>>

getPagingData()

Removed

AmityUserFollowingsQuery

Methods

Changes

Remarks

query()

Return Flowable<PagingData<X>> instead of Flowable<PagedList<X>>

getPagingData()

Removed

AmityUserQuery

Methods

Changes

Remarks

query()

Return Flowable<PagingData<X>> instead of Flowable<PagedList<X>>

getPagingData()

Removed

AmityUserSearch

Methods

Changes

Remarks

query()

Return Flowable<PagingData<X>> instead of Flowable<PagedList<X>>

getPagingData()

Removed

AmityUserNotification

Methods

Changes

Remarks

setAllowed(isAllowed: Boolean)

Removed

Use enable() or disable() instead

isAllowed

Removed

Use getSettings() instead

AmityUserUpdate

Methods

Changes

Remarks

update()

apply()

AmityCommunityCategoryQuery

Methods

Changes

Remarks

query()

Return Flowable<PagingData<X>> instead of Flowable<PagedList<X>>

getPagingData()

Removed

AmityCommentRepository

Methods

Changes

Remarks

observeComment(commentId: String)

getComment(commentId: String)

createComment(commentId: String)

Removed

Comment creation with custom id is no longer supported

deleteComment(commentId: String)

softDeleteComment(commentId: String)

deleteComment(commentId: String, hardDelete: Boolean)

hardDeleteComment(commentId: String)

AmityCommentReactionQuery

Methods

Changes

Remarks

query()

Return Flowable<PagingData<X>> instead of Flowable<PagedList<X>>

getPagingData()

Removed

AmityCommunityQuery

Methods

Changes

Remarks

query()

Return Flowable<PagingData<X>> instead of Flowable<PagedList<X>>

getPagingData()

Removed

AmityCommunityModeration

Methods

Changes

Remarks

addRole(role: String, userIds: List)

Removed

Use addRoles(role: List<String>), userIds: List<String>)

instead

removeRole(role: String, userIds: List)

Removed

Use removeRoles(role: List<String>), userIds: List<String>)

instead

AmityMembershipQuery

Methods

Changes

Remarks

query()

Return Flowable<PagingData<X>> instead of Flowable<PagedList<X>>

getPagingData()

Removed

AmityCommunityMembershipSearch

Methods

Changes

Remarks

query()

Return Flowable<PagingData<X>> instead of Flowable<PagedList<X>>

getPagingData()

Removed

AmityFeedRepository

Methods

Changes

Remarks

createPost()

Removed

Use equivalent method in AmityPostRepository instead

getPost(postId: String)

Removed

Use equivalent method in AmityPostRepository instead

deletePost(postId: String)

Removed

Use equivalent method in AmityPostRepository instead

reviewPost(postId: String)

Removed

Use equivalent method in AmityPostRepository instead

getReactions(postId: String)

Removed

Use equivalent method in AmityPostRepository instead

getComments(postId: String)

Removed

Use equivalent method in AmityPostRepository instead

AmityPostRepository

Methods

Changes

Remarks

deletePost(postId: String)

softDeletePost(postId: String)

deletePost(postId: String, hardDelete: Boolean)

hardDeletePost(postId: String)

AmityCommunityPostQuery

Methods

Changes

Remarks

query()

Return Flowable<PagingData<X>> instead of Flowable<PagedList<X>>

getPagingData()

Removed

AmityUserPostQuery

Methods

Changes

Remarks

query()

Return Flowable<PagingData<X>> instead of Flowable<PagedList<X>>

getPagingData()

Removed

AmityGlobalFeedQuery

Methods

Changes

Remarks

query()

Return Flowable<PagingData<X>> instead of Flowable<PagedList<X>>

getPagingData()

Removed

AmityCustomRankingGlobalFeedQuery

Methods

Changes

Remarks

query()

Return Flowable<PagingData<X>> instead of Flowable<PagedList<X>>

getPagingData()

Removed

AmityPostReactionQuery

Methods

Changes

Remarks

query()

Return Flowable<PagingData<X>> instead of Flowable<PagedList<X>>

getPagingData()

Removed

AmityStreamRepository

Methods

Changes

Remarks

getStream(streamId: String)

Removed

Use observeStream(streamId: String) instead

AmityStreamQuery

Methods

Changes

Remarks

getStream(streamId: String)

Removed

Use observeStream(streamId: String) instead

Model

AmityChannel

Methods

Changes

Remarks

getUnreadCount()

getDefaultSubChannelUnreadCount()

hasUnreadMention()

hasDefaultSubChannelUnreadMention()

AmityMessage

Methods

Changes

Remarks

getChannelSegment()

getSegment()

getChildrenNumber()

getChildCount()

getUser()

getCreator()

getUserId()

getCreatorId()

AmityComment

Methods

Changes

Remarks

getChildrenNumber()

getChildCount()

getUser()

getCreator()

getUserId()

getCreatorId()

AmityCommunity

Methods

Changes

Remarks

getUser()

getCreator()

getUserId()

getCreatorId()

AmityPost

Methods

Changes

Remarks

getUser()

getCreator()

getUserId()

getCreatorId()

AmityStream

Methods

Changes

Remarks

getUser()

getCreator()