การเชื่อมต่อเซิร์ฟเวอร์แชท¶

ฟีเจอร์แชทของ SDK Hive ใช้การสื่อสารด้วย WebSocket กับเซิร์ฟเวอร์แชท Hive ดังนั้น เพื่อใช้ฟีเจอร์แชทของ SDK Hive คุณต้องอ้างอิงไปยังคู่มือด้านล่างเพื่อเชื่อมต่อกับเซิร์ฟเวอร์แชท Hive

คำขอเชื่อมต่อ¶

ในการเชื่อมต่อกับการสนทนา ให้เรียกใช้วิธีการ connect ของคลาส Chat

นี่คือตัวอย่างโค้ดที่ขอการเชื่อมต่อแชท

using hive;

Chat.connect((ResultAPI result) => {
    if (result.isSuccess()) {
        // API Call Success
    }
});

#include "HiveChat.h"

FHiveChat::Connect(FHiveChatOnResultDelegate::CreateLambda([this](const FHiveResultAPI& Result) {
    if (Result.IsSuccess()) {
        // API Call Success
    }
}));

#include <HIVE_SDK_Plugin/HIVE_CPP.h>
using namespace hive;

Chat::connect([=](ResultAPI const & result) {
    if (result.isSuccess()) {
        // API Call Success
    }
});

import com.hive.Chat;
import com.hive.ResultAPI;

Chat.connect(object : Chat.ConnectListener {
    override fun onResult(result: ResultAPI) {
        if (result.isSuccess) {
            // API Call Success
        }
    }
})

import com.hive.Chat;

Chat.connect(result -> {
    if (result.isSuccess()) {
        // API Call Success
    }
});

import HIVEService

ChatInterface.connect { result in
    if result.isSuccess() {
        // API Call Success
    }
}

#import "HIVEService.h"

[HiveChat connectWithHandler:^(HIVEResultAPI * result) {
    if ([result isSuccess]) {
        // API Call Success
    }
}];

คำขอเชื่อมต่อใหม่¶

การเชื่อมต่อแชทอาจถูกตัดการเชื่อมต่อชั่วคราวได้ตามสภาพแวดล้อมเครือข่ายหรือการเปลี่ยนสถานะของแอป

กรณีที่มีการร้องขอการเชื่อมต่อใหม่โดยอัตโนมัติ¶

เมื่อเกิดสถานการณ์ต่อไปนี้ SDK จะเริ่มการเชื่อมต่อใหม่โดยอัตโนมัติ

• กรณีที่การเชื่อมต่อเครือข่ายถูกตัดขาดชั่วคราว
• กรณีที่แอปอยู่ในสถานะ background แล้วกลับสู่ foreground
• กรณีที่การเชื่อมต่อสิ้นสุดลงเนื่องจากความผิดปกติชั่วคราวของเซิร์ฟเวอร์ เป็นต้น

เมื่อเริ่มการเชื่อมต่อใหม่โดยอัตโนมัติ อีเวนต์ OnReconnectStarted จะเกิดขึ้น

การร้องขอการเชื่อมต่อใหม่ด้วยตนเอง¶

หากต้องเชื่อมต่อใหม่ทันทีโดยไม่ต้องรอการเชื่อมต่อใหม่โดยอัตโนมัติ ให้เรียก Chat.reconnect() หากร้องขอการเชื่อมต่อใหม่ภายใน 10 นาทีหลังจากการเชื่อมต่อกับเซิร์ฟเวอร์ซ็อกเก็ตแชทถูกตัด ระบบจะพยายามเข้าร่วมช่องที่เคยเข้าร่วมก่อนหน้านี้อีกครั้งโดยอัตโนมัติ การตอบกลับจะส่งคืนรายการช่องที่เข้าร่วมสำเร็จและรายการช่องที่ล้มเหลว

ตัวอย่างโค้ดสำหรับการร้องขอการเชื่อมต่อใหม่ด้วยตนเอง¶

นี่คือตัวอย่างโค้ดสำหรับการขอการเชื่อมต่อแชทใหม่

using hive;

Chat.reconnect((ResultAPI result, List<String> channelIds, List<String> failChannelIds) => {
    if (result.isSuccess()) {
        // API Call Success
    }
});

#include "HiveChat.h"

