UI - NHN Cloud User Guide

Game > Gamebase > iOS Developer's Guide > UI

ImageNotice

You can pop up a notice to users after registering an image to the console.

ImageNotice Example

Show ImageNotices

Show the image notice on the screen.

Required parameter

viewController: ViewController where the image notice is displayed.

Optional parameter

configuration: Can change the image notice settings (e.g. background color) with TCGBImageNoticeConfiguration.
closeCompletion: Informs the user with callback when the entire image notice ends.
schemeEvent: Informs the payload which is registered in the console as callback when clicking the image.

API

+ (void)showImageNoticesWithViewController:(nullable UIViewController *)viewController
                            closeCompletion:(void(^ _Nullable)(TCGBError * _Nullable error))closeCompletion;

+ (void)showImageNoticesWithViewController:(nullable UIViewController *)viewController
                             configuration:(nullable TCGBImageNoticeConfiguration *)configuration
                           closeCompletion:(void(^ _Nullable)(TCGBError * _Nullable error))closeCompletion
                               schemeEvent:(void(^ _Nullable)(NSString * _Nullable payload, TCGBError * _Nullable error))schemeEvent;

ErrorCode

Error	Error Code	Description
TCGB_ERROR_NOT_INITIALIZED	1	Gamebase is not initialized.
TCGB_ERROR_UI_IMAGE_NOTICE_TIMEOUT	6901	Force all popup windows to close due to a timeout while displaying an image notice popup window.
TCGB_ERROR_SERVER_INVALID_RESPONSE	8003	Invalid response is returned from the server.

Example

- (void)showImageNotices {
    void(^closeCompletion)(TCGBError *) = ^(TCGBError *error) {
        // Called when the entire imageNotice is closed.
        NSLog(@"ImageNotices closed");
    };

    void(^schemeEvent)(NSString *, TCGBError *) = ^(NSString *payload , TCGBError *error) {
        // Called when image click event occurred.
        NSLog(@"Image click event occurred : %@", payload);
    };

    [TCGBImageNotice showImageNoticesWithViewController:self configuration:nil closeCompletion:closeCompletion schemeEvent:schemeEvent];
}

Custom ImageNotices

Pops up a customized image notice on the screen. You can use TCGBImageNoticeConfiguration to create a customized image notice.

Example

- (void)showImageNotices {
    void(^closeCompletion)(TCGBError *) = ^(TCGBError *error) {
        // Called when the entire imageNotice is closed.
        NSLog(@"ImageNotices closed");
    };

    void(^schemeEvent)(NSString *, TCGBError *) = ^(NSString *payload , TCGBError *error) {
        // Called when image click event occurred.
        NSLog(@"Image click event occurred : %@", payload);
    };

    TCGBImageNoticeConfiguration *configuration = [[TCGBImageNoticeConfiguration] alloc] init];
    configuartion.backgroundColor = [UIColor colorWithRed:0 green:0 blue:0 alpha:0.5];
    configuartion.timeoutInterval = 5000;
    configuartion.enableAutoCloseByCustomScheme = YES;

    [TCGBImageNotice showImageNoticesWithViewController:self configuration:configuration closeCompletion:closeCompletion schemeEvent:schemeEvent];
}

TCGBImageNoticeConfiguration

Parameter	Values	Description
backgroundColor	UIColor	Image notice background color default: [UIColor colorWithRed:0 green:0 blue:0 alpha:0.5]
timeoutMS	long	Image notice max loading time (in millisecond) default: 5000
enableAutoCloseByCustomScheme	YES or NO	Close all notifications when the custom scheme event occurs, or display next notification default: YES

Close ImageNotices

You can call the closeImageNotices API to terminate all image notices currently being displayed.

API

+ (void)closeImageNoticesWithViewController:(nullable UIViewController *)viewController;

Example

- (void)closeImageNotices {
    [TCGBImageNotice closeImageNoticesWithViewController:self];
}

Terms

Shows the Terms and Conditions specified in the Gamebase Console.

TermsView Example

showTermsView API displays the terms and conditions window in WebView. If you want to create your own terms and conditions window appropriate for the Game UI, call the queryTerms API to load the terms and conditions set in the Gamebase console. If users agree to the terms and conditions, please use the updateTerms API to send the user consent of each item to the Gamebase server.

