You cannot reference an existing group by its name that was specified when the group was created. If you attempt to do so, a new group with the same name will be created.
This topic explains how to reference a group by its URI. You can also use the group ID in a similar way.
In order to reference a group by its URI, get and save it somewhere just after the group is created.
Get and save the URI
When a group is created, save its URI in the location where the logged-in user can access.
In this example, the URI string is saved with the ChatGroupURI key in a KiiObject in the groupChatBucket bucket in the user scope. Instead of a bucket, you can also use OS-dependent storage, such as the shared preferences of Android and NSUserDefaults of iOS.
Retrieve the URI
Retrieve the URI with the ChatGroupURI key for referencing the group.
Reference the group by the URI
Instantiate the KiiGroup object by its URI. The group in the original state can be restored on the client.
Refresh the group
In order to access information such as the group members, refresh the KiiGroup instance to load the group content. For more information, see Object ID and URI.
You do not need to refresh the group if you need only the group URI or ID, for example, to access data in the group scope.
Retrieving a group by URI
The following sample code shows how to reinstantiate a group with its URI.
As you can see in the sample code, you can instantiate the already-existing group by executing the KiiGroup(uri:) method. You will need to execute the refresh(_:) method after the instantiating the group to make it up-to-date.
Retrieving a group by ID
The following sample code shows how to reinstantiate a group with its ID.