Group channel

This page explains key functions of group channels in Sendbird UIKit for iOS, consisting of how to list channels, chat in a channel, configure channel settings, create a channel, invite users, and list channel members.

The SBUChannelListViewController is a class that is used to get a channel list view. When there is no connection between the client app and Sendbird server, this class is automatically called and reconnects the two. Once the client app is connected to Sendbird server, the class is called and a list of channels in the client app is displayed. In addition the class handles core features including pagination and real-time updates. All chat services built with Sendbird UIKit begin from the channel list.

In the UIKit, you can build a channel list-based chat service without the need for complicated implementation through the SBUChannelListViewController class. Use the following code to list channels in a view.

Note: You can initialize the SBUChannelListViewController by setting the SBDChannelListQuery object. Otherwise, the default values are used.

// Case 1: Default initialize.
let channelListVC = SBUChannelListViewController()
let naviVC = UINavigationController(rootViewController: channelListVC)
present(naviVC, animated: true)

// Case 2: Using channelListQuery.
let listQuery = SBDGroupChannel.createMyGroupChannelListQuery()
listQuery?.includeEmptyChannel = false
listQuery?.includeFrozenChannel = true

let channelListVC = SBUChannelListViewController(channelListQuery: listQuery)
let naviVC = UINavigationController(rootViewController: channelListVC)
present(naviVC, animated: true)

Note: At this point, you can confirm if the service is working by running your app.

The components of the SBUChannelListViewController class include Header and List. The List is an area where the UITableView shows channel information using the SBUChannelCell. The features of the SBUChannelListViewController include:

To view the image in full screen, click on the

The following table lists a set of customizable properties and methods of the SBUChannelListViewController class.

The SBUStringSet is a set of strings used to compose the screen. You need to modify the stringSet values in advance if you want to make changes to the screen. The stringSet includes:

Note : A set of common strings isn't included in the list. See the StringSet section in the Common resources menu.

The SBUIConSet is a set of icons used to compose the screen. You need to modify the iconSet values in advance if you want to use different icons. The iconSet includes:

• iconActionLeaveLight, iconActionNotificationOffLight, iconActionNotificationOnLight, iconCreate, iconMute

Note : A set of common icons is not included in the list. See the IconSet section in the Common resources menu.

You can subclass and customize the SBDChannelListviewController to enhance the user experience of your app. The overridable methods include:

• viewLifeCycle, SBDConnectionDelegate

Note : We recommend you should fully understand the usage of Sendbird Chat SDK for iOS when subclassing the class. Some actions may not work as expected depending on your customization.

Channel type selector exposes all the available channel types a user can create. If the Supergroup channel feature is turned on for the app, this selector will display channel two types: Group and Supergroup.
Use the isSupportSuperGroupChannel() method of the SBUAvailable class to see what channel types are supported for your application.

To view the image in full screen, click on the

In order to customize the Channel type selector, you need to implement a custom view through the SBUCreateChannelTypeSelectorProtocol and SBUCreateChannelTypeSelectorDelegate classes first.
If you implement the view through the SBUCreateChannelTypeSelectorProtocol class, the SBUChannelListViewController calls the show() and dismiss() actions if necessary. Another way to implement the custom view is to override the showCreateChannelTypeSelector() method.
Once implemented, set the custom view to the createChannelTypeSelector in the SBUChannelListViewController.

The following table lists properties of the SBUCreateChannelTypeSelectorProtocol class.

You can customize an action by overriding the methods of the SBUCreateChannelTypeSelectorDelegate class in the SBUChannelListViewController class.

Note : The didSelectCreateGroupChannel(), didSelectCreateSuperGroupChannel() methods of the SBUCreateChannelTypeSelectorDelegate class calls the showCreateChannel(type:) method. But if you have customized the SBUCreateChannelViewController class, you can implement the custom action by overriding the showCreateChannel(type:) method.

The following table lists properties of the SBUCreateChannelTypeSelectorDelegate class.

