iBotSDK_Android

Requirements

• minSdkVersion 15

---

Download

use Gradle:

   dependencies {
      implementation 'io.github.enliple-ibot:ibotsdk:1.0.0'
   }

or use Maven:

<dependency>
  <groupId>io.github.enliple-ibot</groupId>
  <artifactId>ibotsdk</artifactId>
  <version>1.0.0</version>
  <type>pom</type>
</dependency>

Init and setButton

public class MainActivity extends AppCompatActivity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        LinearLayout buttonLayer = findViewById(R.id.buttonLayer);

        IBotSDK sdk = new IBotSDK(getApplicationContext(), "발급받은 api key");
        sdk.openIBotWithBrowser();
        sdk.setChatActivityOrientation(ActivityInfo.SCREEN_ORIENTATION_PORTRAIT);
        sdk.showIBotButton(MainActivity.this, true, true, IBotChatButton.TYPE_RIGHT_TO_LEFT_EXPANDABLE_BUTTON, "#ffffff", buttonLayer);
    }
}

About Function

public void openIBotWithBrowser() IBot 채팅창을 외부 브라우저로 열고 싶을 경우 설정

public void setChatActivityOrientation(int orientation) IBot 채팅창의 orientation 설정

public void showIBotButton(final Context context, boolean isShow, final boolean isDraggable, int type, String bgColor, ViewGroup view)

• isShow : 버튼을 노출 시키고 싶을 경우 true. 그렇지 않으면 false
• isDraggable : 버튼을 touch and drag가 가능하게 하려면 true. 그렇지 않으면 false
• type : 아래 type 참조
• bgColor : 버튼의 배경 색 ( 버튼 이미지에 투명색이 포함됬을 경우 이를 대체하기 위함 ), 아래 Color 참조
• view : IBot 버튼을 노출시키고 싶은 view (LinearLayout, RelativeLayout etc.)

public void showIBotInBrowser() IBotButton의 클릭 없이 외부 브라우저로 바로 채팅창을 열고 싶을 경우 호출

public void initSDKForCustomButton() iBot Sdk에서 제공하는 버튼이 아닌 사용자 custom button을 통해 iBot을 이용하고 싶을 경우 호출

public void chatClose() iBot 채팅창을 소스상으로 닫고싶을 경우 호출.(0.0.68에서 추가됨)

 IBotSDK sdk = new IBotSDK(getApplicationContext(), "발급받은 api key");
 sdk.showIBotInBrowser();

Type

• IBotChatButton.TYPE_LEFT_TO_RIGHT_EXPANDABLE_BUTTON : 버튼이 화면 오른쪽에 위치하며 확장 영역이 우측에서 좌측으로 늘어남

• IBotChatButton.TYPE_LEFT_TO_RIGHT_EXPANDABLE_BUTTON : 버튼이 화면 왼쪽에 위치하며 확장 영역이 좌측에서 우측으로 늘어남

• IBotChatButton.TYPE_NON_EXPANDABLE_BUTTON : 버튼만 존재하며 확장영역이 나타나지 않음

Color

• 3자리, 6자리 hex code 값 ex) #fff, #ffffff
  • alpha 값이 포함된 8자리 값은 사용 안됨. 만일 alpha 값이 포함될 경우 맨 앞 2자리 삭제 ex) #ffaaaaaa -> #aaaaaa로 적용됨

Callback

• 채팅창으로부터 값을 전달받고싶을 때 사용.

1. 아래와 같이 callback이 포함된 constructor 사용.

IBotSDK sdk = new IBotSDK(UserCustomButtonActivity.this, "발급받은 api key", new IBotSDK.CallbackListener() {
           @Override
           public void onCallback(String str) {
                 // 채팅창으로 부터 넘겨받는 값(str)
           }
       });

2. IBotSDK가 선언된 화면이 destroy 될 때 아래와 같이 unregisterReceiver 호출

       @Override
       public void onDestroy() {
           if ( sdk != null )
               sdk.unregisterReceiver();
           super.onDestroy();
       }

3. callback을사용할 경우 openIBotWithBrowser()를 설정하면 안됨.