media.showSoftKeyboard - GiGAGenie-ServiceSDK/UserGuide GitHub Wiki

gigagenie.media.showSoftKeyboard

API 설명

  • 소프트 키보드 표시 API
  • 화면에 소프트키보드를 표시함
  • Google GBoard에 최적화되어 있습니다. 다른 키보드 사용시 정상동작하지 않을 수 있습니다.
  • options.mode 값은 optional이나, 1 값을 세팅하여 전달하는 것을 권장함
  • 소프트 키보드에서 수신한 키보드 값은 JavaScript 에서 제공하는 키보드 관련 이벤트로 3rd party 서비스에서 직접 처리해야 함
  • 한글 사용시 keyevent가 발생하지 않기 때문에 onSoftKeyEvent 사용해 웹앱에서 직접 처리해야 함(onSoftKeyEvent API 참고)
  • <input> 태그를 포함하는 요소에 포커스될 경우 자동적으로 SoftKeyboard가 올라오며, 올라온 키보드의 언어 설정은 mode 로 처리하면 됨
    • showFlag 를 false 로 설정하고 mode 를 1 로 설정하면 <input> 요소에 포커싱될 때 한글 키보드가 기본 값으로 보여짐

API 구조

  • function showSoftKeyboard(options,callback)
  • options
    • showFlag: (Boolean, Mandatory) Softkeyboard 표시 여부
    • mode: (Int, Optional) Default keyboard 세팅 값으로 다음 두 값 중 하나의 값을 가질 수 있음
      • 0: 영어 키보드(default)
      • 1: 한글 키보드
    • inputmode: (Int, Optional) 기본 키보드 및 가상 키보드 설정을 변경할 수 있음
      • 0: 기본 키보드(default)
      • 1: 한글 입력을 onSoftKeyEvent로 받는 옵션(사용 후 원복 필요)
  • result_cd
    • 200: 성공
    • 500: 시스템 Error
  • extra: null

사용 예시

// input tag 직접 접근이 불가할 때 사용
var options = {};
options.showFlag = true;
options.mode = 1;
options.inputmode = 1;
gigagenie.media.showSoftKeyboard(options, function (result_cd, result_msg, extra) {
    if (result_cd === 200) {
        console.log("showSoftKeyboard Success..");
    } else {
        console.log("showSoftKeyboard Fail");
    }
});

//기본 키보드 입력 방식으로 원복
var options = {};
options.showFlag = false;
options.mode = 1;
options.inputmode = 0;
gigagenie.media.showSoftKeyboard(options, function (result_cd, result_msg, extra) {
    if (result_cd === 200) {
        console.log("showSoftKeyboard Success..");
    } else {
        console.log("showSoftKeyboard Fail");
    }
});

Copyright ⓒ 2017-2023 kt corp. All rights reserved.

⚠️ **GitHub.com Fallback** ⚠️