The SBUChannelListViewController class uses two of the SBUTheme, which are the SBUChannelCellTheme and the SBUChannelListTheme. The SBUChannelCellTheme is used for the SBUChannelCell while the SBUChannelListTheme is used for all elements of the SBUChannelListViewController but the SBUChannelCell. Theme properties cannot be accessed directly and should be customized only through the SBUTheme. Then you should call the setupStyle() afterwards in order to apply any changes you make through the SBUTheme.

You can customize themes through the SBUTheme.setChannelList as below:

let channelListTheme = SBUChannelListTheme(
    leftBarButtonTintColor: SBUColorSet.primary300
    ...

)

let channelCellTheme = SBUChannelCellTheme(
    backgroundColor: SBUColorSet.background100
    ...

)

SBUTheme.setChannelList(channelListTheme: channelListTheme,
            channelCellTheme: channelCellTheme)

Note : You should call the setupStyle() method to update your user interface.

Themes can be customized through the SBUTheme. It is recommended to change the themes prior to viewController initialization. The following code shows how to customize the elements of the theme.

// Channel list theme.
SBUTheme.channelListTheme.backgroundColor = SBUColorSet.background100

// Channel cell theme.
SBUTheme.channelCellTheme.backgroundColor = SBUColorSet.background100

Note : You should call the setupStyle() method to update your user interface.

The SBUChannelListTheme object has properties used in the SBUChannelListViewController.

The SBUChannelCellTheme object has properties used in the SBUChannelCell.

In the UIKit, you can create a channel through the SBUCreateChannelViewController class with a group of selected users. The class also affects the SBUUserCell class which shows a user list and the user list is organized and displayed according to the setting of pagination. If you don’t have a separate list of users you wish to add to your application, all the users who are using your chat service are displayed in the user list by default.

By default the name and cover image of the channel are also given when the channel is created. The channel will be the list of nickname of channel members, and its cover image will be created using the profileimage of those members.

Note : Simply setting your chat service to be based on the channel list can seamlessly lead users to the Create channel view. Once a new channel is successfully created, a channel view will appear immediately for the user. If the channel type is set during initialization, a new channel is created as the selected type. However, if you create a channel through the createChannel(params:) method with parameters, the channel type information must be set in the parameter again. And, the user who creates a new channel becomes an operator of the channel by default.

You can create a channel by simply calling the SBUCreateChannelViewController class. Use the following code to create a new channel.

let createChannelVC = SBUCreateChannelViewController(type: .group)
let naviVC = UINavigationController(rootViewController: createChannelVC)
present(naviVC, animated: true)

You can also create a channel with a list of users you specifically selected. To do so, an array of SBUUser objects should be injected.

Note : You can convert the SBDUser objects from the Chat SDK to the SBUUser as they are compatible.

Use the following code to create a channel with a preset list of users.

let sbdUser: SBDUser = ...  // Chat SDK's user-related class
let users: [SBUUser] = [
    SBUUser(userId: {USER_ID}),
    SBUUser(userId: {USER_ID2}, nickname: {NICKNAME}, profileUrl: nil),
    SBUUser(userId: {USER_ID3}, nickname: nil, profileUrl: {PROFILE_URL}),
    SBUUser(user: sbdUser),
    ...

]

let createChannelVC = SBUCreateChannelViewController(users: users)
...

// If need to pagination, check below:
createChannelVC.loadNextUserList(reset: false, users: nextPageUsers)

The SBUCreateChannelViewController is composed of a list of users who can be invited to the newly created channel.

To view the image in full screen, click on the

The following table lists the customizable properties and methods of the SBUCreateChannelViewController class.

The SBUStringSet is a set of strings used to compose the screen. You need to modify the stringSet values in advance if you want to make changes to the screen. The stringSet includes:

Note : A set of common string is not included in the list. See the Common resources page's StringSet section.

