AICC - 移动端SDK开发指南

	allprojects {
		repositories {
			...
			maven { url 'https://jitpack.io' }
		}
	}

    //implementation "com.ti-net.oskit:online:1.4.4" (不再更新)
	implementation 'com.github.ti-net-project:OnlineSDK-Android:1.5.8'

    //如您的应用内从未使用到以下依赖，则需要在app的 build.gradle 文件中添加如下依赖配置
    implementation 'androidx.swiperefreshlayout:swiperefreshlayout:1.0.0'

	api files('libs/online_sdk_1.5.8_release.aar')

-keep class com.tinet.** { *; }

<!--SD卡读写权限，发送文件、保存文件。-->
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>
<!--录音权限，用于录音。-->
<uses-permission android:name="android.permission.RECORD_AUDIO"/>
<!--拍照权限，用于拍照（发送照片）-->
<uses-permission android:name="android.permission.CAMERA"/>

<!-- 安卓11+选择文件进行发送时查看所有文件必须权限  该权限属敏感权限，如有问题请咨询SDK技术支持 -->
<uses-permission android:name="android.permission.MANAGE_EXTERNAL_STORAGE" />
<uses-permission
    android:name="android.permission.MOUNT_UNMOUNT_FILESYSTEMS"
    tools:ignore="ProtectedPermissions" />

        TOSInitOption tOSInitOption = new TOSInitOption();
        tOSInitOption.setAccessId(accessId);
        tOSInitOption.setAccessSecret(accessSecret);
        tOSInitOption.setEnterpriseId(enterpriseId);
        tOSInitOption.setApiUrl(define.getApiUrl());
        tOSInitOption.setOnlineUrl(define.getOnlineUrl());
        tOSInitOption.setDebug(BuildConfig.DEBUG);

        TOSClientKit.initSDK(this, tOSInitOption, new TImageLoader() {
            @Override
            public void loadImage(ImageView imageView, Object uri) {
                // 加载图片,加载图片的略图，合理利用缓存
            }

            @Override
            public void loadImage(ImageView imageView, Object uri, int placeholderImg, int errorImg) {
                // 加载图片,指定加载中的图片资源和加载图片异常资源，加载图片的略图，合理利用缓存
            }

            @Override
            public void loadImage(ImageView imageView, Object uri, int originalWidth, int originalHeight, TImageLoaderListener listener) {
                // 加载图片，指定图片加载的大小，用于需要查看大图或详图

            }

            @Override
            public void loadImage(Context context, Object uri, int originalWidth, int originalHeight, TImageLoaderListener listener) {
                // 加载图片，指定图片加载的大小，用于需要查看大图或详图，且加载控件非ImageView
            }
        });

        TOSConnectOption tOSConnectOption = new TOSConnectOption();
        tOSConnectOption.setVisitorId(id);
        tOSConnectOption.setNickname(nickname);
        tOSConnectOption.setHeadUrl(headerUrl);
        tOSConnectOption.setMobile(phone);
        tOSConnectOption.setAdvanceParams(extraInfo);

        TOSClientKit.connect(tOSConnectOption, new OnlineConnectResultCallback() {
            @Override
            public void onSuccess() {
            //连接成功回调
            }

            @Override
            public void onError(int errorCode, String errorDesc) {
            //连接失败回调
            }
        });

        TOSClientKit.disConnect(false, null);