FHiveChat::Reconnect(FHiveChatOnReconnectDelegate::CreateLambda([this](const FHiveResultAPI& Result, const TArray<FString>& ChannelIds, const TArray<FString>& FailChannelIds) {
    if (Result.IsSuccess()) {
        // API Call Success
    }
}));

#include <HIVE_SDK_Plugin/HIVE_CPP.h>
using namespace hive;

Chat::reconnect([=](ResultAPI const & result, std::vector<std::string>channelIds, std::vector<std::string>failChannelIds) {
    if (result.isSuccess()) {
        // API Call Success
    }
});

import com.hive.Chat;
import com.hive.ResultAPI;

Chat.reconnect(object : Chat.ReconnectListener {
    override fun onResult(result: ResultAPI, channelIds: ArrayList<String>, failChannelIds: ArrayList<String>) {
        if (result.isSuccess) {
            // API Call Success
        }
    }
})

import com.hive.Chat;

Chat.reconnect(result, channelIds, failChannelIds -> {
    if (result.isSuccess()) {
        // API Call Success
    }
});

import HIVEService

ChatInterface.connect { result, channelIds, failChannelIds in
    if result.isSuccess() {
        // API Call Success
    }
}

#import "HIVEService.h"

[HiveChat reconnectWithHandler:^(HIVEResultAPI * result, NSArray<NSString *> * channelIds,  NSArray<NSString *> * failChannelIds) {
    if ([result isSuccess]) {
        // API Call Success
    }
}];

คำขอการตัดการเชื่อมต่อ¶

เพื่อยกเลิกการเชื่อมต่อแชท ให้เรียกใช้เมธอด disconnect() ของคลาส Chat ด้านล่างนี้คือตัวอย่างโค้ดสำหรับการยกเลิกการเชื่อมต่อแชท

using hive;

Chat.disconnect((ResultAPI result) => {
    if (result.isSuccess()) {
        // API Call Success
    }
});

#include "HiveChat.h"

FHiveChat::Disconnect(FHiveChatOnResultDelegate::CreateLambda([this](const FHiveResultAPI& Result) {
    if (Result.IsSuccess()) {
        // API Call Success
    }
}));

#include <HIVE_SDK_Plugin/HIVE_CPP.h>
using namespace hive;

Chat::disconnect([=](ResultAPI const & result) {
    if (result.isSuccess()) {
        // API Call Success
    }
});

import com.hive.Chat;
import com.hive.ResultAPI;

Chat.disconnect(object : Chat.DisconnectListener {
    override fun onResult(result: ResultAPI) {
        if (result.isSuccess) {
            // API Call Success
        }
    }
})

import com.hive.Chat;

Chat.disconnect(result -> {
    if (result.isSuccess()) {
        // API Call Success
    }
});

import HIVEService

ChatInterface.disconnect(result) {
    if result.isSuccess() {
        // API Call Success
    }
}

#import "HIVEService.h"

[HiveChat disconnectWithHandler:^(HIVEResultAPI * result) {
    if ([result isSuccess]) {
        // API Call Success
    }
}];

ตรวจสอบสถานะการเชื่อมต่อ¶

ตรวจสอบว่าผู้ใช้แอปกำลังเชื่อมต่อกับแชทอยู่หรือไม่ เรียกใช้เมธอด Chat คลาส isConnected

นี่คือตัวอย่างโค้ดเพื่อตรวจสอบสถานะการเชื่อมต่อแชท

using hive;

Boolean isConnected = Chat.isConnected();

#include "HiveChat.h"

bool IsConnected = FHiveChat::IsConnected();

#include <HIVE_SDK_Plugin/HIVE_CPP.h>
using namespace hive;

bool isConnected = Chat::isConnected();

import com.hive.Chat;

val isConnected = Chat.isConnected()

import com.hive.Chat;

Boolean isConnected = Chat.isConnected();

import HIVEService

let isConnected = ChatInterface.isConnected()

#import "HIVEService.h"

bool isConnected = [ChatInterface isConnected];

การจัดการเหตุการณ์การเชื่อมต่อ¶

เซิร์ฟเวอร์ซ็อกเก็ตแชทของแบรนด์ Hive ตรวจจับสถานะการเชื่อมต่อและส่งมอบเหตุการณ์การเปลี่ยนแปลงสถานะอย่างต่อเนื่องไปยังแอป สำหรับวิธีการจัดการเหตุการณ์อย่างละเอียด โปรดดูเอกสาร การจัดการเหตุการณ์ > เหตุการณ์การเชื่อมต่อ