The SBUIConSet is a set of icons used to compose the screen. You need to modify the iconSet values in advance if you want to use different icons.

Note : A set of common icons is not included in the list. See the Common resources page's IconSet section.

You can subclass and customize the SBUCreateChannelViewController to enhance the user experience of your app. The overridable methods include:

• viewLifeCycle, loadNextUserList()

Note : We recommend you should fully understand the usage of Sendbird Chat SDK for iOS when subclassing the class. Some actions may not work as expected depending on your customization.

You can customize themes through the SBUTheme.setUserList as below:

let userListTheme = SBUUserListTheme(
    navigationBarTintColor: SBUColorSet.background100
    ...

)

let userCellTheme = SBUUserCellTheme(
    backgroundColor: SBUColorSet.background100
    ...

)

SBUTheme.setUserList(userListTheme: userListTheme, userCellTheme: userCellTheme)

Note : You should call the setupStyle() method to update your user interface.

Themes can be customized through the SBUTheme. It is recommended to change the themes prior to the viewController initialization. The following code shows how to customize the elements of the theme.

// user list theme.
SBUTheme.userListTheme.navigationBarTintColor = SBUColorSet.background100

// user cell theme.
SBUTheme.userCellTheme.backgroundColor = SBUColorSet.background100

The SBUUserListTheme object has properties used in the following classes: SBUCreateChannelViewController, SBUInviteUserViewController and SBUMemberListViewController.

The SBUUserCellTheme object has properties used in the SBUUserCell.

UIKit allows 1-on-1 and 1-to-N chats through private and public group channels. It also provides a Supergroup channel to facilitate a more stable chat environment for a larger number of users. They can be easily managed without the need for complex implementation.

UIKit supports plain text messages, file messages, and media content such as photos and videos. Once sent, those messages are grouped by time and date, displaying the time by minute. In addition, all messages in open channels are cached using memory, and messages that failed to be sent are only kept within the active channel object.

Note : Simply setting your chat service to be based on the channel list can seamlessly lead users to the Channel view. As for the function that groups messages based on their sent time can be turned on and off through the UsingMessageGrouping property in the SBUGlobals class.

All chat services built with Sendbird UIKit for iOS begin from the channel list. You can build a channel-based chat service by calling the SBUChannelViewController class. It uses the SBUAdminMessageCell, SBUUserMessageCell and SBUFileMessageCell to display information.

The SBUChannelViewController class also is in charge of an auto connection to Sendbird server and internal logics to handle core features of UIKit such as pagination and real-time updates.

Note: You can initialize the SBUChannelViewController by setting the ChannelUrl or SBDGroupChannel object. And, if you have own SBDMessageListParams object, please set them together. If not set, it is used as the default value.

Use the following code to enable users to chat in a channel view.

// Case 1: Using channel url.
let channelVC = SBUChannelViewController(channelUrl: {CHANNEL_URL})
let naviVC = UINavigationController(rootViewController: channelVC)
present(naviVC, animated: true)

// Case 2: Using channel object.
let channelVC = SBUChannelViewController(channel: {CHANNEL})
let naviVC = UINavigationController(rootViewController: channelVC)
present(naviVC, animated: true)

// Case 3: Using messageListParams object as well.
let params = SBDMessageListParams()
params.includeMetaArray = true
params.includeReactions = true
let channelVC = SBUChannelViewController(channel: {CHANNEL}, messageListParams: params)
let naviVC = UINavigationController(rootViewController: channelVC)
present(naviVC, animated: true)

// Case 4: Setting a specific timestamp to be the reference point of message retrieval.
let params = SBDMessageListParams()
params.includeMetaArray = true
params.includeReactions = true
let channelVC = SBUChannelViewController(channelUrl: {CHANNEL_URL},
                                        startingPoint: {STARTING_POINT_TIMESTAMP},
                                        messageListParams: params)
let naviVC = UINavigationController(rootViewController: channelVC)
present(naviVC, animated: true)