SessionFragment sessionFragment = new SessionFragment();
sessionFragment.setArguments(getIntent().getExtras());
FragmentManager manager = getSupportFragmentManager();
FragmentTransaction transaction = manager.beginTransaction();
transaction.replace(R.id.container, sessionFragment);
transaction.commitAllowingStateLoss();

       //以下自定义界面为UI配置代码实现
       TCustomizationUI tCustomizationUI = new TCustomizationUI();//自定义UI对象
       tCustomizationUI.sendBubbleBackground = R.drawable.ti_bg_color;//发送端气泡背景
       tCustomizationUI.receiveBubbleBackground = R.drawable.ti_bg_color;//接收端气泡背景
       tCustomizationUI.sendBubbleBackgroundColor = getResources().getColor(R.color.ti_red);//发送端气泡背景颜色
       tCustomizationUI.receiveBubbleBackgroundColor = getResources().getColor(R.color.ti_red);//接收端气泡背景颜色
       //聊天背景颜色
       tCustomizationUI.sessionBackgroundColor = getResources().getColor(R.color.ti_session_func_item_text_color);
       tCustomizationUI.msgTimeColor = getResources().getColor(R.color.ti_guess_text_color);//时间字体文字颜色
       tCustomizationUI.inputAreaBgColor = getResources().getColor(R.color.ti_guess_text_color);//输入区域背景颜色
       //输入区域按住录音按钮文字颜色
       tCustomizationUI.inputAreaVoicePressTextColor = getResources().getColor(R.color.ti_guess_text_color);
       tCustomizationUI.inputBoxHintText = "hint_text";//会话页面输入框hint文案
       tCustomizationUI.chatAvatarRadius = R.dimen.fab_margin;//头像圆角弧度

    	 tCustomizationUI.showVisitorNickname = false;//访客昵称
       tCustomizationUI.showVisitAvatar = false;//访客头像
       tCustomizationUI.showAgentRobotNickname = false;//客服、机器人昵称
       tCustomizationUI.showAgentRobotAvatar = false;//客服、机器人头像
       tCustomizationUI.showVoiceButton = false;//语音按钮


        // : 2022/10/13 以下为配置文本消息含超链接高亮显示规则
        List<TTextPatternRule> tTextPatternRules = new ArrayList<>();
        tTextPatternRules.add(
                new TTextPatternRule(Pattern.compile("这里填正则表达式", Pattern.CASE_INSENSITIVE),//正则Pattern变量,是否忽略大小写可自行修改compile第二个参数
                        Color.parseColor("#1366dc"),//高亮显示颜色int值，可自行修改为所需颜色
                        "phoneNumber"));//类型说明，用于onLinkClick方法内回调messageEventType，区分匹配类型


       TOSClientKitConfig tosClientKitConfig = new TOSClientKitConfig.Builder()
                .setTCustomizationUI(tCustomizationUI)//配置自定义UI
                .setTextHighLightRuleList(tTextPatternRules)//配置文本消息含超链接高亮显示规则数组
                .build();

       TOSClientKit.setTosClientKitConfig(tosClientKitConfig);

TOSClientKit.setOnlineStatusListener(new OnlineMessageManager.OnlineStatusListener() {
            @Override
            public void onStatusChanged(int status) {
                //当前状态
            }
        });

@Override
protected SessionClickListener getListener() {
   return new SessionClickListenerImpl(this){

            @Override
            public void onClick(View itemView, OnlineMessage message) {
                super.onClick(itemView,message);
                //消息点击事件
            }

            @Override
            public void onLinkClick(String url) {
                //super.onLinkClick(url);
                //屏蔽super，可实现自定义超链接点击事件
            }

            /**
            *
            * @param content          点击文本内容
            * @param messageEventType 文本类型
            */
            @Override
            public void onLinkClick(String content, String messageEventType) {
                //可根据messageEventType实现自有业务逻辑
            }

            @Override
            public void videoPlay(String url) {
                super.videoPlay(url);
                //自定义视频播放，如果需要自己实现视频播放，则需要屏蔽super.videoPlay(url);父类的实现方式
            }

            @Override
            public void downloadFile(String url, String name) {
                super.downloadFile(url, name);
               //下载文件回调，屏蔽super可自定义而下载功能
            }

            /**
             *
             * @param permissions
             * @param requestCode
             *   申请语音权限                1661
             *   申请相机权限                1662
             *   申请相机、语音权限 -- 拍摄    1663
             *   申请文件权限 -- 文件         1664
             *
             */
            @Override
            public void onStartRequestPermissionsCallback(@NonNull String[] permissions, int requestCode) {
                super.onStartRequestPermissionsCallback(permissions, requestCode);
                // : 2022/9/19 权限申请回调
                TLogUtils.i("onStartRequestPermissionsCallback:" + requestCode);
            }

        };
    }

 @Override
    protected FuncListener getFuncListener() {
        // 自定义底部功能栏

        return new FuncListenerImpl(this){
            @Override
            public void onFuncClick(Function func) {
                super.onFuncClick(func);
               //拓展面板Item点击回调
            }
        };
    }

