Customizing the Keyboard (RPC v3.0+)

If you present keyboards in your app – such as in searchable interactions or another custom keyboard – you may wish to customize the keyboard for your users. The best way to do this is through the SDLScreenManager. For more information presenting keyboards, see the Popup Keyboards section.

Setting Keyboard Properties

You can modify the language of the keyboard to change the characters that are displayed.

SDLKeyboardProperties *keyboardConfig = [[SDLKeyboardProperties alloc] init];
keyboardConfig.language = SDLLanguageHeIl; // Set to Israeli Hebrew
keyboardConfig.keyboardLayout = SDLKeyboardLayoutAZERTY; // Set to AZERTY

self.sdlManager.screenManager.keyboardConfiguration = keyboardConfig;

let keyboardConfig = SDLKeyboardProperties()
keyboardConfig.language = .heIl // Set to Israeli Hebrew
keyboardConfig.keyboardLayout = .AZERTY; // Set to AZERTY

sdlManager.screenManager.keyboardConfiguration = keyboardConfig

Other Properties

While there are other keyboard properties available on SDLKeyboardProperties, these will be overridden by the screen manager. The keypressMode must be a specific configuration for the screen manager's callbacks to work properly. The limitedCharacterList, autoCompleteText, and autoCompleteList will be set on a per-keyboard basis in the SDLKeyboardDelegate which is set on the presentKeyboard and presentSearchableChoiceSet methods.