You can directly take a user to a specific channel from notifications through the SBUMain.moveToChannel(channelUrl:) method. This method is used to find the destination channel to put the user in or even to create one if there is no applicable channel.

// Set it `true` to use based on channel list, false to use based on channel.
let basedOnChannelList = true
SBUMain.moveToChannel(channelUrl: {CHANNEL_URL}, basedOnChannelList: basedOnChannelList)

The components of the SBUChannelViewController class include Header, List, and messageInput. The List is an area where the UITableView displays messages in the channel using the SBUUserMessageCell, SBUFileMessageCell, and SBUAdminMessageCell.

To view the image in full screen, click on the

The features of the SBUChannelViewController class include:

The following table lists a set of customizable properties and methods of the SBUChannelViewController class.

Note : To customize the messageInputView or newMessageInfoView, you should subclass the SBUMessageInputView or SBUNewMessageInfo class, respectively. Also, if the MessageInputView indicates that the channel is frozen or the member is muted in the channel, the channel state can be changed through the setFrozenModeState(_ isFrozen:) or setMutedModeState(_ isMuted:) method of the SBUMessageInputView.
In the case where both Frozen and Muted states coexist in a channel, only the Frozen state will be displayed in the view.

The SBUStringSet is a set of strings used to compose the screen. You need to modify the stringSet values in advance if you want to make changes to the screen. The stringSet includes:

Note : A set of common string is not included in the list. See the StringSet section in the Common resources menu.

The SBUIConSet is a set of icons used to compose the screen. You need to modify the iconSet values in advance if you want to use different icons. The iconSet includes:

• iconCopy, iconEdit, iconInfo, iconNewMessage, iconAdd, iconSend, iconDelivered, iconErrorFilled, iconRead, iconSent, iconSpinnerSmall, iconFileAudio, iconFileDocument, iconGif, iconPlay

Note : A set of common icons is not included in the list. See the IconSet section in the Common resources menu.

You can subclass and customize the SBUChannelViewController to enhance the user experience of your app. The overridable methods include:

• viewLifeCycle, SBUMessageInputViewDelegate, SBUFileViewerDelegate, SBDConnectionDelegate

If you wish to create and implement a custom message cell, you must inherit the SBUBaseMessageCell class. To register your custom message cell to be shown on the List component of the channel view, use the register(customMessageCell:nib:) function.

You can also change a cell's Identifier by overriding the generateCellIdentifier function. By default, the cell's Identifier takes on the name of the class.

Note : We recommend you should fully understand the usage of Sendbird Chat SDK for iOS when subclassing the class. Some actions may not work as expected depending on your customization.

To display messages, the SBUChannelViewController uses two views and three themes. Two views include the SBUBaseMessageCell and the SBUMessageInputView, and three themes are the SBUChannelTheme, SBUMessageCellTheme, and SBUMessageInputTheme in the SBUTheme.

The overall elements of the SBUChannelViewController are managed through the SBUChannelTheme while the SBUBaseMessageCell uses the SBUMessageCellTheme to show messages in the view and the SBUMessageInputView uses the SBUMessageInputThemefor the design of the message input box in the view.

All three themes mentioned above can be customized through the SBUTheme but you should call the setupStyle() afterwards in order to apply any changes you made.

You can customize the channel theme through the SBUTheme.setChannel as below:

Note : You should call the setupStyle() method afterwards in order to apply any changes you made.

let channelTheme = SBUChannelTheme(
    navigationBarTintColor: SBUColorSet.primary300
    ...

)

let messageCellTheme = SBUMessageCellTheme(
    backgroundColor: SBUColorSet.background100
    ...

)

let messageInputTheme = SBUMessageInputTheme(
    backgroundColor: SBUColorSet.background100
    ...

)

SBUTheme.setChannel(channelTheme: channelTheme,
        messageCellTheme: messageCellTheme,
        messageInputTheme: messageInputTheme)