ArrayList message = new ArrayList<>();
message.add(new LabeInfo("订单号", "1234567890"));
message.add(new LabeInfo("服务地区", "北京市"));
message.add(new LabeInfo("服务", "满意"));
message.add(new LabeInfo("师傅", "金师傅"));
message.add(new LabeInfo("产品类型", "电子产品"));
message.add(new LabeInfo("师傅电话", "12345678900"));
message.add(new LabeInfo("订单状态", "已完成"));

//更新快捷入口可实时更新至会话窗体
TOSClientKit.updateSessionWindowQuickEntrys(message);

//清空快捷入口数据
TOSClientKit.clearSessionWindowQuickEntrys();

//快捷入口的点击回调
//请继承SessionFragment来实现
@Override
protected LabelListener getLabelListener() {
    return new LabelListenerImpl(this) {
        @Override
        public void onLabelClick(LabeInfo info) {
            super.onLabelClick(info);
            Toast.makeText(requireContext(), info.toString(), Toast.LENGTH_SHORT).show();
        }
    };
}

//定义CardInfo，卡片实体
CardInfo message = new CardInfo();
message.setSubTitle("华为P40麒麟990 5G SoC芯片 5000万超感知徕卡三摄 30倍数字变焦");
message.setDescription("这是商品描述，啦啦啦啦啦啦啦啦啦啦啦啦啦啦啦啦啦啦");
message.setImg(
            "https://img1.baidu.com/it/u=1963848283,2056721126&fm=253&fmt=auto&app=120&f=JPEG?w=500&h=500");
message.setPrice("￥ 100.99");
message.setTime(TimeUtils.getDate(System.currentTimeMillis()));
message.setStatus("已到货");

HashMap<String, String> extraInfo = new HashMap<>();
extraInfo.put("订单号", "1234567890");
extraInfo.put("服务地区", "北京市");
extraInfo.put("服务", "满意");
extraInfo.put("师傅", "金师傅");
extraInfo.put("产品类型", "电子产品");
extraInfo.put("师傅电话", "12345678900");
extraInfo.put("订单状态", "已完成");
message.setExtraInfo(extraInfo);

//传递至会话窗体
intent.putExtra(ChatFragment.ARGS_CARD,message);

    /**
     * 获取当前在线状态
     *
     * @return 0:不在线（会话结束）  1:机器人   2:人工座席
     */
     TOSClientKit.getCurrentOnlineStatus()

    /**
     * 获取当前会话信息
     *
     * @return SessionInfo
     */
     TOSClientKit.getCurrentSessionInfo()

     TOSClientKit.getLastMessageInfo(visitorId, new OnLastMessageResult() {
            @Override
            public void onLastMessage(int unreadCount, String lastMessage) {

            }
        });

    /**
     * 获取SDK版本号
     *
     * @return 版本号字符串
     */
     TOSClientKit.getSDKVersion()

- TOSClientLib.framework(Embed & Sign)
- TOSClientKit.framework(Embed & Sign)
- TOSClient.bundle
- 另外需要增加libc++.tbd来支持c++环境

 Privacy - Camera Usage Description
 Privacy - Microphone Usage Description
 Privacy - Photo Library Additions Usage Description
 Privacy - Photo Library Usage Description

首先在AppDelegate中初始化SDK的Option
TOSInitOption * initOption = [[TOSInitOption alloc] initWithOption:YES
                             apiUrl:@"平台apiUrl"
                          onlineUrl:@"平台onlineUrl"
                           accessId:@"移动端唯一标识，对应座席端渠道ID"
                       accessSecret:@"在座席端管理平台创建渠道时生成"
                       enterpriseId:@"企业ID"
                      advanceParams:@{}];
[[TOSClientKit sharedTOSKit] initSDK:initOption];

TOSConnectOption * connectOption = [[TOSConnectOption alloc] initWithOption:@"用户App的userID"
																	 nickname:@"昵称"
																	 headUrl:@"头像地址"
																	 mobile:@"手机号"
																	 advanceParams:@{}];
[[TOSClientKit sharedTOSKit] connect:connectOption success:^{

    } error:^(TIMConnectErrorCode errCode, NSString * _Nonnull errorDes) {

    } tokenIncorrect:^{

}];