showTermsView

Shows the terms and conditions window on the screen. If users agree to the terms and conditions, register the user consent data in the server. If users agree to the terms and conditions, calling the showTermsView API again will immediately return the success callback without displaying the terms and conditions window. However, if the Terms and Conditions reconsent requirement has been changed to Required, the terms and conditions window is displayed until users agree again to the terms and conditions.

[Caution]

If you have added user consent for receiving push notification in the terms and conditions, you can create a TCGBPushConfiguration from TCGBDataContainer.

PushConfiguration is nil if the terms and conditions window is not displayed. (If the terms and conditions window is displayed, a valid object is always returned.)

PushConfiguration.pushEnabled value is always true.

If TCGBPushConfiguration is not nil, call [TCGBPush registerPushWithConfiguration:completion:] after login.

Required parameter

viewController: The terms and conditions window is exposed in ViewController.

Optional parameter

configuration: Using TCGBTermsConfiguration, you can change settings such as whether to forcibly display the terms and conditions agreement window.
completion: Uses a callback to inform the user when the terms and conditions window closes after agreeing to it. The TCGBDataContainer object which comes as callback can be converted to TCGBPushConfiguration. The converted object can be used in the registerPush API after login.

API

+ (void)showTermsViewWithViewController:(UIViewController *)viewController
                             completion:(nullable void (^)(TCGBDataContainer * _Nullable dataContainer, TCGBError * _Nullable error))completion;

+ (void)showTermsViewWithConfiguration:(TCGBTermsConfiguration *)configuration
                        viewController:(nullable UIViewController *)viewController
                            completion:(nullable void (^)(TCGBDataContainer * _Nullable dataContainer, TCGBError * _Nullable error))completion;

ErrorCode

Error	Error Code	Description
TCGB_ERROR_NOT_INITIALIZED	1	Gamebase not initialized.
TCGB_ERROR_LAUNCHING_SERVER_ERROR	2001	This error occurs when the items downloaded from the launching server do not have any information about the terms and conditions. This is not a usual case, and you should contact the Gamebase personnel.
TCGB_ERROR_UI_TERMS_ALREADY_IN_PROGRESS_ERROR	6924	The Terms API call has not been completed yet. Please try again later.
TCGB_ERROR_WEBVIEW_TIMEOUT	7002	Timed out while displaying the terms and conditions WebView.
TCGB_ERROR_WEBVIEW_HTTP_ERROR	7003	An HTTP error has occurred while opening the terms and conditions WebView.

Example

- (void)showTermsView {
    void(^completion)(TCGBDataContainer *, TCGBError *) = ^(TCGBDataContainer *dataContainer, TCGBError *error) {
        // Called when the entire termsView is closed.
        NSLog(@"TermsView closed");

        TCGBShowTermsViewResult *showTermsViewResult = [TCGBShowTermsViewResult fromDataContainer:dataContainer];

        // If the TCGBPushConfiguration is not null, 
        // save TCGBPushConfiguration and use it for registerPush after login.
        TCGBPushConfiguration *savedPushConfiguraiton = showTermsViewResult.pushConfiguration;

        // Wheter the TermsUI was displayed.
        BOOL isTermsUIOpened = showTermsViewResult.isTermsUIOpened;
    };

    [TCGBTerms showTermsViewWithViewController:self completion:completion];
}

- (void)afterLogin {
    // Call registerPush with saved TCGBPushConfiguration.
    if (savedPushConfiguration != nil) {
        [TCGBPush registerPushWithPushConfiguration:savedPushConfiguration completion:^(TCGBError* error) {
            ...
        }];
    }
}

TCGBTermsConfiguration

Parameter	Values	Description
forceShow	BOOL	Even after the user agreed to the terms and conditions, forcibly display the terms and conditions window. default: NO

TCGBShowTermsViewResult

Parameter	Values	Description
isTermsUIOpened	BOOL	Indicates whether the terms and conditions window was displayed on the screen.
TCGBPushConfiguration	TCGBPushConfiguration	If you added consent to receive push notifications to the terms and conditions, this parameter has information on whether the user agrees to receive push notifications.