Themes can be customized through the SBUTheme. It is recommended to change the themes prior to viewController initialization. The following code shows how to customize the elements of the theme.

Note : You should call the setupStyle() method afterwards in order to apply any changes you made.

// Channel theme.
SBUTheme.channelTheme.backgroundColor = SBUColorSet.background100
...

// Message cell theme.
SBUTheme.messageCellTheme.backgroundColor = SBUColorSet.background100
...

// Message input theme.
SBUTheme.messageInputTheme.backgroundColor = SBUColorSet.background100
...

The SBUChannelTheme object has properties used in the SBUChannelViewController.

The SBUMessageInputTheme object has properties used in the SBUChannelViewController.

The SBUMessageCellTheme object has properties used in the SBUChannelViewController.

In the UIKit, you can invite users to a specific group channel or promote a user to an operator of a specific channel according to the type set by the SBUInviteUserViewController class. The ViewController uses the SBUUserCell class to display a list of members except the ones who are already in the channel. The same SBUUserCell class is also used when inviting a user or appoint a user as an operator of a specific group channel.

Unless you have a separate list of users you specifically selected, all users who are registered to your service appear in the user list by default.

Note : Simply setting your chat service to be based on either the channel list, channels, channel settings or member list can seamlessly lead users to the Invite users view. For the view, you can set inviteUserType to use the desired function among user invitation and promote to operator then initializing the SBUInviteUserViewController class.

Invite users to a group channel with a simple implementation through the SBUInviteUserViewController class.

Note : You can initialize the SBUInviteUserViewController class by setting the ChannelUrl or SBDGroupChannel object.

Use the following code to invite a user to a channel.

// Case 1.1: Invite user using channel url.
let inviteUserVC = SBUInviteUserViewController(channelUrl: {CHANNEL_URL}, type: .users)
let naviVC = UINavigationController(rootViewController: inviteUserVC)
present(naviVC, animated: true)

// Case 1.2: Invite user using channel object.
let inviteUserVC = SBUInviteUserViewController(channel: {CHANNEL}, type: .users)
let naviVC = UINavigationController(rootViewController: inviteUserVC)
present(naviVC, animated: true)

// Case 2.1: Promote user to operator using channel url.
let promoteVC = SBUInviteUserViewController(channelUrl: {CHANNEL_URL}, type: .operators)
let naviVC = UINavigationController(rootViewController: promoteVC)
present(naviVC, animated: true)

// Case 2.2: Promote user to operator using channel object.
let promoteVC = SBUInviteUserViewController(channel: {CHANNEL}, type: .operators)
let naviVC = UINavigationController(rootViewController: promoteVC)
present(naviVC, animated: true)

You can also invite a list of users you specifically selected. To do so, an array of SBUUser objects should be injected.

Note : You can convert the SBDUser objects from the Chat SDK to the SBUUser as they are compatible.

Use the following code to invite a list of users you specifically selected to a channel.

let users: [SBUUser] = [
    SBUUser(userId: {USER_ID}),
    SBUUser(userId: {USER_ID2}, nickname: {NICKNAME}, profileUrl: nil),
    SBUUser(userId: {USER_ID3}, nickname: nil, profileUrl: {PROFILE_URL}),
    ...

]

let inviteUserVC = SBUInviteUserViewController(channel: {CHANNEL}, users: users)
...

// If need to pagination, add the nextUserList using the code below:
inviteUserVC.loadNextUserList(reset: false, users: nextPageUsers)

The SBUInviteUserViewController is composed of a list of users who can be invited to existing channels.

To view the image in full screen, click on the

The following table lists the customizable properties and methods of the SBUInviteUserViewController class.

The SBUStringSet is a set of strings used to compose the screen. You need to modify the stringSet values in advance if you want to make changes to the screen. The stringSet includes:

Note : A set of common strings isn't included in the list. See the StringSet section in the Common resources menu.

The SBUIConSet is a set of icons used to compose the screen. You need to modify the iconSet values in advance if you want to use different icons.