TOSDisConnectOption *disOption = [[TOSDisConnectOption alloc] initWithOption:YES];
[[TIMClient sharedTIMClient] disconnect:disOption success:^{

} error:^(TIMConnectErrorCode errCode, NSString * _Nonnull errorDes) {

}];

// 获取版本号
[TOSClientKit getSDKVersion];

TOSSessionInfoModel *model = [[TOSClientKit sharedTOSKit] getCurrentSessionInfo];

NS_ASSUME_NONNULL_BEGIN

@interface ChatInfoViewController : TOSCustomerChatVC

@end

typedef NS_ENUM(NSUInteger, TinetClickTextMessageEventType) {
    TinetClickEventTypeUrl,					      // 链接
    TinetClickEventTypeOrderNumber,				// 订单号
    TinetClickEventTypePhone，			  	   // 手机号
    TinetClickCommodityCard，						 // 商品卡片
};

/// 文本类型消息中关于链接、商品卡片、订单号和手机号的相关点击回调
/// @param eventType 事件类型
/// @param userInfo  详细信息
- (void)tinet_textMessageClickAction:(TinetClickTextMessageEventType)eventType userInfo:(NSDictionary *)userInfo;

typedef NS_ENUM(NSUInteger, TinetChatStatusType) {
    TinetChatStatusTypeOutline,   // 不在线或结束会话
    TinetChatStatusTypeRobot,     // 机器人在线
    TinetChatStatusTypeOnline,    // 客服在线
};

/// @param status  会话状态
/// 当前会话状态监听
- (void)chatStatusChanged:(TinetChatStatusType)status;

  /**
   未读消息获取
  */
	[[TOSClientKit sharedTOSKit] getUnreadMessage:^(NSString * _Nonnull lastMessage, NSInteger unreadCount) {
        NSLog(@"未读数：%@, 最后一条消息：%@", unreadCount, lastMessage);
    } withError:^(NSString * _Nonnull errorStr) {
        /// 错误提示
    }];

  // 未读数的更新  接收通知
  [[NSNotificationCenter defaultCenter] addObserver:self selector:@selector(unreadMessage:) name:KTOSClientLibLastMessageReceivedNotification object:nil];

/// 初始化
+ (TOSKitCustomInfo *)shareCustomInfo;

/// 快速入口Item的圆角弧度
@property (nonatomic, assign) CGFloat quickEntryItem_cornerRadius;

/// 发送方气泡的颜色
@property (nonatomic, strong) UIColor *senderBubble_backGround;
/// 发送方气泡的圆角弧度
@property (nonatomic, assign) CGFloat senderBubble_cornerRadius;

/// 头像的圆角弧度
@property (nonatomic, assign) CGFloat portrait_cornerRadius;

/// 聊天背景颜色
@property (nonatomic, strong) UIColor *chat_backGround;

/// 快速入口Item的背景颜色
@property (nonatomic, strong) UIColor *quickEntryItem_backgroundColor;

/// 接收方气泡的颜色
@property (nonatomic, strong) UIColor *receiveBubble_backGround;
/// 接收方气泡的圆角弧度
@property (nonatomic, assign) CGFloat receiveBubble_cornerRadius;

/// 快速入口底部的背景颜色
@property (nonatomic, strong) UIColor *quickEntryBottom_backgroundColor;

/// 接收方字体颜色
@property (nonatomic, strong) UIColor *receiveText_Color;

/// 发送方字体颜色
@property (nonatomic, strong) UIColor *senderText_Color;

/// 聊天底部输入中的语音按钮控制
@property (nonatomic, assign) BOOL ChatBox_voiceButton_enable;

/// 聊天底部输入中文本输入框的暗文设置
@property (nonatomic, strong) NSString *ChatBox_textview_placeholder;

/// 聊天底部背景颜色
@property (nonatomic, strong) UIColor *ChatBox_backGroundColor;

/// 聊天底部中线条颜色
@property (nonatomic, strong) UIColor *ChatBox_lineColor;

/// 聊天中显示的时间字体颜色
@property (nonatomic, strong) UIColor *Chat_time_textColor;

/// 启用或关闭客服或机器人昵称的显示
@property (nonatomic, assign) BOOL Chat_tosRobotName_show;

/// 启用或关闭访客昵称的显示
@property (nonatomic, assign) BOOL Chat_visitorName_show;