queryTerms

Gamebase displays the terms and conditions with a simple WebView. If you want to create the terms and conditions appropriate for the game UI, call the queryTerms API to download the terms and conditions information set in the Gamebase Console for later use.

Calling it after login also lets you see if the game user has agreed to the terms and conditions.

[Caution]

The required items with TCGBTermsContentDetail.required set to true are not stored in the Gamebase server; therefore, false is always returned for the agreed value.

It is because there is no point in storing the required items since they are always stored as true.

The user consent for receiving the push notification is not stored in the Gamebase server either; therefore, the agreed value is always returned as false.

To see if the user has agreed to receive push, please check the [TCGBPush queryTokenInfoWithCompletion:] API.

If you do not touch the 'Terms and Conditions settings' in the console, TCGB_ERROR_UI_TERMS_NOT_EXIST_FOR_DEVICE_COUNTRY(6922) error occurs when you call the queryTerms API from the device with the country code that is different from the terms and conditions language.

If you complete the 'Terms and Conditions settings' in the console or if TCGB_ERROR_UI_TERMS_NOT_EXIST_FOR_DEVICE_COUNTRY(6922) error occurs, please make sure the terms and conditions are not displayed.

Required parameter

viewController: The top-level ViewController.
completion: Uses a callback to inform users about the API call result. With the TCGBQueryTermsResult that comes as callback, you can acquire the terms and conditions information set in the console.

API

+ (void)queryTermsWithViewController:(UIViewController *)viewController
                          completion:(void (^)(TCGBQueryTermsResult * _Nullable queryTermsResult, TCGBError * _Nullable error))completion;

ErrorCode

Error	Error Code	Description
TCGB_ERROR_NOT_INITIALIZED	1	Gamebase not initialized.
TCGB_ERROR_UI_TERMS_NOT_EXIST_IN_CONSOLE	6921	Terms & conditions information is not registered with the console.
TCGB_ERROR_UI_TERMS_NOT_EXIST_FOR_DEVICE_COUNTRY	6922	Terms & conditions information appropriate for the device's country code is not registered with the console.

Example

- (void)queryTerms {
    void(^completion)(TCGBQueryTermsResult *, TCGBError *) = ^(TCGBQueryTermsResult *queryTermsResult, TCGBError *error) {
        if ([TCGBGamebase isSuccessWithError:error] == YES) {
            int termsSeq = queryTermsResult.termsSeq;
            NSString *termsVersion = queryTermsResult.termsVersion;
            ...    
        } else if (error.code == TCGB_ERROR_UI_TERMS_NOT_EXIST_FOR_DEVICE_COUNTRY) {
            // Another country device.
            // Pass the 'terms and contidions' step
        } else {
            // QueryTerms API Failed.
        }
    };

    [TCGBTerms queryTermsWithViewController:self completion:completion];
}

TCGBQueryTermsResult

Parameter	Values	Description
termsSeq	int	KEY for the entire terms and conditions. This value is required when calling updateTerms API.
termsVersion	String	T&C version. This value is required when calling updateTerms API.
termsCountryType	String	Terms and conditions type. - KOREAN: Korean terms and conditions - GDPR: European terms and conditions - ETC: Other countries' terms and conditions
contents	Array< TCGBTermsContentDetail >	Terms and conditions info

TCGBTermsContentDetail

Parameter	Values	Description
termsContentSeq	int	T&C KEY
name	String	T&C Name
required	BOOL	Whether agreement is required
agreePush	String	Whether to accept advertisement push. - NONE: Do not accept - ALL: Accept all - DAY: Accept push notification during daytime - NIGHT: Accept push notification during night time
agreed	BOOL	User's consent to the terms and conditions
node1DepthPosition	int	Primary item exposure sequence.
node2DepthPosition	int	Secondary item exposure sequence. If none, -1
detailPageUrl	String	Full terms and conditions text URL. Does not require filed if not enabled

updateTerms

If the UI has been created manually with the terms and conditions info downloaded from the queryTerms API, please use the updateTerms API to send the game user's agreement history to the Gamebase server.

