OpenIMDocs

Type at least two characters to search titles and routes.

EN

Language

ENEnglishEnglish docs简中简体中文中文文档
Browse SDKs · iOS
SDKsiOSEnterprise

Retrieve room credentials

Retrieve credentials for joining a room by room ID with the OpenIM iOS SDK.

Copy

The parameter name in the public header is groupID, but the selector and underlying implementation both use it as a room ID:

[[OIMManager manager] signalingGetTokenByRoomID:roomID
                                      onSuccess:^(OIMInvitationResultInfo * _Nullable credentials) {
    if (credentials.roomID.length > 0) [self joinMediaRoom:credentials];
}
                                      onFailure:^(NSInteger code, NSString * _Nullable message) {
    [self showCallError:code message:message ?: @"Failed to retrieve room credentials"];
}];

The success callback returns an OIMInvitationResultInfo. A room token is a short-lived sensitive credential. Pass it to the media engine in memory only; do not write it to logs, URLs, analytics events, or persistent storage.