/// 启用或关闭客服昵称(机器人昵称)UI区域的显示
@property (nonatomic, assign) BOOL Chat_tosRobotName_enable;

/// 启用或关闭访客昵称UI区域的显示
@property (nonatomic, assign) BOOL Chat_visitorName_enable;

/// 启用或关闭客服和机器人头像UI区域的显示
@property (nonatomic, assign) BOOL Chat_tosRobot_portrait_enable;

/// 启用或关闭访客头像UI区域的显示
@property (nonatomic, assign) BOOL Chat_visitor_portrait_enable;

/// 相册展示导航栏中的文字颜色
@property (nonatomic, strong) UIColor *imagePicker_barItemTextColor;

/// 相册展示导航栏中的背景颜色
@property (nonatomic, strong) UIColor *imagePicker_naviBgColor;

/// 吐司提示气泡背景颜色
@property (nonatomic, strong) UIColor *Toast_backGroundColor;

/// 吐司提示中文字颜色
@property (nonatomic, strong) UIColor *Toast_textColor;

/// 语音按钮中文字颜色
@property (nonatomic, strong) UIColor *VoiceButton_textColor;

/// 语音按钮中文字高亮颜色
@property (nonatomic, strong) UIColor *VoiceButton_highlight_textColor;

示例代码：
[TOSKitCustomInfo shareCustomInfo].senderBubble_backGround = [UIColor redColor];

 // TOSClientKitCommodityCardOption 详情见 商品卡片参数说明
  TOSClientKitCommodityCardOption *option = [[TOSClientKitCommodityCardOption alloc] init];
  option.subTitle = @"华为P40麒麟990 5G SoC芯片 5000万超感知徕卡三摄 30倍数字变焦";
  option.descriptions = @"这是商品描述，啦啦啦啦啦啦啦啦啦啦啦啦啦啦啦啦啦啦";
  option.price = @"100.99";
  option.time = @"2022/05/24 18:32";
  option.img = @"https://img2.baidu.com/it/u=3019548648,4204913203&fm=253&fmt=auto&app=138&f=JPEG?w=500&h=500";
  option.status = @"已到货";
  option.extraInfo =
  @[@{@"name": @"订单号", @"value": @"1234567890"},
  @{@"name": @"产品类型", @"value": @"电子产品"},
  @{@"name": @"师傅"   , @"value": @"金师傅"},
  @{@"name": @"服务地区", @"value": @"北京市"},
  @{@"name": @"服务"   , @"value": @"满意"},
  @{@"name": @"师傅电话", @"value": @"12345678900"},
  @{@"name": @"订单状态", @"value": @"已完成"}];

  chatVC.commodityCardOption = option;

chatVC.quickEntryAllItems = @[@"快捷入口1",@"快捷入口2",@"快捷入口3"];

/// 快捷入口的点击回调    index    点击索引从0开始（需要在子类实现这个方法）
- (void)quickEntryItemDidTouchIndex:(NSInteger)index;

TOSKitExtendBoardItemModel类说明

+ (TOSKitChatBoxExtendBoard *)shareChatBoxExtendBoard;
/// 扩展项
@property (nonatomic, strong) NSArray <TOSKitExtendBoardItemModel *>*allItems;

/// 示例代码
TOSKitExtendBoardItemModel *model1 = [[TOSKitExtendBoardItemModel alloc] init];
model1.type = TOSChatBoxExtendBoardTypePhotos;	//除自定义类型外，其他类型不填即为默认UI

TOSKitExtendBoardItemModel *model2 = [[TOSKitExtendBoardItemModel alloc] init];
model2.type = TOSChatBoxExtendBoardTypeTakePicture;

TOSKitExtendBoardItemModel *model3 = [[TOSKitExtendBoardItemModel alloc] init];
model3.type = TOSChatBoxExtendBoardTypeCustom;//类型
model3.title = @"按钮3"; //标题
model3.image = @"image";//图片名称，图片大小：32*32/64*64/96*96
model3.index = 3;       //下标
[TOSKitChatBoxExtendBoard shareChatBoxExtendBoard].allItems = @[model1,model2,model3];

/// 扩展面板，自定义按钮事件 （需要在子类实现这个方法）
- (void)didClinkCustomExtendBoardItemAction:(TOSKitExtendBoardItemModel *)item;