It can be used to terminate the agreement to optional terms and conditions as well as to revise the agreed T&C clauses.

[Caution]

Push accept status is not stored in the Gamebase server. Push accept status should be stored by calling the [TCGBPush registerPushWithConfiguration:completion:] API after login.

Required parameter

viewController: The top-level ViewController.
configuration: Information of optional T&C of users who will be registered on the server.

Optional parameter

completion: Registers the information of optional terms and conditions on the server, and notifies user with a callback.

API

+ (void)updateTermsWithViewController:(UIViewController *)viewController
                        configuration:(TCGBUpdateTermsConfiguration *)configuration
                           completion:(nullable void (^)(TCGBError * _Nullable error))completion;

ErrorCode

Error	Error Code	Description
TCGB_ERROR_NOT_INITIALIZED	1	Gamebase not initialized.
TCGB_ERROR_UI_TERMS_UNREGISTERED_SEQ	6923	Unregistered terms and conditions Seq value has been set.
TCGB_ERROR_UI_TERMS_ALREADY_IN_PROGRESS_ERROR	6924	The Terms API call has not been completed yet. Please try again later.

Example

- (void)updateTerms {
    void(^completion)(TCGBError *) = ^(TCGBError *error) {
        if ([TCGBGamebase isSuccessWithError:error] == NO) {
            // UpdateTerms API Failed.
        }
    };

    TCGBTermsContent *termsContent = [TCGBTermsContent termsContentWithTermsContentSeq:12 agreed:YES];

    NSMutableArray *contents = [NSMutableArray array];
    [contents addObject:termsContent];

    TCGBUpdateTermsConfiguration *configuration = [TCGBUpdateTermsConfiguration configurationWithTermsVersion:@"1.2.3" termsSeq:1 contents:contents];

    [TCGBTerms updateTermsWithViewController:self configuration:configuration completion:completion];
}

TCGBUpdateTermsConfiguration

Parameter	Mandatory(M) / Optional(O)	Values	Description
termsVersion	M	String	T&C version. The queryTerms API must be called to pass the downloaded value.
termsSeq	M	int	KEY for the entire terms and conditions. The queryTerms API must be called to pass the downloaded value.
contents	M	Array< TCGBTermsContent >	Info on whether user agrees to the optional terms and conditions

TCGBTermsContent

Parameter	Mandatory(M) / Optional(O)	Values	Description
termsContentSeq	M	int	KEY for optional terms and conditions
agreed	M	BOOL	Info on whether user agrees to optional terms and conditions

isShowingTermsView

Determines whether the terms and conditions window is currently displayed or not.

API

+ (void)isShowingTermsView;

Example

- (void)isShowingTermsView {
    BOOL isShowingTermsView = [TCGBTerms isShowingTermsView];   // YES or NO
}

WebView

Gamebase supports a default WebView.
WebView-related resources (images, html, and others) are included to Gamebase.bundle.

Show WebView

Shows a WebView.

Required Parameters

url: The url delivered as a parameter should be valid.
viewController: WebView is displayed on the ViewController.

Optional Parameters

configuration: Changes WebView layout by using TCGBWebViewConfiguration.
closeCompletion: Notifies users with a callback when a WebView is closed.
schemeList: Specifies the list of customized schemes a user wants.
schemeEvent: Notifies url including customized scheme specified by the schemeList with a callback.

// Show Fullscreen Style WebView
- (void)showFullScreenWebView:(id)sender {
    NSString* urlString = @"https://www.toast.com/";
    void(^closeCompletion)(TCGBError *) = ^(TCGBError *error) {
        NSLog(@"WebView Close Event occured");
    };

    [TCGBWebView showWebViewWithURL:urlString viewController:self configuration:nil closeCompletion:closeCompletion schemeList:nil schemeEvent:nil];

}

Webview Example

Custom WebView

Shows a customized WebView.
Can configure a customzed WebView by using TCGBWebViewConfiguration.

