Version: 7.0

短いデータ送信

LINE Planetは、通信中に限られたサイズのデータ（「短いデータ」）をピアに送信できるAPIを提供します。このページでは、通話中に短いデータを送受信する方法について説明します。

対応する通話タイプ	対応するSDKバージョン
1対1通話、グループ通話（カンファレンス）	すべてのバージョン

共通事項

通話タイプに関係なく、短いデータの送信には以下の事項を適用します。

サイズの制限

短いデータを送信するメソッドは、データ自体と、データタイプを引数として受け取ります。データタイプおよびデータの最大サイズは次のとおりです。

データタイプ：100バイト（null終端文字を含む）
データ：800バイト

レート制限

1秒あたり1回の送信のみ許容されます。

短いデータの送信結果を得る

LINE Planetで何度も再試行した後もデータ送信に失敗する場合があります。結果ハンドラーコールバックを使用すると、非同期でデータ送信結果を確認できます。

1対1通話

1対1通話では、次のように短いデータを送受信できます。

短いデータを送信する

通話相手に短いデータを送信するには、PlanetKitCallのsendShortData()を使用します。

func sendShortDataExample(call: PlanetKitCall, type: String, data: String) {
    guard let byteData = data.data(using: .utf8) else {
        print("Failed to convert string to data")
        return
    }

    call.sendShortData(type: type, data: byteData) { reason in
        guard reason == .none else {
            print("sendShortData failed: \(reason)")
            return
        }
        print("sendShortData succeeded: type=\(type), data=\(data)")
    }
}

受信した短いデータを処理する

相手はPlanetKitCallDelegateのdidReceiveShortDataを使用して短いデータを受信できます。

extension CallDelegateExample : PlanetKitCallDelegate {
    ...

    func didReceiveShortData(_ call: PlanetKitCall, dataType: String, data: Data) {
        // This is called when short data is received from the peer.
        if let receivedData = String(data: data, encoding: .utf8) {
            print("Received short data: type=\(dataType), data=\(receivedData)")
        }
        // Write your own code here to handle the received data.
    }
}

グループ通話

グループ通話では、特定のピアまたはすべてのピアに短いデータを送信できます。

特定のピアに短いデータを送信する

特定のピアに短いデータを送信するには、PlanetKitConferenceのsendShortData(peerId:type:data:completion:)を使用します。

func sendShortDataToSpecificPeerExample(conference: PlanetKitConference, peerId: PlanetKitUserId, type: String, data: String) {
    guard let byteData = data.data(using: .utf8) else {
        print("Failed to convert string to data")
        return
    }

    conference.sendShortData(peerId: peerId, type: type, data: byteData) { reason in
        guard reason == .none else {
            print("sendShortData failed: \(reason)")
            return
        }
        print("sendShortData to \(peerId) succeeded: type=\(type), data=\(data)")
    }
}

すべてのピアに短いデータを送信する

すべてのピアに短いデータを送信するには、PlanetKitConferenceのsendShortData(type:data:completion:)を使用します。

func sendShortDataToAllPeersExample(conference: PlanetKitConference, type: String, data: String) {
    guard let byteData = data.data(using: .utf8) else {
        print("Failed to convert string to data")
        return
    }

    conference.sendShortData(type: type, data: byteData) { reason in
        guard reason == .none else {
            print("sendShortData failed: \(reason)")
            return
        }
        print("sendShortData to all peers succeeded: type=\(type), data=\(data)")
    }
}

受信した短いデータを処理する

ピアはPlanetKitConferenceDelegateのdidReceiveShortDataを通じて短いデータを受信できます。

extension ConferenceDelegateExample : PlanetKitConferenceDelegate {
    ...

    func didReceiveShortData(_ conference: PlanetKitConference, senderId: PlanetKitUserId, dataType: String, data: Data) {
        // This is called when short data is received from a peer in the conference.
        if let receivedData = String(data: data, encoding: .utf8) {
            print("Received short data from \(senderId): type=\(dataType), data=\(receivedData)")
        }
        // Write your own code here to handle the received data.
    }
}