Note : A set of common icons is not included in the list. See the IconSet section in the Common resources menu.

You can subclass and customize the SBUInviteUserViewController to enhance the user experience of your app. The overridable methods include:

• viewLifeCycle, loadNextUserList()

Note : We recommend you should fully understand the usage of Sendbird Chat SDK for iOS when subclassing the class. Some actions may not work as expected depending on your customization.

You can customize themes through the SBUTheme.setUserList as below:

let userListTheme = SBUUserListTheme(
    navigationBarTintColor: SBUColorSet.background100
    ...

)

let userCellTheme = SBUUserCellTheme(
    backgroundColor: SBUColorSet.background100
    ...

)

SBUTheme.setUserList(userListTheme: userListTheme, userCellTheme: userCellTheme)

Note : You should call the setupStyle() method to update your user interface.

Themes can be customized through the SBUTheme class. It is recommended to change the themes prior to the viewController initialization. The following code shows how to customize the elements of the theme.

// User list theme.
SBUTheme.userListTheme.navigationBarTintColor = SBUColorSet.background100

// User cell theme.
SBUTheme.userCellTheme.backgroundColor = SBUColorSet.background100

Note : You should call the setupStyle() method to update your user interface.

The SBUUserListTheme object has properties used in the following classes: SBUCreateChannelViewController, SBUInviteUserViewController and SBUMemberListViewController.

The SBUUserCellTheme object has properties used in the SBUUserCell.

In UIKit, you can retrieve the list of members in a specific group channel through the SBUMemberListViewController class. This class displays a list of channel members, operators, muted members, and banned members using the SBUUserCell class.

Note : Simply setting your chat service to be based on either the channel list, channels, or channel settings can seamlessly lead users to the Member list view.

You can get the list of members in a specific channel by simply calling the SBUMemberListViewController class.

Note : You can initialize the SBUMemberListViewController class by setting a ChannelUrl, SBDGroupChannel or ChannelMemberListType object.

Use the following code to get the member list of a channel.

// Case 1: Using channel url.
let memberListVC = SBUMemberListViewController(channelUrl: {CHANNEL_URL}, type: .channelMembers)
let naviVC = UINavigationController(rootViewController: memberListVC)
present(naviVC, animated: true)

// Case 2: Using channel object.
let memberListVC = SBUMemberListViewController(channel: {CHANNEL}, type: .channelMembers)
let naviVC = UINavigationController(rootViewController: memberListVC)
present(naviVC, animated: true)

The SBUMemberListViewController is composed of different types of member list.

To view the image in full screen, click on the

Note: The Add button on the top right is displayed only when ChannelMemberListType is .channelMembers or .operators.

The following table lists the customizable properties and method of the SBUMemberListViewController class.

The SBUStringSet is a set of strings used to compose the screen. You need to modify the stringSet values in advance if you want to make changes to the screen. The stringSet includes:

Note : A set of common strings isn't included in the list. See the StringSet section in the Common resources menu.

The SBUIConSet is a set of icons used to compose the screen. You need to modify the iconSet values in advance if you want to use different icons.

Note : A set of common icons is not included in the list. See the IconSet section in the Common resources menu.

You can subclass and customize the SBUMemberListViewController to enhance the user experience of your app. The overridable methods include:

• viewLifeCycle, onClickInviteUser()

Note : We recommend you should fully understand the usage of Sendbird Chat SDK for iOS when subclassing the class. Some actions may not work as expected depending on your customization.

You can customize themes through the SBUTheme.setUserList as below:

Note : You should call the setupStyle() method afterwards in order to apply any changes you made.

let userListTheme = SBUUserListTheme(
    navigationBarTintColor: SBUColorSet.background100
    ...

)

let userCellTheme = SBUUserCellTheme(
    backgroundColor: SBUColorSet.background100
    ...

)

SBUTheme.setUserList(userListTheme: userListTheme, userCellTheme: userCellTheme)