- (void)showFixedOrientationWebView:(id)sender {
    NSString* urlString = @"https://www.toast.com/";
    TCGBWebViewConfiguration* config = [[TCGBWebViewConfiguration alloc] init];

    // Webview is fixed to Landscape mode
    config.orientationMask = TCGBWebViewOrientationLandscapeLeft | TCGBWebViewOrientationLandscapeRight;

    void(^closeCompletion)(TCGBError *) = ^(TCGBError *error) {
        NSLog(@"WebView Close Event occured");
    };

    [TCGBWebView showWebViewWithURL:urlString viewController:self configuration:config closeCompletion:closeCompletion schemeList:nil schemeEvent:nil];
}

// Configure Custom Style Configuration to All TCGBWebView Objects
- (void)configureWebViewStyle {
    // After this method is called, every webview(TCGBWebView) is shown with Landscape mode

    TCGBWebViewConfiguration *config = [[TCGBWebViewConfiguration alloc] init];
    config.orientationMask = TCGBWebViewOrientationLandscapeLeft | TCGBWebViewOrientationLandscapeRight;

    [TCGBWebView sharedTCGBWebView].defaultWebConfiguration = config;
}

Custom Scheme

Can apply scheme to use specific functions on a webpage of Gamebase Webview or change content.

Predefined Custom Scheme

Gamebase has specified following schemes.

scheme	Usage
gamebase://dismiss	Close WebView
gamebase://goback	Go back from WebView
gamebase://getuserid	Show ID of a user who is currently logged-in
gamebase://showwebview?link={URLEncodedURL}	Open the URL of the link parameter with the WebView. URLEncodedURL: Column URL with the WebView. Requires URL decoding.
gamebase://openbrowser?link={URLEncodedURL}	Open the URL of the link parameter with an external browser. URLEncodedURL: Column URL with the WebView. Requires URL decoding.

User Custom Scheme

Can add customized functions by specifying scheme names and blocks in Gamebase.


- (void)setCustomSchemes {
    NSString* urlString = @"https://www.toast.com/";

    void(^closeCompletion)(TCGBError *) = ^(TCGBError *error) {
        NSLog(@"WebView Close Event occured");
    };

    NSArray *schemeList = @[@"mygame://test", @"mygame://opensomebrowser"];

    void(^schemeEvent)(NSString *, TCGBError *error) = ^(NSString *fullUrl, TCGBError *error) {
        if ([TCGBGamebase isSuccessWithError:error] == YES) {
            if ([@"mygame://test" isEqualToString:fullUrl]) {
                NSLog(@"mygame://test scheme event occurred");
            } else if ([@"mygame://opensomebrowser" isEqualToString:fullUrl]) {
                NSLog(@"mygame://opensomebrowser scheme event occurred");
            }
        }
    };

    [TCGBWebView showWebViewWithURL:urlString viewController:self configuration:config closeCompletion:closeCompletion schemeList:schemeList schemeEvent:schemeEvent];
}

TCGBWebViewConfiguration

Parameter	Values	Description
navigationBarTitle	string	Title of WebView
orientationMask	TCGBWebViewOrientationUnspecified	Unspecified
	TCGBWebViewOrientationPortrait	Portrait mode
	TCGBWebViewOrientationPortraitUpsideDown	Reverse portrait
	TCGBWebViewOrientationLandscapeRight	Landscape mode
	TCGBWebViewOrientationLandscapeLeft	Reverse landscape
contentMode	TCGBWebViewContentModeRecommended	Browser recommended by the current platform (default)
	TCGBWebViewContentModeMobile	Mobile browser
	TCGBWebViewContentModeDesktop	Desktop browser
navigationBarColor	UIColor	Color of Navigation Bar default: [UIColor colorWithRed: 0.07 green: 0.36 blue: 0.90 alpha: 1.00]
isBackButtonVisible	YES or NO	Activate or deactivate Go Back Button default: YES
isNavigationBarVisible	YES or NO	Show or hide Navigation Bar default: YES
goBackImagePathForFullScreenNavigation	file name in Gamebase.bundle	Image of Go Back Button
closeImagePathForFullScreenNavigation	file name in Gamebase.bundle	Image of Close Button

[TIP]

In iPadOS 13 or later, WebView is the default desktop mode. You can use the contentMode=TCGBWebViewContentModeMobile setting to switch to the mobile mode.

Close WebView

Close currently displayed WebView by using the following API.

