ข้ามไปที่เนื้อหา

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

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

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

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

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

Warning

Hive SDK ฟีเจอร์แชทสามารถใช้ได้เฉพาะผู้ใช้ (รวมถึงบัญชีผู้เยี่ยมชม) ที่ได้เข้าสู่ระบบโดยใช้ฟีเจอร์การตรวจสอบสิทธิ์ Hive SDK และได้รับการออก PlayerID

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
    }
}];

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

Note

ในกรณีที่มีการตัดการเชื่อมต่อเครือข่ายชั่วคราวหรือ (เฉพาะ iOS) ในระหว่างการเปลี่ยนจากพื้นหลังไปยังพื้นหน้า SDK จะพยายามเชื่อมต่อกับเครือข่ายโดยอัตโนมัติครั้งหนึ่ง

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

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

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 ด้านล่างนี้คือตัวอย่างโค้ดสำหรับการยกเลิกการเชื่อมต่อแชท

Note

คำขอยกเลิกการเชื่อมต่อแชทจะถูกดำเนินการโดยอัตโนมัติเมื่อบัญชีผู้ใช้แอปออกจากระบบ。

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 ตรวจจับสถานะการเชื่อมต่อและส่งมอบเหตุการณ์การเปลี่ยนแปลงสถานะอย่างต่อเนื่องไปยังแอป สำหรับวิธีการจัดการเหตุการณ์อย่างละเอียด โปรดดูเอกสาร การจัดการเหตุการณ์ > เหตุการณ์การเชื่อมต่อ