Themes can be customized through the SBUTheme. It is recommended to change the theme prior to the viewController initialization. The following code shows how to customize the elements of the theme.

Note : You should call the setupStyle() method afterwards in order to apply any changes you made.

// User list theme.
SBUTheme.userListTheme.navigationBarTintColor = SBUColorSet.background100

// User cell theme.
SBUTheme.userCellTheme.backgroundColor = SBUColorSet.background100

The SBUUserListTheme object has properties used in the following classes: SBUCreateChannelViewController, SBUInviteUserViewController and SBUMemberListViewController.

The SBUUserCellTheme object has properties used in the SBUUserCell.

You can manage channels and members in the UIKit through the SBUModerationsViewController class. This class enables you to compose a management menu for operators, muted members, and banned members and change the freeze state of a channel.
The class also contains the moderation feature that can be used by a channel operator.

Note : By default, the channel moderation menu in the Channel settings view is activated for operators only.

Configure the channel moderation tools through a simple implementation of the SBUModerationsViewController class.

// Case 1: Using channel url.
let moderationVC = SBUModerationsViewController(channelUrl: {CHANNEL_URL})
let naviVC = UINavigationController(rootViewController: moderationVC)
present(naviVC, animated: true)

// Case 2: Using channel object.
let moderationVC = SBUModerationsViewController(channel: {CHANNEL})
let naviVC = UINavigationController(rootViewController: moderationVC)
present(naviVC, animated: true)

Note : You can initialize the SBUModerationsViewController class by setting a ChannelUrl or SBDGroupChannel object.

The SBUModerationsViewController class is composed of items that are required to manage a channel and its members, such as freezing a channel or banning members.

To view the image in full screen, click on the

The following table lists a set of customizable methods of the SBUModerationsViewController class.

The SBUStringSet is a set of strings used to compose the screen. You need to modify the stringSet values in advance if you want to make changes to the screen. The stringSet includes:

Note : A set of common strings isn't included in the list. See the StringSet section in the Common resources menu.

The SBUIConSet is a set of icons used to compose the screen. You need to modify the iconSet values in advance if you want to use different icons. The iconSet includes:

• iconOperator, iconMuted, iconBanned, iconFreeze

Note : A set of common icons is not included in the list. See the IconSet section in the Common resources menu.

You can subclass and customize the SBUModerationsViewController class to enhance the user experience of your app. The overridable methods include:

• viewLifeCycle

Note : We recommend you fully understand the usage of Sendbird Chat SDK for iOS when subclassing the class. Some actions may not work as expected depending on your customization.

You can customize the channelSettingsTheme through the SBUTheme.setChannelSetting(channelSettingsTheme:) method as below:

let settingsTheme = SBUChannelSettingsTheme(
    navigationBarTintColor: SBUColorSet.background100
    ...
)
SBUTheme.setChannelSettings(channelSettingsTheme: settingsTheme)

Note : You should call the setupStyle() method to update your user interface. Both the SBUModerationsViewController and SBUChannelSettingsViewController class use SBUTheme.channelSettingsTheme.

Themes can be customized through the SBUTheme. It is recommended to change the themes prior to viewController initialization. The following code shows how to customize the elements of the theme.

// Setting a theme.
SBUTheme.channelSettingsTheme.navigationBarTintColor = SBUColorSet.background100

Note : You should call the setupStyle() method to update your user interface.

The SBUChannelSettingsTheme object shares some of the properties contained in the SBUModerationsViewController.

In UIKit, you can search for messages within the SBUChannelViewController through the Search in Channel menu in the SBUChannelSettingsViewController. This will present a SBUMessageSearchViewController, which handles message search and displays the search results. Clicking on the result takes you to a new instance of SBUChannelViewController which features the message selected from the search results, with the keyword highlighted.

You can create and present the SBUMessageSearchViewController as follows.