// Close the gamebase web view
- (void)closeWebView:(id)sender {
    [TCGBWebView closeWebView];
}

Open External Browser

Use the following API to open external browsers. The URL sent by parameters must be valid.

// Open the url with Browser
- (void)openWebBrowser:(id)sender {
    NSString* urlString = @"https://www.toast.com/";
    [TCGBWebView openWebBrowserWithURL:urlString];
}

Alert

Shows alerts on the system.

Types of Alert

Provides only one 'OK' button, and its click brings Completion.
Provides only one 'OK' button, which does not provide Completion.

// 1. Alert has completion
- (void)showAlertWithCompletion:(id)sender {
    [TCGBUtil showAlertWithTitle:@"TITLE" message:@"MESSAGE" completion:^{
        NSLog(@"Tapped OK Button.");
    }];
}

// 2. Alert without completion
- (void)showAlertWitoutCompletion:(id)sender {
    [TCGBUtil showAlertWithTitle:@"TITLE" message:@"MESSAGE"];
}

Types of ActionSheet

ActionSheet is provided along with the Cancel button.
On blocks, user's AlerAction can be registered.

// Create ActionSheet [OK, Detail, Cancel]
- (void)showActionSheet {
    NSMutableDictionary<NSString *, void(^)(UIAlertAction *)> *blocks = [NSMutableDictionary dictionary];

    void(^okActionHandler)(UIAlertAction *) = ^(UIAlertAction *action){
        NSLog(@"OK");
    };
    void(^detailActionHandler)(UIAlertAction *) = ^(UIAlertAction *action){
        NSLog(@"Detail");
    };

    // Add AlertAction(Title: "OK", Handler: okActionHandler)
    [blocks setValue:okActionHandler forKey:@"OK"];

    // Add AlertAction(Title: "Detail", Handler: detailActionHandler)
    [blocks setValue:detailActionHandler forKey:@"Detail"];

    [TCGBUtil showActionSheetWithTitle:@"TITLE" message:@"MESSAGE" blocks:blocks];
}

Toast

Displays Android Toast messages, by using the following API.
Simple messages with display time can be set.

- (void)showToastMessage:(id)sender {
    // Show message for 3 seconds  (deprecated API)
    [TCGBUtil showToastWithMessage:@"TOAST MESSAGE" duration:3];

    // Show message for long time (3.5 seconds)
    [TCGBUtil showToastWithMessage:@"TOAST MESSAGE with enum long" length:GamebaseToastLengthLong]; 

    // Show message for short time (2 seconds)
    [TCGBUtil showToastWithMessage:@"TOAST MESSAGE with enum short" length:GamebaseToastLengthShort];
}

Error Handling

Error	Error Code	Description
TCGB_ERROR_UI_IMAGE_NOTICE_TIMEOUT	6901	Timed out while displaying image notice.
TCGB_ERROR_UI_UNKNOWN_ERROR	6999	Unknown error (Undefined error).

Refer to the following document for the entire error codes.
- Entire Error Codes

Game > Gamebase > iOS Developer's Guide > UI
ImageNotice
Show ImageNotices
Custom ImageNotices
Close ImageNotices
Terms
showTermsView
queryTerms
updateTerms
isShowingTermsView
WebView
Show WebView
Close WebView
Open External Browser
Alert
Types of Alert
Types of ActionSheet
Toast
Error Handling

TOP

Game > Gamebase > iOS Developer's Guide > UI

ImageNotice

Show ImageNotices

Required parameter

Optional parameter

Custom ImageNotices

TCGBImageNoticeConfiguration

Close ImageNotices

Terms

showTermsView

Required parameter

Optional parameter

queryTerms

Required parameter

TCGBQueryTermsResult

TCGBTermsContentDetail

updateTerms

Required parameter

Optional parameter

TCGBUpdateTermsConfiguration

TCGBTermsContent

isShowingTermsView

WebView

Show WebView

Required Parameters

Optional Parameters

Custom WebView

Custom Scheme

Predefined Custom Scheme

User Custom Scheme

TCGBWebViewConfiguration

Close WebView

Open External Browser

Alert

Types of Alert

Types of ActionSheet

Toast

Error Handling

Table of Contents