データとメッセージ機能の概要

PlanetKitは、メディアストリーム以外のデータやメッセージを送受信するためのさまざまな機能を提供します。PlanetKitが提供するデータおよびメッセージ機能の特徴は以下のとおりです。機能別の詳細については、リンク先のドキュメントを参照してください。

機能	対応する通話およびユーザータイプ	使用タイミング	使用例
アプリサーバーのデータ	1対1通話（発信者）、グループ通話	コールセットアップ	アプリサーバーのデータは、クライアントがアプリケーションサーバーに転送するデータです。主にアプリケーションで通話に関するモニタリングをする際に活用できます。たとえば、アプリケーションのバージョン別にグループ通話の参加数を分析したい場合は、アプリサーバーのデータにアプリケーションのバージョンを含めて転送するように設計できます。
短いデータ転送	1対1通話（発信者、受信者）、グループ通話	コールセットアップ完了後	短いデータ転送を利用することで、アプリケーションから通話相手に短いメッセージを簡単に送信できます。散発的（例：最短30秒間隔）あるいは特定の条件下において低コストでメッセージやデータを転送したい場合は、短いデータ転送を活用してください。たとえば、グループ通話中にユーザーのステータスメッセージ（離席中／取り込み中）を決められた形式で定期的に通知しようとする状況で便利に使用できます。 ただし、メッセージの長さに制約があるため、長いメッセージを送る必要がある場合は、データセッションの使用を推奨します。また、内部的にトランザクションを管理し、データの転送可否を確認した後に数回再送を試みますが、基本的にはデータ転送の信頼性を提供するわけではありません。
コンテンツ共有	1対1通話（発信者、受信者）、グループ通話	コールセットアップ完了後	コンテンツ共有は、時間の経過と共に変化するデータを通話相手と共有したいときに使用します。 コンテンツ共有を使用して共有したデータが変更されると、共有対象者にイベントが発生します。共有対象のデータは、コンテンツ共有のタイプによって共有対象者各自が持っている場合（一般共有）や、そのルームに1つだけしか存在しない場合があります（排他的共有、ルーム範囲共有）。排他的共有の場合は、コンテンツ共有をリクエストした人だけがデータを修正でき、ルーム範囲での共有の場合は、すべてのグループルームの参加者が修正できます。 コンテンツ共有は、データ更新後に経過した時間を情報として提供します。アプリケーションは、時間の経過によるデータが必要なときにこれを活用できます。たとえば、ある参加者が動画再生（例：YouTubeを一緒に見る）を共有した後、他の参加者が後からそのルームに参加した場合、コンテンツ共有機能が提供する経過時間情報を利用して、現在他の参加者が動画のどの部分を見ているかを把握し、どの時点から再生すべきか分かります。