let searchVc = SBUMessageSearchViewController(channel: GROUP_CHANNEL)
self.present(UINavigationController(rootViewController: searchVc), animated: true, completion: nil)

The SBUMessageSearchViewController is composed of items that enable message search, such as a search bar and a list of search results.

To view the image in full screen, click on the

The following table lists the customizable properties and methods of the SBUMessageSearchViewController class.

The SBUMessageSearchViewController class uses two of the SBUTheme, which are the SBUMessageSearchTheme and the SBUMessageSearchResultCellTheme. The SBUMessageSearchTheme is used for the elements of the SBUMessageSearchViewController while the SBUMessageSearchResultCellTheme is used for the SBUMessageSearchResultCell.

Theme properties cannot be accessed directly and should be customized only through the SBUTheme. Then you should call the setupStyle() afterwards in order to apply any changes you make through the SBUTheme.

The SBUMessageSearchTheme object has properties used in the SBUMessageSearchViewController.

The SBUMessageSearchResultCellTheme object has properties used in the SBUMessageSearchResultCell.

In the UIKit, you can display and configure channels through the SBUChannelSettingsViewController class. In the class, you can edit the name and cover image of a channel, change notification status, check the number and list of members in the channel, and leave the specific channel. Also, the moderation menu will be activated if there is an operator in the channel.

Note : Simply setting your chat service to be based on either the channel list or channel can seamlessly lead users to the channel settings view.

Configure channel settings without complicated implementation through the SBUChannelSettingsViewController class.

// Case 1: Using channel url.
let channelSettingsVC = SBUChannelSettingsViewController(channelUrl: {CHANNEL_URL})
let naviVC = UINavigationController(rootViewController: channelSettingsVC)
present(naviVC, animated: true)

// Case 2: Using channel object.
let channelSettingsVC = SBUChannelSettingsViewController(channel: {CHANNEL})
let naviVC = UINavigationController(rootViewController: channelSettingsVC)
present(naviVC, animated: true)

Note : You can initialize the SBUChannelSettingsViewController class by setting the ChannelUrl or SBDGroupChannel object.

The SBUChannelSettingsViewController is composed of channel configurations and channel information. The components and features of the SBUChannelSettingsViewController class include:

To view the image in full screen, click on the

Note : The screen shot on the left is the screen visible to general members while the one on the right is visible to operators.

The following table lists a set of customizable properties and methods of the SBUChannelSettingsViewController class.

The SBUStringSet is a set of strings used to compose the screen. You need to modify the stringSet values in advance if you want to make changes to the screen. The stringSet includes:

Note : A set of common icons is not included in the list. See the StringSet section in the Common resources menu.

The SBUIConSet is a set of icons used to compose the screen. You need to modify the iconSet values in advance if you want to use different icons. The iconSet includes:

• iconLeave, iconMembers, iconNotifications, iconShevronRight

Note : A set of common icons is not included in the list. See the IconSet section in the Common resources menu.

You can subclass and customize the SBUChannelSettingsViewController to enhance the user experience of your app. The overridable methods include:

• viewLifeCycle

Note : We recommend you should fully understand the usage of Sendbird Chat SDK for iOS when subclassing the class. Some actions may not work as expected depending on your customization.

You can customize the channelSettingsTheme through the SBUTheme.setChannelSetting(channelSettingsTheme:) method as below:

let settingsTheme = SBUChannelSettingsTheme(
    navigationBarTintColor: SBUColorSet.background100
    ...

)

SBUTheme.setChannelSettings(channelSettingsTheme: settingsTheme)

Note : You should call the setupStyle() method to update your user interface.

Themes can be customized through the SBUTheme. It is recommended to change the themes prior to the viewController initialization. The following code shows how to customize the elements of the theme.

// Setting a theme.
SBUTheme.channelSettingsTheme.navigationBarTintColor = SBUColorSet.background100

Note : You should call the setupStyle() method to update your user interface.

The SBUChannelSettingsTheme object has properties used in the SBUChannelSettingViewController.