Forem: PubNub [日本語]

アプリコンテキストの使い方

PubNub Developer Relations — Tue, 09 Jul 2024 06:49:29 +0000

PubNubApp Contextは、User、Channel、およびMembership情報のサーバレスストレージメカニズムを提供することで、複雑なリアルタイム機能の開発を簡素化します。 App Contextはデータが変更されるたびにイベントをトリガーし、アプリをリアルタイムで更新できるようにします。また、保存されたデータはIlluminate、Functions、その他のPubNubサービスで使用でき、よりスマートな意思決定を行うことができます。また、BizOps Workspaceを使用することで、コード不要の直感的なインターフェイスでこのデータを管理できます。

アプリコンテキストとは？

アプリコンテキスト（旧称オブジェクト）により、次のことが可能になります：

アプリケーション内のユーザーとチャネル、およびそれらの間の関係に意味を持たせます。
すべてのエンティティのメタデータをサーバーに保存し、クライアントにグローバルな真実のソースを簡単に提供できます。 Userは人間を表す必要はなく、代わりにデバイスのステータスをUserオブジェクトに保存するのが一般的です。
オブジェクトの値が変更されると、即座にリアルタイムのイベントを受け取ることができる。

どんなアプリケーションでも App Context を使用することができますが、チャットソリューションを作成する開発者には特に人気があります。

App Context は、ユーザーとチャンネルに推奨されるフィールドのセットと、それらの間のメンバーシップに推奨されるフィールドを提供します。これらのフィールドのほとんどはオプションなので、どのフィールドを入力するか選択したり、独自のカスタムフィールドを提供することができます。

App Contextの使用例

前述の通り、App Context はチャットソリューションを作成する開発者に特に人気がありますが、様々なユースケースで使用することができます：

チャット：ユーザー情報（名前、プロフィール写真、「休暇中」ステータス、役職）、チャンネル情報（アイコン、説明、視聴者）、ユーザーの役割を保存し、チャンネルごと、ユーザーごとに最後に読まれたメッセージを追跡します。
スポーツ、メディア、エンターテイメントライブ投票、ライブトリビア、リアルタイム入札、商品やプロモーションのCTA（コール・トゥ・アクション）オーバーレイ。
ゲームプレイヤーレベル、獲得ゲーム、バッジを含むリアルタイムのプレイヤー統計、リーダーボードのトラッキングと管理
その他ユーザー不在/アクティブステータス、不正検出のためのユーザー信頼スコア、ユーザー位置追跡、バッテリー残量や最後のセンサー読み取り値などのIoTデバイスステータス

アプリコンテキストを有効にする方法

App Contextは、以下の手順で有効にできます：

管理者ポータルにログインする。
ポータルの左側にある「Apps（アプリ）」タブをクリックします。
アプリケーションをクリックします。このアプリケーションのキーセットページが表示されます。
まだ作成していない場合は、「Create New Keyset」ボタンをクリックして新しいキーセットを作成します。キーセットの設定ページが表示されます。
スライダーをクリックしてApp Contextを有効にします。
Bucket Region（バケット領域）の設定は、データが保存される領域です。キーセットの変更を保存した後は、このリージョンを変更できないことに注意。
User Metadata Eventsと Channel Metadata Eventsの設定が有効な場合、後述するように、データベースにデータが設定または削除されると、ユーザとチャネルのイベントがトリガされます。
メンバーシップ・イベント]設定が有効な場合、後述するように、メンバーシップが追加、更新、または削除されると、メンバーシップ・イベントがトリガされます。
残りのオプションはこの記事の範囲外ですが、詳細についてはApp Contextのドキュメントを参照してください。
Save Changesをクリックして、更新された変更を保存します。

ユーザーアプリコンテキスト

新しいユーザーがあなたのアプリケーションに登録されると、おそらく外部のIDプロバイダを介して、PubNubに対してそのユーザーを一意に識別する何らかの方法があるでしょう。これは、ユーザーのクライアントがPubNub SDKを初期化するために使用するユーザーIDです。 PubNubユーザーIDは、同じユーザーを識別するためにソリューションの他の場所で使用するIDと同じではないかもしれないので、'外部ID'フィールドでそれを追跡しておくことをお勧めします。

User Name、Email、Profile URLは説明の必要はありませんが、App Context内にこれらのフィールドを保持する利点は、ユーザーがこれらのフィールドのいずれかを変更した場合、当社のすべてのSDKでサポートされているApp Contextイベントを使用して、すべてのリスニングクライアントに変更をスケールで伝播できることを意味します。

App ContextでUser representationを作成するには？

App Context Userを作成するには、2つの方法があります。

PubNubの管理ポータル内にあるBizOps Workspaceを使用してユーザーを作成、管理できます。これはコードを必要とせず、別記事で例を挙げてプロセスを説明しています：BizOps Workspaceでユーザーとチャンネルを管理する方法
ユーザを作成するためのAPIは各SDKを通じて公開されています。例えば、チャットSDKの 'createUser()'メソッドは、JavaScriptのsetUUIDMetadataを呼び出してユーザーを作成します。チャットSDK以外のSDKを使用している場合、App Contextデータを変更するための専用APIが提供されています。JavaScriptのsetUUIDMetadataAPIについてはすでに触れましたが、Java、Swift、Kotlin、Python、Unityなど、私たちのすべてのAPIに同等のものがあります。

チャンネルアプリのコンテキスト

PubNubはユーザーがチャンネルを購読または公開するたびに自動的にチャンネルを作成しますが、チャンネルはおそらくアプリケーションにとって意味のあるものを表しています。例えば、チャットアプリでは、通信にチャンネルを使用するグループチャットがあるかもしれませんし、ライブイベントでは投票を管理するために専用のチャンネルを使用するかもしれません。

チャネルに App Context を指定すると、そのチャネルに関連する任意のメタデータが保存・更新され、オプションでその更新がすべての関係クライアントに伝搬されます。チャネルに 'ユーザ A とユーザ B のチャット' などの名前を付けることができ、チャネルがドキュメントの保存に関連している場合は、カスタムの 'URI' フィールドで追跡することができます。

App Contextでチャネルを作成するには？

Usersと同様に、App Context Channelを作成するには2つの方法がある。

チャンネルはBizOps Workspaceを使って作成・管理できる。これはコードを必要とせず、別記事で例を挙げてプロセスを説明している：BizOps Workspaceでユーザーとチャネルを管理する方法
チャネルを作成するためのAPIは、各SDKを通じて公開されています。例えば、'Createchannel'メソッドのファミリーは、JavaScriptのsetChannelMetadata()を呼び出します。チャットSDK以外のSDKを使用している場合は、JavaScript、Java、Swift、Kotlin、Python、Unityなど、アプリコンテキストデータを変更するための専用APIが提供されます。

メンバーシップApp Context

ユーザとチャネルの両方にApp Contextを定義したので、ユーザがチャネルの'メンバー'であるかどうかを指定することで、2つの関係を定義することができます。

ユーザーがチャンネルに参加すると、同じチャンネルの他のメンバーに関するアップデートを受け取ることができる。ユーザーが参加したり脱退したりしたときや、そのユーザーのApp Contextが更新されたとき（例えば、ユーザーが自分の名前を更新したとき）にはいつでも通知を受け取ることができる。

これは、特にチャットアプリの開発者にとって、多くの価値を提供する強力なメカニズムです。 App Context を使用しない場合、すべてのユーザーを自分で追跡し、そのユーザーがどのチャネルのメンバーであるかを追跡し、そのユーザーが参加または退会したときに同じチャネルの他の全員に通知する必要があります。この課題は直線的にスケールしないため、ソリューションのユーザーが増えれば増えるほど、この情報をすべて一元管理しようとするのは難しくなります。

App Contextを使用することで、チャットクライアントが内部状態を維持するために必要なすべての情報が提供され、PubNubAccess Managerでそのデータを完全に制御して不正アクセスを防ぐことができます。

メンバーシップの作成方法は？

ユーザーやチャンネルと同様に、メンバーシップを作成するには2つの方法があります。

メンバーシップは、BizOpsワークスペースを使用してコードを記述することなく作成および管理できます。詳細については、ドキュメントの「メンバーシップの管理」セクションを参照してください。
チャネルを作成するためのAPIは、各SDKを通じて公開されています。例えば、'Createchannel'メソッドのファミリーは、JavaScriptのsetMembershipsを隠れて呼び出します。チャットSDK以外のSDKを使用している場合は、JavaScript、Java、Swift、Kotlin、Python、UnityなどのApp Contextデータを変更するための専用APIが提供されます。

App Context変更時のリアルタイムイベントの受信

App Context データが変更されると、アプリケーションはリアルタイムで変更内容を通知するイベントを受け取ります。これにより、更新のためにサーバーをポーリングすることなく、応答性の高いアプリケーションを作成できます。

PubNub SDK（チャットSDKを除く）によるApp Context変更の受信

すべてのPubNub SDKは "イベントリスナー "を公開しており、これらのリスナーを通じてApp Contextデータが変更されるたびに発生するオブジェクトイベントをリッスンすることができます。

イベントエンジンとイベントリスナーのアップデートに関するこのブログで説明されているように、執筆時点では、いくつかのSDKは「イベントリスナー」の新しいフォーマットをサポートしています。イベント・リスナーの形式にかかわらず、原則は同じです。あなたのアプリは、SDKが提供するリスナーを通じてアプリ・コンテキスト・イベントを受信するように登録する必要があります。

あなたのアプリは、SDKが提供するリスナーを通じてアプリコンテキストイベントを受信するように登録する必要があります。JavaScript SDKのドキュメントに詳述されているように、アプリコンテキストイベントの登録は以下のようになります：

const channel = pubnub.channel('channel_1');
const subscription = channel.subscription();
subscription.onObjects = 
  (objectsEvent) => { console.log("Objects event: ", objectsEvent); };

他の言語でのApp Contextイベントの登録方法を説明したドキュメントは、以下の場所にあります： Java、Swift、Kotlin、Python（Pythonはイベントを「メタデータ」と呼び、他のSDKはイベントを「オブジェクト」と呼ぶことに注意）、Unityなど。

作業例とインタラクティブなデモについては、BizOps Workspaceでユーザーとチャンネルを管理する方法の記事を参照してください。

PubNub Chat SDKでアプリのコンテキスト変更を受け取る

PubNub Chat SDKはstreamUpdates()APIファミリを通じてApp Contextイベントを公開します。

いくつかの例は、Web用のチャットSDKデモアプリから抜粋したものです：

//  Detect changes to the current User
useEffect(() => {
  return currentUser.streamUpdates(updatedUser => {
    if (updatedUser.name) {
      setName(updatedUser.name)
    }
    if (updatedUser.profileUrl) {
      setProfileUrl(updatedUser.profileUrl)
    }
  })
}, [currentUser])

//  Detect changes to an array of Channels
useEffect(() => {
if (chat && privateGroups) {
    return Channel.streamUpdatesOn(privateGroups, channels => {
    //  The array of channels, privateGroups, has been updated
}
}, [chat, privateGroups])

チャットSDKのよりシンプルな'getting stated'サンプルに基づく作業例については、BizOps Workspaceでユーザーとチャネルを管理する方法の記事を参照してください。

アプリコンテキストとPubNub Illuminate

PubNub Illuminateは、組織独自のユースケースに合わせてカスタマイズ可能なリアルタイムの意思決定および分析製品です。この製品は、プロダクトマネージャーやアナリストを念頭に置いて設計されており、以下のことが可能です：

カスタム・リアルタイム集計メトリクスの定義
条件とアクションを伴う決定ルールの設定と展開。
追跡しているメトリクス、実行されたアクション、その結果を即座に可視化する。

エンジニアリングチームを進行中のプロジェクトから引き離すことなく、これらすべてをリアルタイムで実行できます。

PubNub Illuminteがどのようなもので、どのようにデータに対して即座に実行可能な洞察を提供できるのかについての詳しい説明はこの記事の範囲外ですが、詳細についてはドキュメントと製品概要を参照してください。

要約すると、アプリケーションに関連するメトリクス、つまり測定したいものを定義します。例えば、資産追跡のシナリオでは、注文が取られてからの時間数などです。そのメトリクスに関連する何らかの条件が満たされたとき、例えば「注文からの時間」がある値を超えたとき、何らかのアクションを取ることができます。

どのアクションを取るかは自由ですが、可能なアクションのうち3つはApp Contextに関するものです：

PubNub Illuminateでユーザーを更新する

定義済みまたはカスタムのユーザーメタデータを設定できます。下のスクリーンショットではID 123のユーザのステータスが静的な値「New Status」に設定されているが、アクションのトリガーとなった条件に基づいて動的な値を設定することも可能だ。

PubNub Illuminateでチャンネルを更新する

定義済みまたはカスタムのチャンネルメタデータを設定できます。下のスクリーンショットではID 123のチャンネルの名前が静的な値'New Name'に設定されていますが、アクションのトリガーとなった条件に基づいて動的な値を設定することも可能です。

PubNub Illuminateでメンバーシップを更新する

定義済みまたはカスタムの会員メタデータを設定できます。下のスクリーンショットはユーザID123のチャンネル123のメンバーシップのステータスが静的な値「New Status」に設定されていることを示しています。 アクションをトリガーした条件に基づいて動的な値を設定することも可能です。

アプリコンテキストとPubNub関数

PubNubはPubNubプラットフォームで発生しているイベントをキャプチャするためのFunctionsを提供します。Functionsを使用すると、コードを書いたり、既存の統合機能を活用して、データの変換、リルート、拡張、フィルタリング、さらには集計を行うことができます。 PubNub Functionsの詳細な概要については、Functionsのドキュメントを参照してください。

PubNub Functions内からApp Contextを更新する

Functionsが実行される環境はPubNubモジュールにアクセスできます。このモジュールはキーセットのApp Contextに完全にアクセスできます。ドキュメントから抜粋した例を以下に示します。 :

Get User App Context Metadataの例

export default (event) => {
  const pubnub = require('pubnub');

  return pubnub.objects.getUUIDMetadata({
    uuid: 'my-uuid',
    include: {
      customFields: false,
    },
  })
  .then((resp) => {
    console.log(resp);
    return event.ok('Fetched UUID metadata successfully.');
  })
  .catch((err) => {
    console.log(err);
    return event.abort('Failed to fetch UUID metadata');
  });
};

Set Channel App Context Metadataの例

export default (event) => {
  const pubnub = require('pubnub');

  return pubnub.objects.setChannelMetadata({
    channel: 'my-channel',
    data: {
      name: 'channel-name',
      description: 'What a great channel',
      custom: {
        foo: 'bar',
      },
    },
    include: {
      customFields: false,
    },
  })
  .then((resp) => {
    console.log(resp);
    return event.ok('Set channel metadata successfully.');
  })
  .catch((error) => {
    console.log(err);
    return event.abort('Failed to set channel metadata.');
  });
};

コード例の包括的なセットについては、PubNubモジュールのドキュメントを参照してください。

アプリコンテキストが変更されたときにPubNub関数をトリガーする

Event Typesのドキュメントで詳しく説明されているように、関数をトリガーできるイベントタイプは数多くあります。これらには、メッセージやシグナルが送信されたときに検出する機能、プレゼンスイベントが発生した後に関数をトリガする機能、指定した間隔またはオンデマンドで関数を実行する機能などがあります。この記事を書いている時点では、App Contextの更新後にFunctionを実行することはできませんが、アプリケーションがこれを必要とする場合は、サポートチームにご連絡ください。

次のステップ

App Context の動作を確認するには、App Context を当社の Chat SDK と一緒に使用して、サーバーレスストレージを使用したチャットアプリがどのように見えるかを示すChat Demoをご覧ください。 Chat Demoでは、UserやChannelのメタデータを設定し、その変更が他のリスナーやメンバーにリアルタイムで反映される様子を見ることができます。

また、App Contextに依存するBizOpsワークスペースに関する関連する3つのパートからなるシリーズもご覧ください：ユーザーとチャネルの管理、会話の監視とモデレート、チャットの安全なモデレート。

最後に、DevRelチーム（devrel@pubnub.com）までお気軽にお問い合わせください。また、PubNubの開発に関するどのようなことでもサポートチームにお問い合わせください。

PubNubはどのようにお役に立ちますか？

この記事はPubNub.comに掲載されたものです。

私たちのプラットフォームは、開発者がWebアプリ、モバイルアプリ、およびIoTデバイスのためのリアルタイムのインタラクティブ性を構築、配信、管理するのに役立ちます。

私たちのプラットフォームの基盤は、業界最大かつ最もスケーラブルなリアルタイムエッジメッセージングネットワークです。世界15か所以上で8億人の月間アクティブユーザーをサポートし、99.999%の信頼性を誇るため、停電や同時実行数の制限、トラフィックの急増による遅延の問題を心配する必要はありません。

PubNubを体験

ライブツアーをチェックして、5分以内にすべてのPubNub搭載アプリの背後にある本質的な概念を理解する

セットアップ

PubNubアカウントにサインアップすると、PubNubキーに無料ですぐにアクセスできます。

始める

PubNubのドキュメントは、ユースケースやSDKに関係なく、あなたを立ち上げ、実行することができます。

ドキュメント・リリースノート - 2024年6月

PubNub Developer Relations — Mon, 08 Jul 2024 12:46:27 +0000

この記事はhttps://www.pubnub.com/docs/release-notes/2024/juneに掲載されたものです。

こんにちは！今月は新しいアップデートをお届けします。

データの一貫性を保つための新しい参照整合性フラグを導入しました。
管理者ポータルから直接チャンネルグループの上限を設定できるようになりました。
InsightsからBizOpsにデータをインポートして、その機能を試してみてください。
さらに、プレゼンス・マネジメントのルック＆フィールが刷新されました。

その他にも、PubNubを使う上で疑問に思っていることを解消できるような、小さいけれども重要な改善をたくさん行いました。

これからもPubNubをよろしくお願いします！

🛠️

FCMペイロードのカスタムフィールド

タイプ改善

FCMモバイルプッシュ通知のペイロードに追加できるPubNubのカスタムパラメータpn_debug、pn_exceptions、pn_dry_runを追加して、Androidモバイルプッシュ通知のドキュメントを修正しました。

これらのパラメータを使用すると、通知をテストまたはデバッグしたり、通知を受信しないように選択したデバイスを除外したりできます。

以下は、カスタムフィールドを含むFCMペイロードのサンプルです：

{
  "pn_fcm": {
    "notification": {
      "title": "My Title",
      "body": "Message sent at"
 },
    "pn_collapse_id": "collapse-id",
    "pn_exceptions": [
      "optional-excluded-device-token1"
 ]
 },
  "pn_debug": true,
  "pn_dry_run": false
}

チャネルグループの制限

タイプ新機能

管理ポータルのStream Controllerに、有料プランのお客様向けにチャンネルグループ制限オプションが追加されました。デフォルトの上限である1,000チャンネルを下げることも、2,000チャンネルまで増やすこともできます。

アプリコンテキストのユーザーメタデータイベント

タイプ改善

User Metadata Eventsオプションを有効にすると、ユーザー・エンティティの変更（設定と 削除）がメンバーシップ関連にイベント通知を送信するため、そのユーザーとそのユーザーがメンバーであるチャネルの両方にイベント通知が送信されることを明確にするため、ドキュメントを改善しました。詳細はドキュメントを参照してください。

アプリコンテキスト設定の依存関係

タイプ改善

App Contextの設定オプションに関するドキュメントを更新し、重要な依存関係についての情報を追加した。

Disallow Get All Channel Metadata」と「Disallow Get All User Metadata」オプションは一見わかりやすいように見えますが、これらのオプションはAccess Managerが有効な場合にのみ機能するという注意点があります。

言い換えると、Access Managerがない場合、これらのアクティブなオプションは、実際にはキーセットのユーザーまたはチャンネルに関するメタデータの取得を無効にしない。同時に、Access Managerを有効にすると、デフォルトでキーセット上のすべてのオブジェクトへのアクセスが制限されるため、細かい権限スキーマを作成しなくても、これらの設定オプションの両方のチェックを外すことで、ユーザーとチャンネルに対するAccess ManagerのGET制限を簡単に回避することができる。

Admin Portal UIにも、この依存関係がまもなく反映される予定です。

App Contextの新しい参照整合性フラグ

タイプ新機能

管理ポータルのアプリのキーセットでApp Contextを有効にすると、デフォルトでオンになる新しいEnforce referential integrity for membershipsオプションを追加した。

このフラグにより、メンバーシップを作成したユーザIDとチャネルIDの両方が存在する場合にのみ、新しいメンバーシップを設定できるようになります。同時に、親ユーザまたはチャネルのメタデータ・エンティティを削除すると、その削除されたエンティティの子メンバーシップ関連付けが自動的に削除されます。こうすることで、キーセット上のメンバーシップ・オブジェクトに不具合や欠落が生じないようにすることができる。

SDK 📦 Pythonドキュメントの改善

Pythonドキュメントの改善

タイプ改善

頂いたフィードバックに従い、メソッドの使用法と実行に関する情報を拡張しました。その結果、Python SDKドキュメントの各Returnsセクションでは、各メソッドが返すデータフィールドについて説明するようになりました。また、同期(.sync())と非同期(.pn_async(callback))リクエストの実行が、各メソッドの戻りデータにどのように影響するかも説明しています。

React SDKは廃止されました。

タイプ非推奨のお知らせ

しばらくReact SDKの開発を積極的に行っていなかったため、最終的に正式に非推奨とし、ドキュメント内のCall For Contributionsセクションに移動することにしました。

React SDKのバグを見つけたり、機能を拡張したい場合は、遠慮なくリポジトリにプルリクエストを作成し、私たちのフィードバックをお待ちください！

機能

イベント＆アクションからファンクションのログをエクスポートする

タイプ新機能

各PubNubファンクションは内部のbocks-output-*チャンネルにログを保存します。bocks-output-NSPiAuYKsWSxJl4yBn30のように、新しいログが上書きされる前に最大250行のログを保存できます。古いログを失いたくない場合は、イベント＆アクションを使用して、これらのログを外部サービスにエクスポートできるようになりました。

インサイト ↪So_1F4CA

REST APIドキュメントのユーザー期間とデバイスメトリクス

タイプ改善

先月、管理ポータルのPubNub InsightsのUser Behaviorダッシュボードにデバイスメトリクスを導入しました。今月は、REST APIドキュメントを更新し、ユーザー期間とデバイスメトリクスの両方を含めるようにしました。これにより、PubNub Insights APIを直接呼び出して、関心のあるメトリクスを取得できます。

BizOpsワークスペース 🏢 🏢 ←クリック

トップ20ユーザー/チャンネル

タイプ新機能

App Contextを使用してユーザーとチャネルを保存および管理しない場合でも、テストデータをインポートすることで、関連するBizOps Workspace機能をテストできます。

PubNub Insightsにアクセスできる場合は、管理者ポータルのBizOps WorkspaceのUser ManagementモジュールとChannel Managementモジュールにアクセスし、[Import from Insights]ボタンをクリックします。

その結果、アプリのキーセットから、直近1日以内に最も多くのメッセージを公開した最大20人のユーザーがインポートされます（昨日メッセージが送信されていない場合、ユーザーは前日のデータに基づいてインポートされます）。

ユーザーと同様に、アプリのキーセットから、直近1日以内に公開されたメッセージ数が最も多いチャンネルを最大20チャンネルまでインポートできます。

このテストデータを使用して、BizOps Workspaceが提供するものを探求してください。

プレゼンス管理UXの刷新

タイプ改善

最近、BizOps Workspaceのプレゼンス管理モジュール全体のデザインを変更し、ルール作成ウィザードを簡素化し、バッジの色をより包括的なものに変更し、キーセットのプレゼンス設定のデフォルトの「すべてのチャンネルでプレゼンスを有効にする」設定を反映する「キャッチオール」パターン設定を追加しました。

新しいルック＆フィールを気に入っていただければ幸いです！

ドキュメント・リリースノート - 2024年5月

PubNub Developer Relations — Mon, 08 Jul 2024 11:17:12 +0000

この記事はhttps://www.pubnub.com/docs/release-notes/2024/mayに掲載されたものです。

今月のリリースノートへようこそ！PubNubはあなたの作業を効率化し、利便性を高めるためのアップデートをお届けします。

パッケージの中身は？

App Contextのデータフィルタリングのドキュメントを統一し、PythonとAsyncioのイベントリスナーアーキテクチャを刷新し、安全なチャットモデレーションを始めるための新しいツールを追加しました。

管理者ポータルの面では、詳細なデバイスメトリックスでゲームをアップグレードし、バッチとエンベロープオプションでイベント管理を改善し、Illuminateでスタイリッシュな新しい積み上げ棒グラフと変数機能を展開しました。

さらに、弊社のドキュメントとウェブサイトには、AIを相棒にした新しい検索エンジンが搭載され、必要なものを正確に見つけることができるようになりました。

さっそくその魅力に触れてみてください！

🛠️

App Contextデータのフィルタリングに関する統一情報

タイプ機能強化

説明フィードバックに基づき、PubNubのApp Context APIを使用したユーザー、チャンネル、メンバーシップデータのフィルタリングに関する様々なSDKからの情報を見直し、統一しました。その結果、データフィルタリングクエリのエントリポイントとして機能するApp Context Filteringドキュメントを1つ作成しました。

学びましょう：

どのユーザー、チャネル、およびメンバーシップデータをフィルタリングできるか。
どのフィルタリング演算子を使用するか。
実践的な例を通して、どのようにデータをフィルタリングできるか。

   pubnub.objects.getAllChannelMetadata({
       filter: '["description"] LIKE "*support*"'
   })

SDK 📦 イベントリスナーアーキテクチャの更新

PythonとAsyncioのイベントリスナーアーキテクチャの更新

タイプ新機能

説明 Pythonと AsyncioSDKのための新しいイベントリスナーアーキテクチャは、以前のモノリシックなPubNubオブジェクトと比較して、サブスクリプションを管理し、イベントをリッスンする、より狭いスコープの方法を導入しています。

PubNubオブジェクトは依然としてグローバルスコープとして機能し、下位互換性を維持していますが、新しいアーキテクチャでは、Subscriptionオブジェクトを返すチャネル、チャネルグループ、ユーザーメタデータ、チャネルメタデータなどの「エンティティ」オブジェクトを提供しています。

これらのSubscriptionは、単一のエンティティに固有のsubscribe/unsubscribeメソッドとaddListener/removeListenerメソッドを可能にし、リアルタイムイベントを管理する、より柔軟で独立した方法を提供し、グローバルな状態管理の必要性を低減します。

# entity-based, local-scoped
subscription = pubnub.channel(f'{channel}').subscription(with_presence: bool = False)

Chat 💬チャット

チャットSDKの安全なモデレーション用サンプル

タイプ新機能

説明チャットチームは、Access ManagerでチャットSDKアプリを保護するためのエンドツーエンドのシナリオを理解するのに役立つシンプルなAccess Manager APIサービスを作成しました。このサービスはシンプルなエンドポイントをモックし、Access Managerを有効にしたチャットSDKアプリのサーバーサイド認証をセットアップするために使用できるサンプル権限セットを含んでいます。

私たちのReact Native Chat App（ユーザーとの対話用）、Channel Monitor（ミュートや禁止などのユーザーモデレーション用）、およびAccess Manager API（認可トークンの生成用）を使用して、すべてのテストシナリオを実行します。

詳細な手順については、BizOps WorkspaceブログのHow to Securely Moderate Chat and Usersを参照してください。

インサイト ↪So_1F4CA

デバイスメトリクスダッシュボード

タイプ機能強化

説明インサイトのユーザー行動ダッシュボードを拡張し、デバイスタイプのメトリクスを追加しました。これにより、デバイスタイプごとのユーザーの行動を深く掘り下げることができます。今後、アプリのユーザーが最も頻繁に公開または購読する場所（iOS、Android、Windows）を観察し、デバイスタイプごとのユニークユーザー数を確認できます。

この洞察は、デバイス別にカスタム機能を構築し、顧客体験を向上させるのに役立ちます。

イベントとアクション ⚡ ウェブフックアクションがバッチ処理に対応しました。

Webhookアクションがバッチ処理に対応

タイプ機能強化

説明イベント＆アクションのバッチ機能を使うと、イベントを個別に送信するのではなく、1つのリクエストで送信することで、大量のイベントを管理できます。この機能は5月よりWebhookアクションタイプでも利用できるようになりました。

(アン)エンベロープ

タイプ機能拡張

説明全てのアクションのペイロードをエンベロープでラップできるようになった。つまり、ペイロードスキーマに詳細なEvents & Actions JSONメタデータを含めるかどうかを選択できる。ペイロードが送信されたチャンネルや、それをトリガーしたリスナーに関する情報のように、ペイロード以外のメタデータを使いたい場合に役立つかもしれません。

イルミネーション 💡。

積み上げ棒グラフ

タイプ新機能

説明棒グラフと折れ線グラフに加えて、Illuminateダッシュボードでは、1つのチャート上に多くのディメンションと値がある場合にデータの可読性を向上させる、新しい積み重ね棒タイプのチャートを提供するようになりました。

変数

タイプ機能強化

説明Decisionsでアクションを作成するとき（収集したメトリクスで何をしたいかを記述する）、アクション構成テーブルに変数を追加して、参照するものを制御し、動的に変更することができます。定義済みの条件を参照したり（${と入力してリストから選択）、新しい変数（${変数}）を設定したりすることで、より柔軟に変数を使用できます。変数はアクションのペイロードや ボディだけでなく、ほとんどのアクションフィールドで利用できるようになりました。

データマッピングフィールドの改善

タイプ機能強化

説明ビジネスオブジェクトを作成し、メジャー（追跡したいデータ）またはディメンション（追跡するものをセグメント化する）を定義するとき、Illuminateにこのデータを探すべき場所を知らせるために、フィールド名をペイロードの実際のフィールドにマッピングする必要があります。これまでは、特定のペイロードフィールドの正確なマッピングを手動で入力する必要がありました。5月現在、Illuminateは、正確なPublishおよびApp Contextデータの場所を見つけるために、よりユーザーフレンドリーなドロップダウンメニューを提供しています。

その他

新しい検索とAIアシスタント

タイプ新機能

説明最後になりましたが、PubNubの学習アドベンチャーをより正確でインタラクティブなものにするために、ドキュメント内のAlgolia検索を新しい検索とAIアシスタントの組み合わせに変更しました。

新しいAIアシスタントと検索機能であなたのコーディングゲームをレベルアップし、友達を作りましょう。皆さんからのフィードバックをもとに改良していきますので、足りないものがあれば必ずアップデートします。ハッピーコーディング！🚀

データ・ストリーミング技術の概要

PubNub Developer Relations — Mon, 08 Jul 2024 09:47:05 +0000

大量のデータ（ビッグデータ）をリアルタイムで処理する能力は、多くの組織にとって極めて重要になっており、そこでデータ・ストリーミング・テクノロジーの出番となる。これらのテクノロジーにより、大量のデータをリアルタイムまたはほぼリアルタイムで処理することが可能になり、企業は即座に洞察を得て、一刻を争うデータ主導の意思決定を行うことができる。

これらのテクノロジーの核心は、イベント・ストリームとも呼ばれるデータ・ストリームの概念である。データ・ストリームは、ソーシャルメディア・フィード、モノのインターネット（IoT）デバイス、ログ・ファイル、科学的データ・セットなど、さまざまなソースから生成されるシーケンスです。これらのデータ・ストリームは、データ・ストリーミング技術によって取り込まれ、処理される。

もう一つの重要な側面は、データストリームのスケーラビリティである。データ量が増加するにつれて、テクノロジーは負荷の増加に対応できるように拡張され、企業はリアルタイムの分析結果を得ることができる。つまり、企業は生成されたデータを分析し、迅速な意思決定を行うことができる。これは、不正行為の検出や顧客体験の最適化など、タイミングが重要なシナリオで特に役立つ。

データ・ストリーミング・テクノロジーは、SQLデータベースのような構造化データから、ライブ・イベントやソーシャルメディア・フィードのような非構造化データまで、さまざまな形式をサポートしているため、企業はソースや形式に関係なく、あらゆる種類のデータを処理・分析できる。例えば、実装と管理には高度なデータエンジニアリングスキルが必要で、特に大量のデータを扱う場合には低レイテンシーと高スループットが要求される。

データストリーミング技術の基本概念

データ・ストリーミング・テクノロジーは、いくつかの基本概念の上に成り立っている。これらの概念を理解することは、リアルタイム・データ処理のパワーを十分に活用する上で極めて重要です：

データストリーム

データ・ストリームは、IoTデバイス、ログ・ファイル、株式市場など、さまざまなソースからの連続的なデータ・フローです。これらのデータ・ソースは、多くの場合、リアルタイムまたはリアルタイムに近い高速でデータを生成し、生成されたデータは通常、時間に敏感である。

ストリーム処理

ストリーム処理とは、データ・ストリームをリアルタイムで処理することである。スケジュールされた間隔でデータを処理するバッチ処理とは異なり、ストリーム処理はデータが到着するとすぐに処理する。このためレイテンシーが低く、ユーザーのポジション追跡や商品価格とその値に基づく意思決定など、時間に敏感なアプリケーションには不可欠です。

バッチ処理とストリーム処理

バッチ処理とストリーム処理は、データ処理に対する2つの異なるアプローチを表している。バッチ処理は、一度に大量のデータをスケジュールされた間隔で処理し、時間に敏感でないデータ分析タスクに適しています。一方、ストリーム処理はデータが生成されるとすぐに処理し、リアルタイムの洞察を提供する。

また、データ・ストリーム処理について語る際に「マイクロバッチ」という言葉を目にすることがあるが、このアプローチはバッチ処理とストリーム処理の中間に位置し、非常に新鮮なデータが必要な場合に用いられるが、必ずしもリアルタイムではない。

データ・ストリーミング・アーキテクチャ

データ・ストリーミング技術の典型的なアーキテクチャには、データ・ソース、データ取り込みシステム、ストリーム処理システム、データ・ストレージ・システムが含まれる。

データ・ソースはデータのストリームを生成する。
Apache KafkaやAmazon Kinesisのようなデータ取り込みシステムは、処理のためにこれらのデータストリームを取り込む。
Apache FlinkやApache Spark Streamingなどのストリーム・プロセッサーは、取り込まれたデータをリアルタイムで処理する。
処理されたデータはデータレイクやデータウェアハウスに保存され、さらなる分析や可視化ダッシュボードに利用される。
データは、PubNub Kafkaブリッジなどのシステムを使用して、ネットワークのエッジに直接ストリーミングすることができます。

データはデータパイプラインでソースからデスティネーションまでアーキテクチャを流れます。要するに、データ・パイプラインは、データの起点から取り込み、処理、そして最終的にストレージや可視化までのデータの旅を表している。

データの一貫性

データの一貫性はデータ・ストリーミングにおける重要な関心事である。データ・ストリーミング・テクノロジーは、一貫性を確保するために、イベントの順序付け、完全一致処理、フォールト・トレランスなどの様々なテクニックを使用する。これらの技術は、データが正しい順序で処理され、データが失われたり複数回処理されたりすることがなく、データが失われることなくシステムが障害から回復できることを保証します。

例えば、PubNubはリードレシート、メッセージ順序付け、キューイングなど、メッセージ配信を保証するいくつかの方法を提供しています。

データストリーミング技術のためのツール

データ・ストリーミング技術を実装するための様々なオープンソースおよび商用ツールが利用可能である。Apache Kafka、Apache Flink、AWS Kinesis、Microsoft Azure Stream Analyticsなどだ。各ツールにはそれぞれ長所と使用事例があり、ツールの選択はデータストリーミングアプリケーションの特定の要件に依存します。

PubNubデータストリーミングの次のステップ

データストリーミング技術の基本的な概念とアーキテクチャを理解したら、次のステップはこれらの技術を自分のシステムに実装することです。PubNubは、既存のアーキテクチャに簡単に統合できる堅牢でスケーラブルなリアルタイムデータストリーミングプラットフォームを提供します。

ここでは、PubNubデータストリーミングを始めるための手順を説明します：

デモを見るPubNubはリアルタイムデータストリーミングのデモを提供しており、プラットフォームの仕組みを理解するのに役立ちます。このデモは、チャットアプリからIoTデバイス制御まで、幅広いユースケースに適用できます。
基本を理解する：PubNubは、データストリーミングに関する項目を含む、主要な用語や概念を説明する包括的な用語集を提供しています。
PubNub Illuminateを理解する：PubNub Illuminateを使用すると、オンザフライで収益化戦略を調整し、ユーザーの行動をインセンティブにリンクし、カスタム、リアルタイム集計およびデバイスメトリクスですべてのアクションを追跡し、即座に結果を確認することができます - すべてあなたの開発チームに負担をかけることなく。
登録PubNubアカウントに登録します。登録ページから登録できます。PubNubアカウントの無料層は制限に余裕があり、アップグレードするまでクレジットカードを必要としません。
ビルドを開始します：基本をマスターしたら、独自のデータストリーミングアプリケーションを構築しましょう。PubNubは、リアルタイムデータストリーミングアプリケーションの構築に関するチュートリアルを含む、さまざまなタイプのアプリケーションの構築をガイドするチュートリアルのホストを提供しています。
APIを探索する：PubNubは、アプリケーションの構築に使用できる幅広いAPIとSDKを提供しています。詳細はSDKドキュメントのページをご覧ください。
価格を理解する：構築を完了する前に、どのくらいの費用がかかるかを知っておくと便利です。PubNubの価格についての詳細は価格ページをご覧ください。

データ・ストリーミング・テクノロジーのユースケースを詳しく見る

リアルタイムデータ分析

データ・ストリーミング・テクノロジーの主なユースケースの1つは、リアルタイムのデータ分析です。データ・ストリームをリアルタイムで処理・分析することで、企業は業務に関する洞察を即座に得て、情報に基づいた迅速な意思決定を行うことができる。これは金融などの業界で特に有用で、リアルタイムデータ分析は不正行為の検出や市場動向分析などに利用できます。

PubNub Illuminateはリアルタイム分析プラットフォームの一例である。しかし、PubNub Illuminateは単なるデータ管理のためのプラットフォームではなく、データメトリクスに基づいて条件を定義することもでき、その条件がトリガーされると、そのデータに基づいて動的なアクションが実行されます。

モノのインターネット（IoT）

データ・ストリーミング・テクノロジーのもう一つの重要なアプリケーションは、モノのインターネット（IoT）で、デバイスがデータ・ストリームを生成し、それをリアルタイムで処理して貴重な洞察を提供することができます。例えば、産業機器の性能を監視することで、企業は機器の故障につながる前に問題を検出し、対処することができる。

ソーシャルメディア分析

ソーシャルメディア・プラットフォームは、毎秒大量のデータを生成します。データ・ストリーミング技術は、このデータをリアルタイムで処理できるため、企業はトレンドを監視し、顧客の感情を追跡し、顧客のフィードバックに即座に対応することができます。

電子商取引

Eコマース業界では、データ・ストリーミング技術はリアルタイムで顧客の行動を追跡することができ、企業はパーソナライズされた推奨を提供し、顧客体験を改善し、売上を増加させることができます。

データストリーミング技術の今後の動向

機械学習やAIとの統合

データ・ストリーミング技術の重要なトレンドの1つは、機械学習と生成AIの統合である。機械学習モデルは、正確でタイムリーな予測を行うために必要なリアルタイムのデータを提供することができる。これは特に予知保全に有用で、機械学習モデルはリアルタイムのデータに基づいて部品の故障を予測することができる。例えば、モバイル機器のバッテリーの放電サイクルは、バッテリーの予想寿命を推定するために使用することができる。

オープンソース・フレームワークの利用拡大

Apache Kafka、Apache Flink、Spark Streamingなどのオープンソースのフレームワークは、データストリーミング技術を実装するための一般的なツールとなっている。これらのフレームワークは、大量のデータをリアルタイムで処理するための堅牢な機能を提供し、オープンソースの性質上、高度にカスタマイズ可能で、さまざまなユースケースに適応できる。今後、これらのフレームワークやその他のオープンソース・フレームワークの利用が増えると予想される。

データ・セキュリティとプライバシーの重視の高まり

企業が機密データを処理するためにデータ・ストリーミング・テクノロジーにますます依存するようになるにつれ、データ・セキュリティとプライバシーがより重視されるようになるだろう。これには、データ・ストリームを不正アクセスから保護し、データ・プライバシー規制を確実に遵守するための強固なセキュリティ対策の導入が含まれる。

より高度なデータエンジニアリング技術

ストリーム処理、データ・パイプラインの最適化、データの一貫性の確保など、エンジニアがこのテクノロジーに習熟するにつれて、より高度なデータ・エンジニアリング技術が登場すると予想される。

結論

データ・ストリーミング・テクノロジーの未来は明るい。リアルタイムでより優れた業務上の洞察をビジネスに提供することで、過去のデータに頼ることなく即座に行動を起こすことができ、顧客満足度、効率性、収益性が向上する。顧客管理、eコマース、IoT、ソーシャルメディア分析など、業種を問わず、データ・ストリーミング技術はビジネスのあり方を変革する可能性を秘めている。

PubNubは、ストリーミングデータによるビジネスの変革をお手伝いします。PubNubの開発に関するどのようなことでも、devrel@pubnub.com、DevRelチームまたはサポートチームまでお気軽にお問い合わせください。

PubNubはどのようにお役に立ちますか？

この記事はPubNub.comに掲載されたものです。

PubNubを体験

ライブツアーをチェックして、5分以内にすべてのPubNub搭載アプリの背後にある本質的な概念を理解する

セットアップ

PubNubアカウントにサインアップすると、PubNubキーに無料ですぐにアクセスできます。

始める

PubNubのドキュメントは、ユースケースやSDKに関係なく、あなたを立ち上げ、実行することができます。

OpenAIによるチャット・モデレーション

PubNub Developer Relations — Wed, 03 Jul 2024 15:27:08 +0000

アプリ内チャットを含むアプリケーションは、ユーザーが交換できるメッセージを規制し、モデレートする何らかの方法が必要です。人間のモデレーターですべての不適切なコンテンツをモデレートすることは不可能なので、モデレーション・システムは自動的でなければなりません。ユーザーはモデレーションを回避しようとすることが多いので、機械学習、生成AI、大規模言語モデル（LLM）［およびGPT-3やGPT-4などのGPTモデル］は、コンテンツをモデレートする一般的な方法です。

モデレーションは複雑なトピックであり、PubNubはすべての開発者のユースケースを満たすために様々なソリューションを提供しています。

PubNubファンクションは、宛先に到達する前にメッセージをインターセプトして変更することができます。外部REST APIを呼び出すなど、Function内でカスタムロジックを適用することができ、メッセージモデレーションに任意の外部サービスを使用することができます。この記事ではOpenAIと統合するためにこのアプローチを使用します。
PubNub Functionsは、Lasso Moderation、Tisane、RegExベースの冒涜フィルタ、Lexalytics、Community Siftなど、コンテンツモデレーションとセンチメント分析をサポートするカスタム統合を提供します。
PubNubのBizOps Workspaceは、メッセージの編集と削除を含む会話の監視とモデレーションを行うことができます。

Open AIモデレーション・エンドポイント

この記事では、OpenAIのModeration APIについて見ていく。このAPIは、人工知能（AI）を使用して、提供されたテキストに有害な用語が含まれているかどうかを判断するREST APIである。このAPIの意図は、開発者が有害なコンテンツをフィルタリングまたは削除できるようにすることであり、執筆時点では、英語しかサポートしていないが、無料で提供されている。

Moderation APIの背後にあるモデルは、提供されたテキストを次のように分類します（APIドキュメントから引用）：

ヘイト：人種、性別、民族、宗教、国籍、性的指向、障害の有無、カーストに基づくヘイトを表明、扇動、促進するコンテンツ。保護されていないグループ（例：チェスプレイヤー）に向けた憎悪のコンテンツは、ハラスメントです。
憎悪／脅迫：人種、性別、民族性、宗教、国籍、性的指向、障害の状態、またはカーストに基づき、対象となるグループに対する暴力または深刻な危害も含む憎悪的な内容。
ハラスメント：あらゆるターゲットに対して嫌がらせの言葉を表現、扇動、促進するコンテンツ。
ハラスメント／脅迫：暴力や深刻な危害を含むハラスメントコンテンツ。
自傷行為：自殺、切り傷、摂食障害などの自傷行為を助長、奨励、描写するコンテンツ。
自傷／意図：自殺、切断、摂食障害などの自傷行為に関与している、または関与する意思があることを表明するコンテンツ。
自傷／指示：自殺、切断、摂食障害などの自傷行為の実行を奨励する内容、またはそのような行為の実行方法について指示や助言を与える内容。
性的なもの：性行為の描写など性的興奮を喚起する内容、または性的サービスを宣伝する内容（性教育や健康増進を除く）。
性的／未成年：18歳未満の個人を含む性的コンテンツ。
暴力：死、暴力、身体的傷害を描写するコンテンツ。
暴力 / グラフィック：死、暴力、身体的傷害を生々しく描写したコンテンツ。

結果は以下のようなJSON構造で提供されます（これもAPIドキュメントから引用）：

{
  "id": "modr-XXXXX",
  "model": "text-moderation-007",
  "results": [
    {
      "flagged": true,
      "categories": {
        "sexual": false,
        "hate": false,
        "harassment": false,
        "self-harm": false,
        "sexual/minors": false,
        "hate/threatening": false,
        "violence/graphic": false,
        "self-harm/intent": false,
        "self-harm/instructions": false,
        "harassment/threatening": true,
        "violence": true
      },
      "category_scores": {
        //  Out of scope for this article
      }
    }
  ]
}

PubNubからOpen AI Moderation APIを呼び出す

モデレーションAPIを任意のPubNubアプリケーションに統合するには、このステップバイステップのチュートリアルに従ってPubNub Functionsを使用して簡単にできます：

関数を使用すると、メッセージの送受信など、PubNubプラットフォームで発生するリアルタイムのイベントをキャプチャできます。その後、必要に応じてメッセージを変更、再ルーティング、補強、またはフィルタリングするために、これらの関数内にカスタムサーバーレスコードを記述できます。

この関数タイプはメッセージが配信される前に呼び出され、メッセージが受信者に配信されるようにリリースされる前に実行を終了する必要があります。 PubNubのドキュメントにはより多くの背景と詳細が記載されていますが、要約すると、"Before Publish or Fire "はメッセージまたはそのペイロードを変更できる同期呼び出しです。

PubNub関数を作成する

PubNub管理ポータルにログインし、モデレートしたいアプリのアプリケーションとキーセットを選択します。
Build'タブの下にある'Functions'を選択します。
CREATE NEW MODULE'を選択し、モジュールに名前と説明を付けます。
CREATE NEW FUNCTION'を選択し、関数に名前を付けます。
イベントタイプに'Before Publish or Fire'を選択する。
チャンネル名には「*」を入力します（このデモでは「*」を使用しますが、アプリケーションによってはここでモデレートしたいチャンネルのみを指定することもできます）。

PubNub関数を作成したら、Open AI APIキーをシークレットとして提供する必要があります。

MY SECRETS'を選択し、'OPENAI_API_KEY'という名前で新しいキーを作成します。
OpenAI APIキーを生成し、そのキーがmoderate APIにアクセスできることを確認します。
生成したAPIキーを先ほど作成したPubNub関数のsecretに渡します。

PubNub関数の本体は以下のようになります：

const xhr  = require('xhr');
const vault = require('vault');

export default request => {
  if (request.message && request.message.text)
  {
    let messageText = request.message.text
    return getOpenaiApiKey().then(apiKey => {
      return openAIModeration(messageText).then(aiResponse => {
        //  Append the response to the message
        request.message.openAiModeration = aiResponse;
        //  If the message was harmful, you might also choose to report the message here.
        return request.ok();
      })
    })
  }
  return request.ok();
};

let OPENAI_API_KEY = null;
function getOpenaiApiKey() {
  // Use cached key
  if (OPENAI_API_KEY) {
      return new Promise(resolve => resolve(OPENAI_API_KEY));
  }
  // Fetch key from vault
  return vault.get("OPENAI_API_KEY").then(apikey => {
      OPENAI_API_KEY = apikey;
      return new Promise(resolve => resolve(OPENAI_API_KEY));
  });
}

function openAIModeration(messageText) {
  const url = 'https://api.openai.com/v1/moderations';
  const http_options = {
    'method': 'POST',
    'headers': {
      "Content-Type": "application/json",
      "Authorization": `Bearer ${OPENAI_API_KEY}`,
    },
    'body': JSON.stringify({
      "input": messageText
    }),
    timeout: 9500,
    retries: 0
  };
  return xhr.fetch(url, http_options)
    .then((resp) => {
      const body = JSON.parse(resp.body);
      return body;
    })
    .catch((err) => {
      console.log(err);
      return "Open AI Timed out";
    });
}

関数自体は非常に簡単です：

受信した各メッセージに対して

受け取った各メッセージをOpen AIモデレーション関数に渡す
返されたモデレーションオブジェクトをメッセージ(JSON)オブジェクトの新しいキーとして追加する。

関数を保存し、モジュールが起動していることを確認します。

遅延

今作成したPubNub関数はメッセージが送信されるたびに同期的に実行され、関数の実行が終了するまでそのメッセージは配信されません。関数には外部APIへの呼び出しが含まれているため、配信レイテンシはOpen AIへのAPI呼び出しが返す速度に依存します。

ユーザーエクスペリエンスの低下を軽減する方法はいくつかある。ほとんどのデプロイメントでは、メッセージが送信されたことを送信者に即座にフィードバックし、メッセージが配信された（または報告された）ことを示すリードレシートに依存しています。

クライアント・アプリケーションの更新

典型的なチャットアプリのほとんどの機能を表示するためにPubNub Chat SDKを使用するReactアプリケーションであるChat Demoを使用して、アプリケーション内でモデレーションペイロードを処理するために必要なものを考えてみましょう。

潜在的に有害なメッセージを表示すべきかどうかを追跡する属性を設定します：

 const [showHarmfulMessage, setShowHarmfulMessage] = useState(false)

また、有害な可能性のあるメッセージをデフォルトで表示しないようにするためのロジックを、この場合はmessage.tsx内に追加します：

{(
  !message.content.openAiModeration || 
  !message.content.openAiModeration?.results[0].flagged || 
  showHarmfulMessage) && (message.content.text
)}
{
  !showHarmfulMessage && 
  message.content.openAiModeration?.results[0].flagged && 
  <span>Message contains potentially harmful content 
    <span className="text-blue-400 cursor-pointer" 
    onClick={() => {setShowHarmfulMessage(true)}}>(Reveal)
    </span>
  </span>
}

これらの変更はチャットデモの ホストされたバージョンには存在しませんが、ReadMe にはチャットデモをビルドし、自分のキーセットから実行するための完全なインストラクションが含まれています。

まとめ

これで、Open AI を使ってアプリケーションにモデレーションとセンチメント分析の両方を追加する手軽で簡単な（そして無料の）方法ができました。

Open AIとPubNubの統合の詳細については、以下の他のリソースをチェックしてください：

OpenAI GPT APIと関数の統合
PubNubとChatGPTでチャットボットを構築する（PubNubショーケースにチャットボットを追加する）
PubNubとChat GPT / OpenAIでジオ・アプリを強化する

あなたのPubNub開発のどのような側面についても、devrel@pubnub.com、お気軽にDevRelチームに連絡するか、または私たちのサポートチームにお問い合わせください。

PubNubはどのようにお役に立ちますか？

この記事はPubNub.comに掲載されたものです。

PubNubを体験

ライブツアーをチェックして、5分以内にすべてのPubNub搭載アプリの背後にある本質的な概念を理解する

セットアップ

PubNubアカウントにサインアップすると、PubNubキーに無料ですぐにアクセスできます。

始める

PubNubのドキュメントは、ユースケースやSDKに関係なく、あなたを立ち上げ、実行することができます。

イルミネーションを使ってゲームバランスを調整する方法

PubNub Developer Relations — Wed, 03 Jul 2024 06:41:02 +0000

PubNubの最新製品リリースであるIlluminateは、ゲーム開発者、プロダクトマネージャー、プロジェクトマネージャーがPubNubプラットフォーム内で構築、反復、実験できるように構築したスケーラブルな意思決定ツールです。

優れたUIで一から設計されたIlluminateを使用することで、より良いゲーマー体験を促進し、収益化を加速させるための意思決定をリアルタイムで行うことができます。

では、ゲームバランスとは何か、リアルタイムでどのように使えるのか？

ゲームバランスとは、難易度と公平性のバランスを取ることでゲームプレイとユーザー体験を向上させるゲームデザインの一分野です。ゲームバランスは、ゲームの報酬、チャレンジ、および/または要素を調整して、意図されたプレイヤー体験を作り出します。

ゲームバランスは一般的に、プレイヤーに公平性をもたらすものとして理解されています。これには以下が含まれます；

難易度の調整
勝敗条件の変更
ゲーム状態
経済バランス

ゲームバランスの調整に関する詳しい情報はウィキペディア.

ゲームバランシングをリアルタイムで使用することで、プレイヤーを飽きさせず、新規プレイヤーを歓迎し、ゲームプレイを収益化できる可能性があります。

Illuminateはどのようにプレイヤーを夢中にさせることができますか？

前述したように、Illuminateはその場での意思決定ツールです。プレイヤーを飽きさせないために、私たちは新規プレイヤー、つまりゲームに初めて参加し、ゲームの進め方に慣れるために手助けが必要になる可能性のあるプレイヤーに焦点を当てます。

この例では、JavaScriptで書かれた昔ながらのasteroidsのコピーをPubNub関数でホストしています。PubNub関数についてはhttps://www.pubnub.co m/docs/serverless/functions/overview。

まず、シーンを設定します。

新しいプレイヤーがあなたのゲームに参加し、プレイを始めたとします。彼らは負けてしまい、進行のなさに飽き始めたとします。

パブリッシュを経由して、ゲームからPubNubにプレイヤーの進行状況とスコアをIlluminateに通知するメッセージを送ることができます。Illuminateは事前に定義された指標に基づいていくつかの決定を下し、そのプレイヤーに3つのライフを購入するか、2つのライフを得る代わりに有料プロモーションを視聴するオプションを提供するメッセージを送り返します。

画面を見てみよう。

ゲームは通常通りスタートするが、ご覧の通り、私は本当に優れたプレーヤーではなく、わずか70点で死んでしまった。

イルミネイトは私がプレイを続けられるように、この点数を受け取り、ライフを買うか、広告を見てライフを得る機会を提供するべきだと計算した。

お金を使うことを選んだ私は、ライフを買うことができ、すぐにゲームに戻ることができた。

イルミネートの舞台裏

IlluminateはPubNubのアカウントポータル https://admin.pubnub.com/、"Optimize "の下にあります。

まず最初に、Business Objectsを調べます。Business ObjectsはIlluminateにデータを取り込む方法で、どのようなデータをどこから取り込む必要があるかを定義するのに役立ちます。

メジャーを追加することで追跡したいデータを定義し、ディメンションを追加することでそのデータをどのようにセグメント化したいかを定義できます。

セットアップやIlluminateのセットアップの理解についてヘルプが必要な場合は、 https://www.pubnub.com/docs/illuminate/basics。

ゲームのバランスを取るには、何を追跡したいのか、新しいプレーヤーを引きつけるために何を提供したいのかという知識が必要です。

コーディングすることなく、変数を追加、削除、修正することで、さまざまなプレイヤーに提供するものに磨きをかけ、調整することもできる。

この単純な例では、ゲームのスコアを測定することにしたが、他の測定も簡単に追加できる；

プレーヤーはゲストか、それともゲームプラットフォームにアカウントを持っているか。
総プレイ時間
デバイスの種類 - ウェブ、モバイルテレビ
過去のイベントやゲームで、御社から何かを購入したことがあるか。

私のビジネス目標に戻り、私が取り組んでいる施策をお見せしましょう。

これを分解すると

施策：測定または加算できる数値。

次元：尺度を区分するために使用できる定性的な値。

メトリクス：選択したディメンションによってセグメント化されたメジャーの集約。

デシジョン：条件とアクションのコレクション。条件が満たされると、対応するアクションがトリガされます。

ダッシュボード：メトリクスと意思決定を視覚化するリアルタイム・チャートのコレクション。

私の例では、スコアが500点以下のときにクライアントがイルミネイトに助けを求めていることを1つの指標として使っています。

そして、これを意思決定にマッピングした：「プレーヤーが500点以下の場合、ライフを購入するか広告を見る機会を提供する。

プレーヤーが広告を見るか、ライフを購入するかを選択すると、それが指標としてフィードバックされ、ダッシュボードに表示されます。

これが私のゲームバランスダッシュボードの簡略図です。どのプレーヤーが500点未満になったか、どのプレーヤーが広告を見る代わりにライフの支払いを選択したかを追跡していることがわかります。

ここでも、複雑さを拡大する余地は非常に広い；

もしライフが安ければ、より多くのプレーヤーがライフのためにお金を払うだろうか？
30秒の広告を見るか、3分の広告を見るか？

対従来のアプローチ？

ストラテジーゲーム？オンラインゲーム？すべてのプレイヤーにゲーム体験とゲームメカニクスのバランスをとるには、長いプロセスが必要です。ローンチ前には、様々なゲーム要素をプレイテストし、導入チュートリアルを作成し、プレイヤーの行動に基づいて、プレイ時間を最大化し、ゲームが簡単すぎるのを防ぐための漸進的なレベルデザインを確保します。ローンチ後は、プレイヤーのフォーラムを監視し、プレイヤーの定着率やプレイヤーの行動を分析し、バランスの問題に対処するためのパッチをリリースします！

これは非常に長い分析とリリースサイクルになる可能性があり、Illuminateが役立つのはこの点です。ゲームの種類に関係なく、リアルタイムで決定を下すことができます：FPSやRPGのようなマルチプレイヤーゲーム、Steamのシングルプレイヤー格闘ゲーム、League of Legendsのようなバトルアリーナなどです。ビデオゲームがオンラインであり、その瞬間の行動によってプレイヤーのバランスに影響を与えることができる限り、Illuminateはプレイヤー体験を向上させることができる。

まとめ

PubNubのIlluminateを使ってゲームバランスを調整することは、あなたのアプリに即座の意思決定リアクションやツールを導入し、プレイヤー体験をより優れたものにするための、コード不要で迅速な方法です。

リアルタイムアクションを使った初めてのゲーム作成について詳しく知りたい方は、ゲーム用Illuminateページとドキュメントをご覧ください。次回のGDCカンファレンスでPubNubを使って作ったものをぜひお聞かせください！

PubNubはあなたのお役に立ちますか？

この記事はPubNub.comに掲載されたものです。

私たちのプラットフォームは、開発者がWebアプリ、モバイルアプリ、IoTデバイスのためのリアルタイムのインタラクティブ性を構築、配信、管理するのに役立ちます。

PubNubを体験

ライブツアーをチェックして、5分以内にすべてのPubNub搭載アプリの背後にある本質的な概念を理解する

セットアップ

PubNubアカウントにサインアップすると、PubNubキーに無料ですぐにアクセスできます。

始める

PubNubのドキュメントは、ユースケースやSDKに関係なく、あなたを立ち上げ、実行することができます。

Google Maps APIを使ったJavaScriptの位置情報トラッキング

PubNub Developer Relations — Fri, 31 May 2024 14:22:55 +0000

キーワードをシームレスに埋め込んだ最新のブログ記事はこちら。

Google Maps JavaScript APIとPubNubを使ってジオロケーション機能を備えたライブのリアルタイム・ウェブ・アプリケーションを作成する4つのセグメント・シリーズの完結編です。チュートリアルでは、JavaScriptとPubNubを使って飛行経路を生成するユーザーエクスペリエンスを説明します。

これがどのように実装されているかの例については、PubNubのウェブサイトにある私たちのショーケースのデモをチェックしてください。リアルタイムトラッキングでPubNubをどのように組み込むかについては、Geolocationデモに移動します。デモのコードはGithubをご覧ください。

フライトパスとは何ですか？

このチュートリアルで実装されているフライトパスはポリラインのことで、モバイルデバイスやウェブブラウザ上の地図上にユーザーが指定したポイントを通るパスを動的に描画することができます。このポリラインは、HTML5 Geolocation APIと Google Maps APIに不可欠であり、移動パターンを追跡します。

チュートリアルの概要

パート1、 2、3、、JavaScript環境のセットアップ、マップマーカーとロケーショントラッキングについて説明しました。

それができたら、次のパートに進んでください。

コードのチュートリアル

まずは let\ 変数 map\、mark\、lineCoords\ を定義して、マップ、マーカー、ポリラインの座標オブジェクトを保持することから始めましょう。こうすることで、PubNubのイベントに合わせて調整することができる。続いて、Google Maps JavaScript APIが読み込みを開始したときに使用できる initialize\ コールバックを定義します。YOUR_GOOGLE_MAPS_API_KEY`は実際のAPIキーに置き換えてください。

js let map; let mark; let lineCoords = []; let initialize = function() { map = new google.maps.Map(document.getElementById('map-canvas'), {center:{lat:lat,lng:lng},zoom:12}); mark = new google.maps.Marker({position:{lat:lat, lng:lng}, map:map}); }; window.initialize = initialize;

さて、'redraw' イベントハンドラで、geolocation の `getCurrentPosition()` メソッドを呼び出して、新しい位置情報をその場で更新します。

緯度経度

次にredrawイベントハンドラを定義し、新しい位置が変更されたイベントを受信したときに呼び出します。関数の最初の部分では、緯度と経度をメッセージからの新しい値に設定します。次に、マップ、マーカー、ポリラインオブジェクトの適切なメソッドを呼び出して、位置を更新し、線の端に追加し、マップを再配置します。

js var redraw = function(payload) { lat = payload.message.lat; lng = payload.message.lng; map.setCenter({lat:lat, lng:lng, alt:0}); mark.setPosition({lat:lat, lng:lng, alt:0}); lineCoords.push(new google.maps.LatLng(lat, lng)); var lineCoordinatesPath = new google.maps.Polyline({ path: lineCoords, geodesic: true, strokeColor: '#2E10FF' }); lineCoordinatesPath.setMap(map); };

PubNubの初期化

コールバックを定義した後、iOS、Android、JavaScript、.NET、Java、Ruby、Python、PHPなどの技術スタックにわたって携帯電話、タブレット、ブラウザ、ラップトップで動作するPubNubリアルタイム・データ・ストリーミング機能を初期化する。

js const pnChannel = "map3-channel"; const pubnub = new PubNub({ publishKey: 'YOUR_PUB_KEY', subscribeKey: 'YOUR_SUB_KEY' }); pubnub.subscribe({channels: [pnChannel]}); pubnub.addListener({message:redraw});

PubNubのリアルタイムチャネルでのトピックの公開と 購読機能は、効率的なデータストリーミング機能を提供します。

緯度/経度のパブリッシュ

この簡単なチュートリアルでは、基本的なJavaScriptのインターバル・タイマーをセットアップして、現在時刻に基づいて新しい位置をパブリッシュします。500ミリ秒ごとに、指定したPubNubチャンネルに新しい緯度経度オブジェクト（北東移動座標）をパブリッシュする匿名コールバック関数を呼び出します。あなたのアプリでは、おそらくライブのデバイスの位置やユーザーが報告した位置から位置を取得することになるでしょう。

js setInterval(function() { pubnub.publish({channel:pnChannel, message:{lat:window.lat + 0.001, lng:window.lng + 0.01}}); }, 500);

最後に、Google Maps APIを初期化して、DOM要素とJavaScriptの前提条件が満たされていることを確認します。

`js

まとめ

このチュートリアルシリーズでは、GoogleMaps APIとPubNubがウェブアプリやモバイルアプリでリアルタイムの位置情報をトラッキングするために非常にうまく連携する方法を紹介しました。これはUberや Lyftのようなライドヘイリングサービスがリアルタイムで車両の動きを表示するのと似ている。

PubNubを体験する

ライブツアーをチェックして、5分以内にすべてのPubNub搭載アプリの背後にある本質的な概念を理解してください。GitHubページやWebサイトで公開されている体験談から、ユーザーの体験を直接聞くことができます。

セットアップ

PubNubアカウントにサインアップすると、PubNubキーに無料ですぐにアクセスできます。

始める

PubNubのドキュメントは、ユースケースに関係なく、あなたを立ち上げ、実行することができます。私たちは、JavaScriptのGoogle Maps APIと私たちのSDKでリアルタイムトラッキングとそれらを使用する方法に特化したセクションがあります。

コグニティブ・サービスのユースケースを探る

PubNub Developer Relations — Fri, 31 May 2024 13:56:18 +0000

コグニティブ・サービスによって変貌を遂げたアプリや企業の例、そしてコグニティブ・サービスがテクノロジーの展望をどれほど変えつつあるのか、今後のユースケースをいくつか見ていこう。

AWS、IBM、Microsoft Azureのようなクラウド大手のコグニティブ・サービスのおかげで、あらゆる規模の開発者チームが、驚異的なパワーを持つコグニティブ・サービスにアクセスできるようになった。APIを通じて提供されるこれらのサービスにより、次世代のインテリジェンスをアプリケーションに注入することが容易になります。

チャットとソーシャル・インタラクション

2015年、チャットアプリの月間アクティブユーザー数はソーシャルネットワークのそれを上回り、その差は広がり続けている。実際、メッセージングはソーシャルネットワークそのものに不可欠な機能となっている。そして、この急速な成長とともに、メッセージングアプリは、短いテキストベースのメッセージを送受信するためのシンプルなツールから、驚くような楽しい機能を誇る革新的でフル機能のエクスペリエンスへと進化してきた。そして、そのイノベーションを推進しているのがコグニティブAPIだ。

チャットボットとコグニティブ・コンピューティング

チャットボットは、AIアルゴリズムの最も初期の形態の1つである。すぐにチューリング・テストに合格する可能性は低いが、音声対応アプリケーションの自然な進化を表している。かつてはサポート・ラインに電話をかけ、買掛金支払いのために1を押していたのが、今ではあなたの意図を識別できるシステムに完全な文章で話すことができる。

あなたが知っているかどうかにかかわらず、企業が待ち時間の短縮、顧客体験の向上、人間の電話オペレーターのコストの最小化を求めているため、チャットボットの採用は爆発的に増加している。現在、チャットボットは主に単純なタスクを処理するために使用されている。基本的な要求を理解し、事前に定義されたルールに基づいて応答する。"注文はどこですか？"や "チャットボット、ムードライトを付けてください "といった質問に答える。

しかし、Watson Assistantや Amazon LexのようなAPIを使えば、自然言語のリクエストで観察されたパターンにロジックを適用できるサービスを簡単に構築できる。これらのサービスは、例えば、離陸遅延に悩む空港からの突然の電話ラッシュを観察し、フライトの再スケジュールを優先するようにオプションの順序を変更することができる。あるいは、特定の国や地域からの電話が異なる言語で行われる傾向があることを察知し、それに応じてデフォルトを変更することもできる。また、文法的なパターンを識別して、すぐにスーパーバイザーに転送するよう顧客に指示することもできる。

音声認識、音声合成、顔認識、機械学習モデルを使用したインテリジェントな会話インターフェースは、様々な目的に応じて、非常に魅力的な体験や、まるで生きているかのような会話を提供することができる。さらに良いことに、チャットボットはそれらの経験から学習する。

チャットボットは、銀行、買い物、学習の方法を変えるだろう。レコメンデーションを行い、抽象的な概念を理解し、過去の関わりに基づいて個人を知る。最終的には、人間と話しているかどうかさえわからなくなるほど、チャットボットは優秀になるでしょう。

コード例ホームオートメーションチャットボット

WatsonとPubNub ChatEngineを使えば、スマートホームを制御する人工知能を搭載したチャットボットを簡単に作ることができます。

このチュートリアルでは、テキストコマンドを受け付け、それを解析し、それに基づいてアクションを起こすチャットボットの作り方を紹介します。例えば、ユーザーが「リビングの電気をつけて」と入力すると、ボットが電気をつけます。

{

  "homeauto_intents": 
  [
    {
      "intent":"turnOFF",
      "examples":
      [
        {"text":"Put off"},
        {"text":"Switch off"},
        {"text":"Turn off"}
      ],
      "description":"Turn on intents"
    },
    {
      "intent":"turnON",
      "examples":
      [
        {"text":"Put on"},
        {"text":"Switch on"},
        {"text":"Turn on"}
      ],
      "description":"Turn off intents"
    }

自然言語処理

データサイエンスと自然言語処理（NLP）は、大量の自然言語データを有益に処理できるAIソリューションの総称である。NLPは、意味論的な観点から単語や文法を測定するだけでなく、メッセージごとの分析を通じて、ユーザーがトピックやテーマについてどのように感じているかを明らかにし、センチメントや感情を割り出すことができる。

NLPは、数分のうちに評判が決まったり決まらなかったりする時代に、ユーザーの意見を理解し、それに対応する必要のあるブランド、公人、組織にとって、大きなメリットとなる。あるブランドが製品の新しいコマーシャルを打ち出したとしよう。適切なコグニティブ・サービスを使用することで、特定のハッシュタグや製品名に関するソーシャルメディア・ストリームを利用し、NLP APIに関連するすべてのメッセージを分析させ、製品に対する一般ユーザーの反応に関するフィードバックを提供することができる。

以下は、ツイッター上で米国の政治家について人々がどう感じたかを分析し、測定するために設計されたアプリの例である。特定のキーワードやフレーズを監視し、定義された地理的地域のユーザーの感情をプロットすることができる。

例えば、あるユーザーが "I am happy "というテキストを投稿したとする。

{
   "session_id": 1,
   "text": "I am happy!"
}

ワトソンはそのテキストを分析し、次のように返す：

{
   "session_id": 1,
   "text": "I am happy!"
   "session_sentiment": {
      "overall": 0.879998,
      "positive": {
         "count": 1,
         "avg": 0.879998
      },
      "negative": {
         "count": 0,
         "avg": 0
      },
      "neutral": {
         "count": 2,
         "avg": null
      }
   },
   "score": 0.88006828
}

ブランドはすでに、市場のセンチメント分析に多額の費用を費やしている。これらのシステムがよりインテリジェントになり、堅牢になり、自動化されれば、より低コストで一般大衆をはるかに理解できるようになるだろう。

eコマース

オンライン・ショッピングは商品の購入方法を完全に変えたが、eコマースには実店舗の重要な要素である「親切な従業員」が欠けている。オンラインストアの規模では、ライブチャットに実際のスタッフを配置することは経済的に実行可能ではありません。

その結果、多くのオンラインストアは、経験を最適化し、買い物客の質問を支援し、推奨し、チェックアウトするために、インテリジェントなショッピングアシスタントボットに目を向けています。

Nordstromは、単純な事前定義された質問と答えを超えて、顧客が何を探しているかを真に理解し、必要に応じて支援するためにコグニティブサービスを使用したメッセンジャーチャットボットで、以前のホリデーシーズンを席巻しました。このチャットボットは、おすすめのギフトを提案し、注文を完了する手助けをすることもできる。

チャットボットはまた、簡単な問題に対処するために担当者を1時間も待たせる、カスタマーサポートの恐ろしい電話から私たちを救ってくれる。アマゾンはチャットボットを配備しており、ほとんどの顧客が注文に関して助けを必要としているときに抱える些細な問題を解決することができる。

さて、今日の現実世界におけるインテリジェンスの例をいくつか見てきたところで、未来を覗いて、コグニティブ・サービスが将来どのように私たちの世界を変えていくかを見てみよう。

スマートシティ

未来の都市は、より安全で、より効率的で、より環境に配慮したものにするために、さまざまな統合インテリジェント・サービスに依存するようになるだろう。画像認識、コンピュータ・ビジョン、ビジョンAPIは、この変革において重要な役割を果たし、都市空間内の画像を処理してアクションを起こす。

農業

世界の人口は増加の一途をたどっており、数十億の人々に食料を供給することは、今後数年間でかなりの課題となる。コグニティブ・サービスは、畑や工場を管理する上で重要な役割を果たし、インテリジェントな決定を下し、これまでにない精度でリソースを制御できるようになる。

スマートファームとIoTは、できるだけ多くの貴重なデータポイントを組み込んで、一見直感に反するようなものであっても、インテリジェントな農業上の意思決定を行う。例えば、リアルタイムの気象データ、遠隔センサーデータ、過去の実績を集約することで、コグニティブサービスは個々の灌漑計画を完璧なものにし、毎日固有の状況に合わせて更新することができる。

データ・セキュリティ

コネクテッド化が進み、デジタル・ライフが物理的なライフを凌駕するにつれ、データ・プライバシーとセキュリティは、漠然と意識するものから、不穏で常に存在する個人的脅威へと変化している。

規制や規則-HIPAA、GDPR、SOC II-は、企業や組織が適切なガードレールを確保するための1つの方法です。このような複雑な規制を詳細に実施するのは大変なことだが、そこで機械学習が活躍する。

コグニティブ・サービスは、規則や規制を理解し、理解できるように訓練し、コンプライアンスを達成するための方法を提案することができる。コグニティブ・サービスは、関連する規則や法律からコンテンツのモデレーションに至るまで、データ・セキュリティに関する貴重な洞察を提供することを可能にします。

ヘルスケア

ヘルスケア業界では、厳しいマージン、厳しい規制、サイロ化された研究開発など、いくつかの理由により、イノベーションの進展が他業界よりも遅いのが一般的です。コグニティブ・サービスは、イノベーションの障壁を取り除き、組織から患者までのデリバリー・システムを改善する機会を提供する。

医療における意思決定は通常、患者ごとにサイロ化された形で行われる。対照的に、コグニティブ・サービスは、健康に影響を与える要因（社会経済的状況、環境、医療へのアクセスなど）を包括的に分析し、それに基づいて行動する。コグニティブ・サービスは、健康やウェルネス・プログラムなど、より的確で的を絞った患者ケアを医師に推奨することができる。

コグニティブ・サービスは、医療機関内の既存システムの統合と接続を推進し、本質的な洞察を引き出すことができる。データを集約し、利害関係者のニーズを結びつけることができるようになったことで、組織はより効率的な運営を行いながら、より良いケアを提供することができる。

インテリジェンスの今

この記事では、コグニティブ・サービスがビジネスに対する考え方やアプリケーションが果たす役割をどのように変えていくのか、そのほんの一例を紹介したに過ぎない。これまでは、ソフトウェアは指示に従った。コグニティブ・サービスによって、ソリューションは適応し、進化し、ほんの数年前には不可能と思われたようなことを成し遂げることができる。すべての意味を見通すことはできませんが、私たちが知っている限りでは、ビジネスへの影響が大きく、ポジティブなものになることは間違いありません。

PubNubはどのようにお役に立てるでしょうか？

この記事はPubNub.comに掲載されたものです。

PubNubのプラットフォームは、開発者がウェブアプリ、モバイルアプリ、IoTデバイス向けにリアルタイムのインタラクティブ機能を構築、提供、管理できるよう支援します。

PubNubを体験

ライブツアーをチェックして、5分以内にすべてのPubNub搭載アプリの背後にある本質的な概念を理解する

セットアップ

PubNubアカウントにサインアップすると、PubNubキーに無料ですぐにアクセスできます。

始める

PubNubのドキュメントは、ユースケースやSDKに関係なく、あなたを立ち上げ、実行することができます。

GitHub ダッシュボードのコミットをリアルタイムで追跡する

PubNub Developer Relations — Thu, 30 May 2024 19:24:39 +0000

ソフトウェア開発の領域では、リアルタイムのC3.jsチャートが組織内の活動を監視する効果的な方法を提供します。エンジニアリング・チームにとって、追跡可能なメトリクスの一つは GitHub のコミットです。このブログでは、GitHub の API を利用して GitHub のコミット・データを取得し、リアルタイムでインタラクティブなグラフに表示する方法を説明します。HTML、Javascript、CSSのパワーを活用し、PubNubを使ってGitHubダッシュボードを作成し、コミットデータをストリーミングします。

リアルタイムの C3.js チャートについては、素晴らしいチュートリアルがあります。では、さっそく見ていこう！

リアルタイム GitHub ダッシュボードの作り方

リアルタイム GitHub ダッシュボードを作るには、GitHub リポジトリのような様々なデータソースに接続し、必要な依存関係を処理する必要があります。セキュアなコーディングやデータの暗号化など、必要なサイバーセキュリティ対策を意識しましょう。業界標準のセキュリティ・プロトコルに従うことは必須です。

ステップバイステップのガイドはこちら：

GitHub ウェブフックを追加する

ウェブフックをセットアップするには、以下の手順に従ってください：

GitHub リポジトリを作成するか、既存の git リポジトリを使用する。
ページの右側にある 'Settings' をクリックします。
ページの左側にある 'Webhooks' をクリックします。
右上の 'Add Webhook' をクリックします。
GitHub がパスワードを要求しますので、入力してください。
Payload URL'の下に:http://pubnub-git-hook.herokuapp.com/github/ORG-NAME/TEAM-NAME と入力します。ORG-NAME は組織名に、TEAM-NAME はレポを管理しているチームに置き換えてください。

ビジュアル・ダッシュボードを読み込む

このページにアクセスしてください。PubNubダッシュボード経由で送信されたすべてのコミットのリストが表示されます！GitHub にコミットをプッシュすると、数十ミリ秒以内に GitHub のコミットダッシュボードにメッセージが表示され、グラフがリアルタイムで更新されます。

Github コミットダッシュボードの作り方

このダッシュボードは、GitHub、PubNub Data Stream Network、C3.jsによるD3チャートビジュアライゼーションをマッシュアップしたものです。コミットがGitHubにプッシュされると、コミットのメタデータは小さなHerokuインスタンスに投稿され、PubNubネットワークに公開されます。私たちはGitHubのページでダッシュボードのページをホストしています。

HerokuインスタンスはGitHubからコミットデータを受け取ると、pubnub-gitというチャンネルでpublicなpublish/subscribeキーを使ってPubNubにそのデータの概要をpublishします。pubnub-git チャネルは、開発者コンソールで監視することができます。

これがメッセージのペイロードの例です：

{ 
  "name":"drnugent",
  "avatar_url":"https://avatars.githubusercontent.com/u/857270?v=3",
  "num_commits":4,
  "team":"team-pubnub",
  "org":"pubnub",
  "time":1430436692806,
  "repo_name":"drnugent/test"
}

マジックの後半は、ダッシュボードがsubscribe コールバックを通してこの情報を受け取るときに起こります。ダッシュボードのソースを見ると、このようなコードがあります：

pubnub.subscribe({
  channel: 'pubnub-git',
  message: displayLiveMessage

});

この subscribe 呼び出しによって、pubnub-gitチャネルでメッセージを受信するたびに JavaScript の関数displayLiveMessage()が呼び出されるようになります。displayLiveMessage() はコミットのプッシュ通知をログの先頭に追加し、C3 の可視化チャートを更新します。

しかし、ダッシュボードが最初にロードされたとき、どのように入力されるのでしょうか？

PubNub Storage & Playback APIをダッシュボードに活用する

PubNubは送信された各メッセージの記録を保持し、Storage & Playback（History）APIを使用してそれらの保存されたメッセージにアクセスする方法を開発者に提供します。ウェブダッシュボードの奥深くに、次のようなコードがあります：

var displayMessages = function(ms) { ms[0].forEach(displayMessage); };

pubnub.history({
  channel: 'pubnub-git',
  callback: displayMessages,
  count: 100
});

これは、pubnub-git チャンネルで送信された直近の 1,000 通のメッセージを取得するためのリクエストです。つまり、これらのメッセージが送信されたときにウェブダッシュボードがオフラインだったとしても、それを取得し、そのデータを使ってあたかもダッシュボードが常時オンラインであったかのように表示することができるのです。

この機能は、携帯電話ネットワーク上のモバイル・アプリやコネクテッド・カーなど、接続が断続的で不安定なデバイスを扱う場合に特に有効だ。PubNubネットワークのおかげで、私たちの可視化ダッシュボードはアプリケーションの状態を保存するバックエンドを必要としません。

独自のGitHubダッシュボードを構築する

Githubダッシュボードのビルドを開始するには、github.comのGit Commit UIリポジトリをフォークし、READMEに従ってセットアップ手順を確認してください。オープンソースコミュニティのコラボレーションの一環として、プルリクエストを歓迎します。

リアルタイムダッシュボードの今後の動向と発展

リアルタイム・ダッシュボードと関連技術の最後のトレンドと開発に目を向け続けることは非常に重要である。リアルタイムデータ伝送のためのウェブソケット、即時の洞察のための通知の使用、様々なワークフローでのリアルタイムダッシュボードの使用などが含まれます。

PubNubの体験

PubNubは多くのクライアントがリアルタイムアプリケーションで成功を収めるのを支援してきました。例えば、LinkedInのリアルタイム通知システム...

セットアップ

PubNubアカウントにサインアップすると、PubNubキーに無料ですぐにアクセスできます。PubNubアカウントで利用可能な最新機能には...

始める

私たちの包括的なPubNubドキュメントは、ユースケースやSDKに関係なく、すぐに立ち上げて実行することができます。

PubNubは、ユーザーエクスペリエンスを向上させるユーザーフレンドリーなプラットフォームを提供します。私たちのサービスは、シームレスな統合プロセスのために開発者を念頭に置いて設計されています。

私たちはあなたのリアルタイム開発の旅をよりスムーズで効率的にするためにここにいることを忘れないでください。ペイロードのURLを設定して、始めましょう！

公式ドキュメントや権威ある情報源は、情報の妥当性を確認するためにブログ記事全体で参照することができます。

PubNubはどのようにお役に立ちますか？

この記事はPubNub.comに掲載されたものです。

PubNubを体験

ライブツアーをチェックして、5分以内にすべてのPubNub搭載アプリの背後にある本質的な概念を理解する

セットアップ

PubNubアカウントにサインアップすると、PubNubキーに無料ですぐにアクセスできます。

始める

PubNubのドキュメントは、ユースケースやSDKに関係なく、あなたを立ち上げ、実行することができます。

BizOps Workspaceでチャットとユーザーを安全にモデレートする方法

PubNub Developer Relations — Thu, 23 May 2024 09:52:03 +0000

このハウツー記事は、BizOps Workspaceと総称されるPubNubのデータ管理機能について説明する一連の記事の一部です：

BizOps Workspaceは、アプリケーションの管理に役立つ一連のツールです。この記事では、前回の「BizOps Workspaceで会話を監視してモデレートする方法」を発展させ、手動モデレーション機能、つまりリアルタイムで会話を監視し、ユーザーをミュートまたは禁止する機能を備えたエンドツーエンドのセキュアなチャット・アプリケーションを紹介します。

この記事は単独でも読むことができますが、ここで説明するコンセプトの背景をよりよく理解するために、前回の「BizOps Workspaceで会話を監視してモデレートする方法」の記事を読むことを強くお勧めします。

チャネルモニタとは何ですか？

チャンネルモニターは、チャットモデレーターが複数のチャンネルでリアルタイムに行われている会話のライブプレビューを見ることができます。もしモデレーターが、行儀の悪いユーザーや攻撃的なメッセージなど、何か不穏なものを発見したら、問題を緩和するためにすぐに行動することができます。

モデレーターは、どのようなアクションを取るかについて、多くの柔軟性を持っています：

アクセス権を制限せずにユーザーを観察する
問題のあるメッセージを編集または削除する
そのユーザーのメッセージ公開を制限する（ミュートする）
メッセージの閲覧または公開を制限する（禁止する）

Monitor "機能では、手動でメッセージを確認したり、手動でユーザーをミュートしたりすることができます。この記事では自動モデレーションについては説明しません。

チャネルモニタを使用するには、PubNubキーセットでいくつかの機能を有効にする必要があります。特に、App contextと Message persistenceは最低限必要です。詳細については、前の記事の「Channel Monitorのキーセットの要件」を参照してください。

PubNubアクセスマネージャとは何ですか？

開発者は、モデレーションシステムを回避しようとするユーザーから保護する必要があります。これはPubNubアクセスマネージャを使用して実現されます。

アクセスマネージャを使用すると、指定されたユーザー（または複数のユーザー）の権限と、指定されたリソースに対して実行できるアクションを記述する一連のルールを定義できます。例えば

IDが123のユーザはチャネル456の読み書き権限がある。
IDが正規表現user-*に一致するすべてのユーザは、IDが正規表現global-*に一致するすべてのチャネルから読み取ることができます。
IDが123のユーザはチャネルのメタデータを更新する権限を持っています。

パーミッションの完全なリストについては、https://www.pubnub.com/docs/general/security/access-control#permissions のドキュメントを参照してください。

PubNub Access Managerはトークンベースであり、それを説明する最も簡単な方法は、ドキュメントに示されているように認可フローを歩き、そのフローがモデレーションにどのように関連しているかについて追加のコンテキストを提供することです：

ログインの試み。クライアントは、ユーザをアプリケーションにログインさせるために、サーバに対して認証を行います。これはおそらくIDプロバイダを介して行われます。このステップの後、サーバは登録されたアプリユーザと話していること、そしてそのユーザが誰であるかを確信します。クライアントは初期化の一環としてPubNub Access Manager認証トークンを要求します。
許可リクエスト。サーバはSDKの'grantToken()'APIを呼び出して、クライアントからのトークン要求を処理します。このAPIについて注意すべき点があります：このAPIはPubNub*シークレットキーでのみ*呼び出すことができるため、サーバーからのみ呼び出すことができます。このAPIはすべてのサーバーサイドSDKで利用可能です。
トークンが返されます。PubNubは要求されたユーザに要求されたパーミッションを許可し、認証トークンをサーバに返します。
トークンが渡されます。サーバは認証トークンを元の呼び出し元のクライアントに返します。
トークンが設定されます。クライアントは、初期化時あるいはアプリケーションのライフサイクル中の任意の時点で、setToken()メソッドを使用してこの認証トークンを指定できます。トークンの有効期限が切れるため、トークンをいつでも更新できることは重要ですが、チャンネル・モニターが権限を更新した場合（ミュートされたり禁止されたりした場合）にも、クライアントは新しいトークンを要求する必要があります。
許可されたAPIリクエスト。その後のPubNubへの呼び出しはすべて認可されたものとみなされます。PubNubは、ステップ2で付与されたパーミッションとクライアントのトークンの有効性に基づいて、あらゆるAPIリクエストを許可または拒否します。

セキュアなモデレーション・ソリューションとはどのようなものか？

前回の記事の最後の方で、クライアント側からミュートや禁止がどのように見えるかのデモを示しました。チャット SDK には、クライアントがミュートされたか禁止されたかを伝えるモデレーションイベントが含まれていますが、UI を更新する以外に、クライアントがミュート/禁止されてもメッセージを送信し続けることを防ぐことはできません。クライアントを安全にミュートまたはBANするには、既存のAccess Manager権限を取り消し、新しいミュートまたはBANステータスを反映する新しい権限を付与する必要があります。

あるユーザーが'musicals'チャンネルからミュートされている場合を考えてみましょう：

あるユーザが「movies」と「musicals」の2つのチャンネルにアクセスできるが、管理者は「musicals」チャンネルからのみミュートしたい。
モデレーターはチャンネルモニターを使ってユーザーをミュートする。これは裏を返せば 'setRestrictions()' API を呼び出していることになる。
サーバアプリケーションは 'mute' 通知をモデレーションイベントで受け取り、そのユーザのアクセストークンを失効させる。
クライアントアプリケーションは、'musicals' チャネルに関連付けられた 'mute' 通知を節度イベントを通して受け取ります。
アプリケーションはUIを更新し、それ以上メッセージを送信しないようにする。ユーザはページのJavaScriptを修正することで、このUIの変更を回避できますが、認証トークンが失効しているため、メッセージを送信しようとすると失敗します。
上記のAccess Managerのセクションで説明したように、アプリケーションはサーバに新しい認証トークンを要求します。新しく付与されたトークンには、ユーザの新しい権限が反映され、'musicals' チャネルへの 'read' アクセス権のみが付与されます。

前回の記事では、"モデレーションソリューションのコンポーネント "について説明し、クライアントとサーバーの両方で利用可能なAPIを以下の図を使ってリストアップしました。上記のステップで説明したAPIは、この図にも示されています。

チャットSDKサンプルアプリ

チャンネルモニターとチャットSDKの開発を担当した同じ多忙なエンジニアリングチームは、チャットSDKを使用するReact Nativeで書かれたサンプルアプリケーションも作成しました。

このサンプルは、PubNubを使用して現実的で完全な機能を備えたチャットアプリを開発するためのSDKの機能とベストプラクティスを示しています。このサンプルはオープンソースで、/samples/react-native-group-chatにあるChat SDKと同じGitHubリポジトリの一部です。

このアプリケーションは最近更新され、Access Managerサーバからトークンを要求するようになりました。また、ユーザのパーミッションが変更されたとき、つまりチャネルから禁止されたりミュートされたときに新しいトークンを要求するようになりました。この改良は前回の記事を書いてから行われたので、GitHubから最新のソースを入手してください。この記事を書いている時点の最新の git commit ID はae9dfa0です。

ユーザーのミュートと禁止を安全に行うサンプル・アプリケーションを使ったデモ

このセクションでは、クライアントとサーバーの両方の視点からセキュアなモデレーションを示すエンドツーエンドのデモを立ち上げて実行する方法について説明します。

PubNubキーセットの作成

このデモを実行するには、次のように新しいPubNubキーセットを作成することをお勧めします：

管理者ポータルにログインし、新しいアプリケーションを作成するか、既存のアプリケーション内に新しいキーセットを作成します。管理者ポータルにログインし、新しいアプリケーションを作成するか、既存のアプリケーション内に新しいキーセットを作成します。必要に応じて、管理者ポータルキーの作成方法をご覧ください。
キーセットのページで、以下の構成オプションを有効にします。特に指定がない限り、デフォルトを受け入れることができます：

アプリ・コンテキスト。これはチャネルとユーザに関するメタデータを保存するもので、「ユーザとチャネルの管理」についての前の記事で詳しく説明しています。 User Metadata Events（ユーザ・メタデータ・イベント）、Channel Metadata Events（チャネル・メタデータ・イベント）、Membership Events（メンバーシップ・イベント）も有効にしてください。
メッセージの永続化。これはメッセージの履歴をPubNubに保存し、管理者が会話を確認、編集できるようにします。
アクセスマネージャ。データへの不正アクセスを防止し、安全なモデレーションソリューションを作成するために必要です。
プレゼンス。ユーザーがオンラインかオフラインかを追跡するために使用されます。

変更を保存します。

以降のステップで、Publish Key、Subscribe Key、およびSecret Keyが必要になります。

サンプルアプリケーションのビルド

前述したように、チャット SDK サンプルアプリは、Expo フレームワークを使用して React Native で記述されたクロスプラットフォームのクライアントアプリです。

アプリケーションの Readme に記載されている手順に従って、サンプルアプリケーションをクローンしてビルドします。特に、yarnやNode.jsなどの前提条件がインストールされていることを確認してください。 ReadMeにはXCodeとiOSの使用について書かれているが、Androidエミュレーター上でアプリを実行することもできる。執筆時点の最新のgitコミットIDはae9dfa0です。

Pub/Subキーを提供する際は、前のステップで生成したキーを使用してください。 .envファイルにキーを含めない場合、アプリケーションはデフォルトでいくつかのデモキーになります。混乱を避けるために、https://github.com/pubnub/js-chat/blob/ae9dfa0/samples/react-native-group-chat/App.tsx#L60、このロジックを無効にするとよいでしょう。

アプリケーションを実行します。ReadMeではyarn iosを実行するように指示されていますが、yarn androidや yarn run startを実行することもできます。

ログインすると、コンソールに次のような警告が表示されるはずです：

これはクライアントがAccess Managerサーバーへの接続に失敗したためです。

サンプルAccess Managerサーバーの構築

Sample Access Manager Serverはhttps://github.com/pubnub/js-chat/tree/master/samples/access-manager-api。これは前回説明したクライアントアプリケーションと同じmonorepoです。

src/chatsdk.service.tsファイルをお好みのエディタで開き、publishKey、subscribeKey、secretKeyを入力してください。 publishKeyとsubscribeKeyは、クライアント・アプリをビルドする際に使用したものと一致させる必要があり、secretKeyは、管理ポータルのアプリのkeysetページから入手できます。

REPO/samples/access-manager-apiディレクトリからyarn run startを実行してAccess Managerサーバーを起動すると、以下のような画面が表示されるはずです：

Access Managerサーバーが何をしているかを見るには、app.service.tsを見てください。リクエスト・ユーザー用に生成されたパーミッション構造と、これらのパーミッションを適用するためのchat.sdk.grantToken()の呼び出しが表示され、生成されたauthKeyが呼び出し元のクライアントに返されます。

これらはデモ・アプリケーションが必要とするパーミッションですが、あなたのアプリケーションはおそらく異なるパーミッションを必要とするでしょう。この提供されたルールセットを開始テンプレートとして使用することができますが、アプリ用の Access Manager サーバーを作成する際には、https://www.pubnub.com/docs/chat/chat-sdk/build/features/users/permissionsを参照して、どの Chat SDK 機能でどのパーミッションが必要かを正確に理解してください。

クライアント・デモ・アプリを再起動すると、エラーなしでログインできるようになります。 Authkey refreshed（認証キーが更新されました）」というトーストが表示されれば、すべて成功です。

2つのクライアント間で会話を開始してください。

チャンネルモニターを使用してユーザーをミュートおよび禁止する

重要：2つのクライアント間で会話を開始したことがない場合は、今すぐ行ってください。チャンネルはデモアプリによって動的に作成されるため、チャットが開始された後にのみチャンネルモニターに表示されます。

auth key refreshed'バナーや'banned user'モーダルなど、以下に表示されるユーザーインターフェースのアップデートは、デモアプリケーションの一部であることに注意してください。

管理者ポータルにログインしてチャネルモニターを起動し、Access Managerサンプルとクライアントアプリケーションで使用したキーセットを選択します。
左側のナビゲーション・パネルの［BizOps Workspace］セクションに移動し、［Channel Monitor］を選択します。 BizOpsWorkspaceセクションが表示されない場合は、PubNubプランをアップグレードする必要があります。
モデレーションを開始するチャンネルを選択するプロンプトが表示されます。チャンネル名は1:1 user with USER_IDになります。USER_IDは会話を開始した人のユーザー名です。
キーセットでパーシステンスを有効にしている場合、チャンネルメッセージは以前のメッセージも含めてリアルタイムで表示されます。

そのユーザーが送信したメッセージの横にあるマイクボタンを押して、そのユーザーをミュートします。ミュートされたユーザーのデバイスに、認証キーがリフレッシュされたことを知らせるメッセージが表示されます。ミュートされたユーザーとしてメッセージを送信しようとすると、ミュートを解除したユーザーには影響がありませんが、禁止されているというメッセージダイアログが表示されます。

マイクボタンをもう一度押して、ミュートを解除してください。ミュートを解除されたユーザーのデバイスに、認証キーがリフレッシュされ、メッセージ送信が成功したことを知らせるメッセージが表示されます。

そのユーザーが送信したメッセージの横にある禁止ボタンを押して、そのユーザーを禁止してください。理由は自由形式のテキストなので、関連する情報を入力できます。認証キーが更新され、ユーザーはアプリのチャット選択画面に戻ります。

禁止されたチャンネルにアクセスしようとすると、ユーザーにエラーが表示されます：

チャンネルモニターで「禁止を解除」を選択して、ユーザーを禁止解除してください。認証キーが更新されます。ユーザーはBANが解除され、再びチャットにアクセスできるようになります。

まとめ

チャットアプリケーションの開発は最初のステップに過ぎません。最も困難な課題は、拡大するユーザー・ベースをサポートするためにアプリをデプロイした後にやってきます。BizOps Workspaceは、チャットアプリケーションのあらゆる側面を管理するために設計されたツールセットであり、ローンチ後の課題を簡素化します。

この記事では、ユーザーの安全なミュートと禁止に焦点を当てましたが、BizOps Workspaceの機能はさらに拡張していきます。また、本記事ではChat SDKのみに焦点を当てましたが、Channel Monitorは当社のどのSDKでも動作するように設定することもできます。

ヘルプやサポートが必要な場合は、お気軽に専任のサポートチームにご連絡いただくか、開発者対応チーム（devrel@pubnub.com）までメールでお問い合わせください。

PubNubはどのようにお役に立ちますか？

この記事はPubNub.comに掲載されたものです。

PubNubを体験

ライブツアーをチェックして、5分以内にすべてのPubNub搭載アプリの背後にある本質的な概念を理解する

セットアップ

PubNubアカウントにサインアップすると、PubNubキーに無料ですぐにアクセスできます。

始める

PubNubのドキュメントは、ユースケースやSDKに関係なく、あなたを立ち上げ、実行することができます。

Unityゲームにリアルタイムチャットを追加する方法

PubNub Developer Relations — Thu, 16 May 2024 21:14:49 +0000

リアルタイムチャットまたはゲーム内チャットは、プレイヤーのエンゲージメントを高め、ユーザーの定着を助けます。リアルタイムチャットは、プレイヤー同士のコミュニケーションを可能にし、コミュニティ意識を育み、より楽しいゲーム体験を可能にするソーシャルインタラクションのプラットフォームを提供します。

リアルタイムチャットを取り入れることは、言うは易く行うは難しです。ゼロから始めるには、構築、維持、そしてプレイヤー数の増加に伴う拡張に多くのリソースが必要です。幸いにも、PubNubは私たちのリアルタイム、低遅延APIプラットフォームでUnityゲームにリアルタイム機能を注入することがこれまで以上に簡単になりました。Windows、Mac、iOS、Android、OculusやMeta Questのようなバーチャルリアリティシステム、またはクロスプラットフォーム向けに開発しているかどうかにかかわらず、私たちのUnity SDKはあなたをカバーしています。

PubNubを使用してUnityビデオゲームにリアルタイムチャットを追加する方法を学び、異なるチャネルパターンを設定する方法を理解することから始め、メッセージを送受信する方法を学び、モデレーション、絵文字、リアクション、GIFなどの他の機能を使用してゲーム内のチャットを強化/保護します。

PubNubを始める

ゲーム内チャットの設定方法を理解する前に、PubNubプラットフォームと、プラットフォームの機能を利用するためのアプリケーションの設定方法を理解する必要があります。

概要

PubNubはPub/Sub（Publish/Subscribe）モデルに基づいています。ユーザーは、基本的にすべての関連情報を含むペイロードであるメッセージをPubNubネットワークに公開します。メッセージを受信したい、または聞きたいユーザーはPubNubネットワークにサブスクライブし、メッセージを解析します。メッセージには、32KB以下であれば（そしてできればJSONであれば）、好きなものを含めることができます。

メッセージが正しい受信者に確実に届くように、あるデバイスから別のデバイスにデータが送信されるメカニズムとしてチャネルが使用されます。チャネルは、デバイスがPubNubネットワークにパブリッシュしたりサブスクライブしたりするたびに必要になります。ユーザーが一度に発行できるメッセージは1つだけですが、ユーザーは一度に多くの異なるチャンネルを購読し、さまざまなメッセージを聞くことができます。

メッセージを公開するときには正確なチャンネル名を指定する必要がありますが、多重化によって一度に複数のチャンネルを購読することができます。多重化とは、チャンネル名を文字列の配列として指定することによって、1つ以上のチャンネルを購読することです。

なぜこの情報が必要なのでしょうか？ゲーム内のメッセージングシステムはすべてチャンネルの概念に基づいています。チャンネルパターン名をどのようにフォーマットして保護するかによって、どのような種類のチャットが必要になるかが決まります。

PubNub Unity SDKのインストールと設定

開始するには、アプリケーションをPubNubネットワークに接続するためにPubNub Unity SDKを設定する必要があります。詳細についてはUnity SDKのドキュメントを参照してください：

パッケージマネージャを介してUnityパッケージを追加します。
無料のPubNubアカウントを作成し、PubNubキーを取得します。アプリケーションに必要なキーセットの機能を有効にすることが重要です - 重要なPub/Sub機能については、単にStream Controllerを有効にする必要があります。重要なPub/Sub機能については、Stream Controllerを有効にするだけです。高度な機能のために設定する必要があるその他の設定については、後ほど説明します。
前のステップで取得したPublishキーとSubscribeキーをUnityに渡してPubNub GameObjectを設定します。すべてのPubNubオブジェクトはPubNubへの接続を確立するために一意の識別子を必要とするため、UserIdも提供する必要があります。そうしたら、PubNubオブジェクトを初期化します：

using PubnubApi;
using PubnubApi.Unity;
…
PubNub pubnub = new Pubnub(pnConfiguration);

イベントやメッセージに反応するようにゲームのイベントリスナーを追加します。各タイプのメッセージやイベントに応答するカスタムロジックを実装できるように、さまざまなイベントリスナーがありますが、チャットメッセージを交換する中核的な機能については、単にメッセージイベントリスナーが必要です（このガイドの後半で、より魅力的にするためにリアルタイムチャットに追加機能を追加する方法を学びます）：

var listener = new SubscribeCallbackListener();
pubnub.AddListener(listener);
listener.onMessage += OnPnMessage;
…
private void OnPnMessage(Pubnub pn, PNMessageResult<object> result) {
    Debug.Log($"Message received: {result.Message}");
}

他のデバイスにメッセージを送信するためにパブリッシュを開始し、パブリッシャーからメッセージを受信するためにサブスクライブを開始する前に、チャンネル名を定義する必要があります。覚えておいてください: チャネルパターンをどのようにフォーマットするかによって、実装するチャットの種類が決まります。

異なるチャットパターンの定義

あなたのゲームに実装するチャットの種類を検討する必要があります。このセクションは、チャンネルが従うべきパターンについて説明するものであり、ゲームやユーザーから必要な情報を取得するためのセットアップ全体について説明するものではありません。PubNubを使用するUnityプロジェクトでさまざまなチャットパターンを見たい場合は、Unity Showcase Gameをご覧ください。

オール/グローバルチャット

オールチャットまたはグローバルチャットは、ゲーム内のすべてのプレイヤー間のコミュニケーションを可能にします。すべてのプレイヤーが購読している共通のチャンネルでメッセージを公開、購読することで一般的なチャットを設定できます。グローバルプレイヤー用のチャンネル構造を設定できます：

string allChat = “global”;

各クライアントがチャンネルを購読することで、全員が同じメッセージをリアルタイムで受信できるようになり、全員が参加できる共有チャット体験が生まれます。

プライベート/ウィスパーチャット

プライベートまたはウィスパーチャットでは、プレイヤー同士が一対一の会話をすることができます。プライベートまたはウィスパーチャットチャンネルパターンでは、各ユーザーがプライベートな会話を目的としたチャンネル構造をサブスクライブします：

string privateChatBase= “chat.private.*”;

これは、ワイルドカードサブスクライブのコンセプトを使用しています。この機能は、階層化されたチャネルのリストを購読するために使用することができます。

例えば、あるユーザが他のユーザにプライベートでメッセージを送信しようとする場合、PubNubネットワーク内でユーザを識別する一意な識別子を表す現在のPubNubユーザID（またはUUID/uuid）とメッセージの受信予定者のユーザIDを連結します。現在のユーザのユーザIDは（pubnub.GetCurrentUserId()で）常に取得できますが、意図する受信者のユーザIDを取得する必要があります。受信者のユーザIDを取得したら、チャネルを次のように連結することができます：

string privateChatMessage = “chat.private.user-a-uuid&user-b-uuid”;

chat.private.* のようなワイルドカードチャネルパターンを指定しているので、アプリはそのパターンにマッチするすべてのチャネル名を購読します。これにより、実行時にチャンネル名を常に知っておく必要がなくなります。最後に、ユーザ ID を使用することで、チャンネル名が一意になり、2人のユーザ間で会話が行われることが保証されます。

フレンド/バディチャット

フレンドチャットやバディチャットを作成することで、プレイヤーはより親密な関係を築きたい特定のプレイヤーとプライベートなコミュニケーションをとることができます。

フレンド/バディチャットパターンでは、ユーザーIDを追加してプライベートチャットチャンネルパターンを作成するのと同じように、各デバイスやプレイヤーに固有のチャンネルパターンを作成する必要があります：

string chanFriendChat = "chat.friends.” + pubnub.GetCurrentUserId();”

chanFriendChat文字列内のユーザーIDをpubnub.GetCurrentUserId()で置き換えます。これでチャンネルパターンは揃いましたが、単純にchat.friends.*のようなワイルドカードパターンを使って購読することはできません。

この問題を解決するのがPubNubのチャンネルグループで、一度に多数のチャンネルを管理することができます。チャンネルグループは基本的にチャンネルのリストへのポインタです; この場合、チャンネルグループはプレイヤーに固有で、プレイヤーの友達全員への参照を含みます：

string chanGroupFriendChat = "chanGroupFriendChat_" + pubnub.GetCurrentUserId();

注: チャンネルグループ名はチャンネル名と同じ規則に従いますが、名前にピリオドを含めることはできません。

pubnubオブジェクトでチャンネルをサブスクライブする方法（次のセクションで説明します）と同様に、チャンネルグループも同時にサブスクライブすることができます。つまり、プレイヤーはフレンドのChannel Groupにサブスクライブしているので、新しいフレンドが追加されるたびに、そのフレンドのChanFriendChatはプレイヤーのフレンドのChannel Groupに追加され、それらのチャネルのいずれかがメッセージをパブリッシュするたびに、Messageイベントリスナーでメッセージを受け取ることになります。Channel Group にパブリッシュすることはできませんが、Channel Group 内の関連チャンネルにメッセージをパブリッシュすることはできます。

PubNub Unity SDKのChannel Groups APIを使用すると、あなたが権限を持つチャネルグループから友人/チャネルを追加、リスト、および削除することができます。チャンネルグループ機能は、プレゼンスとして知られているフレンドもオンライン/オフラインになるタイミングを決定するためにも使用されます。これについてはUnityのフレンドリスト追加方法ガイドで詳しく説明します。

ギルド/アライアンス/クランチャット

ギルド、アライアンス、クランが登場するゲームでは、専用のチャット環境がチームの連携や仲間意識に大きく役立ちます。このスタイルのグループチャットは、複数のユーザー間でのコミュニケーションを可能にし、フレンドだけでなく、より多くのプレイヤー間での協力やチームワークを促進します。ギルド/アライアンス/クランチャットでは、同じグループのメンバーが戦略を練ったり、成果を共有したり、あるいは単にゲーム内でより個人的なコミュニティを形成するために絆を深めることができます。

PubNubでこれを設定するには、フレンド/バディチャットを実装するのと同じコンセプトです。各タイプのチャンネルグループを作成し、そのチャンネルグループに登録し、承認されたらそのチャンネルグループにフレンドを追加します。これらのチャンネルグループに関連付けられたチャンネルに公開されたメッセージはイベントリスナーをトリガーし、適切にチャットを表示することができます。

各プレイヤーのチャンネルグループは2000チャンネル（この場合はプレイヤー）を管理することができ、大規模なオンラインゲームの最大のギルドでも十分すぎるほどです。さらに、PubNubネットワークに接続されている個々のクライアントは10チャンネルグループを持つことができ、必要に応じて20,000チャンネルを購読することができます。

パーティー/ロビーチャット

パーティーチャットやロビーチャットは、特定のゲームセッションやミッションのために結成された小規模で一時的なグループに対応しています。これらのスタイルのチャットは異なる目的を意図していますが、その実装はプライベート/ウィスパーチャットチャンネルを作成するパターンに似ています。

まず、それぞれのグループチャットのベースとなる文字列を作成します。チャネルの配列にサブスクライブするとき（次のステップで説明します）、すべてのリクエストをリッスンするためにワイルドカードサブスクライブを使います：

string chanChatParty = “chat.party.” + “*”;
string chanChatLobby= “chat.lobby.” + “*”;

ロビーやパーティが結成されると、あるプレイヤーがグループのリーダーやオーナーに指名されます。このようなプレイヤーをパーティリーダーまたはホストと呼びます。次に、ホストプレイヤーのユーザーIDとベースとなる文字列を連結し、ユニークなチャンネルパターンを作成します。パーティやロビーに招待された新しいプレイヤーは、これらのチャンネルに動的に登録され、事実上グループに参加することになります。パーティやロビーが終了したり解散したりすると、チャンネルは削除されます。

すべてをまとめる

チャネルのパターンに基づいてゲームに実装するチャットの種類を決めたら、次はこれらのチャネルをパブリッシュしたりサブスクライブしたりして、リアルタイムでメッセージを送受信します。

メッセージの公開

このプロセスは、メッセージのペイロードを作成することから始まります。これは、Unityゲームの要件に応じて、単純なテキストチャットであったり、より複雑なデータ構造であったりします。ペイロードの準備ができたら、いよいよメッセージを発行します。

Publish APIは、指定されたチャットチャンネルのすべての購読者にメッセージを送信するために使用されます。一度に1つのチャンネルにしかパブリッシュできませんが、パブリッシュは非同期に実行されるため、他のコードの実行をブロックすることはありません（同期的にパブリッシュすることも可能です）。

例えば、パーティにチャットメッセージを送信したい場合、以下のような呼び出しを行い、パブリッシュするだけでなく、PubNubの呼び出しが成功したかどうかを判断します（呼び出しが失敗した場合の処理も行います）：

PNResult<PNPublishResult> publishResponse = await pubnub.Publish()
  .Message(“Ready to go!”)
  .Channel(chanChatParty )
  .ExecuteAsync();
PNPublishResult publishResult = publishResponse.Result;
PNStatus status = publishResponse.Status;
Debug.Log("pub timetoken: " + publishResult.Timetoken.ToString());
Debug.Log("pub status code : " + status.StatusCode.ToString());

メッセージの購読

メッセージが公開されたら、適切なチャネルにサブスクライブして、受信メッセージやイベントを受信する必要があります。1回の呼び出しで複数のチャットチャネルやチャネルグループをサブスクライブできます：

pubnub.Subscribe<string>()
  .Channels(new List<string>() {
    chanChatAll,
    chanPrivateChat,
    chanChatParty + "*",
    chanChatLobby + "*"               
})
  .ChannelGroups(new List<string>() {
    chanFriendGroupChat + userId,
    chanGuildGroupChat + userId,
    chanAllianceGroupChat + userId
})
.Execute();

プレイヤーはPubNubネットワークに接続され、イベントリスナーはイベント（この場合は新しいメッセージの到着）が発生するのを待ち、そのイベントに関連するコードを実行します。

メッセージが到着すると、リスナーはコールバックをトリガーし、到着したメッセージを処理するために書いたコードを実行します。これは、チャットルームにメッセージを表示するような単純なものから、チャットメッセージに基づいてゲーム内イベントをトリガーするような複雑なものまであります。

ゲーム内チャットを魅力的にする高度な機能

Unityゲームにゲーム内チャットを実装し、プレイヤーがリアルタイムでメッセージを送受信することに成功しました！これは既にプレイヤー同士の交流の場を作り出していますが、実装された機能は氷山の一角に過ぎません - プレイヤーにとってゲーム内チャットをより魅力的なものにするために実装を検討すべき機能はたくさんあります。

メッセージ履歴を読み込む：メッセージの永続性

ゲーム内では、プレイヤーは以前の会話を再確認したり、聞き逃したチャットに追いつく必要があるかもしれません。MessagePersistenceAPIをUnityゲームに実装することで、チャットメッセージ、メッセージアクション、ファイルを必要に応じて保存、取得することができます：

PNResult<PNFetchHistoryResult> fetchHistoryResponse = await pubnub.FetchHistory()
  .Channels(new string[] { chanPrivateChat })
  .IncludeMeta(true)
  .MaximumPerChannel(25)
  .ExecuteAsync();

また、メッセージの保存期間を柔軟に制御できるため、ゲーム固有のニーズやリソースに応じてストレージを管理できます。メッセージの永続性を利用できるようにするには、キーの管理ポータルでこの機能を有効にする必要があります。この機能の詳細および有効化方法については、Message Persistenceハウツーガイドをご覧ください。

不在メッセージをプレーヤーに通知する：モバイルプッシュ通知

モバイルゲームでは、プレイヤーはアプリを出たり入ったりすることが多く、チームからの重要なメッセージやゲームのアップデートを見逃すことがあります。そこで、モバイルプッシュ通知の出番です。モバイルプッシュ通知は、プレイヤーがゲームに参加していないときでも、見逃したチャットメッセージやゲームのアップデート、その他の重要な通知をプレイヤーに通知する方法を提供します。

モバイルプッシュ通知APIでは、iOSとAndroidの両方のデバイスにプッシュ通知を送信するための統一APIを提供しています。これにより、プロセスが簡素化され、プラットフォームに関係なく、すべてのデバイスに通知するために単一のAPIコールを送信することができます。また、個々のゲーマーにパーソナライズされた通知を送信したり、全プレイヤーにメッセージをブロードキャストするなど、プッシュ通知をカスタマイズすることもできます。このような柔軟性により、プレイヤーとの効果的なコミュニケーションが可能になり、プレイヤーの関心を引きつけ、情報を提供し続けることができます。

PubNubでモバイルプッシュ通知を利用するには、管理者ポータルのハウツーガイドに従ってモバイルプッシュ通知を有効にする必要があります。また、FCMと APNのモバイルプッシュ通知についてのより具体的で詳細なガイドもご用意しています。

言葉だけではありません：絵文字

絵文字は、デジタルコミュニケーションにおける感情の世界共通言語として機能します。絵文字を使うことで、プレイヤーは自分の感情や反応を楽しくカラフルに表現することができ、チャットをよりインタラクティブで魅力的なものにすることができます。

PubNubを使用すると、プレイヤーにメッセージではなくシグナルを発行させることで、Unityゲームに絵文字サポートを簡単に実装できます。シグナルは、メッセージよりもはるかに速く、安価に送信できるため、小さなデータのビットを送信するためのものです。絵文字は一般的にデータサイズが非常に小さいので、データを素早く送信するには最適な方法です。

PubNubのシグナルAPIを使って指定したチャットに絵文字を公開することができます。例えば、プレイヤーが手を振っている絵文字をグローバルチャットに送信したい場合、送信を押すと以下のコードが実行されます：

Dictionary<string, string> myMessage = new Dictionary<string, string>();
myMessage.Add("emoji", ":wave:");
pubnub.Signal()
  .Message(myMessage)
  .Channel("global")
  .Execute((result, status) => {
    if (status.Error) {
      Debug.Log(status.ErrorData.Information);
    } else {
      Debug.Log(result.Timetoken);
    }
  });

意図した受信者のプレイヤーは、指定されたチャンネルに加入していればシグナルを受信します。この場合、グローバルチャンネル用なので、全員が絵文字を受信することになります。シグナルを受信するには、リスナーイベントを購読してください：

listener.onSignal += OnPnSignal;
private void OnPnSignal(Pubnub pn, PNSignalResult<object> result) {
    // Handle the emoji by looking up the value and displaying the result.
}

絵文字の値がUnityで定義されている実際の絵文字であることを確認する必要があります。これらの絵文字は、App Context（以前はObjectsとして知られていた）を介してPubNubネットワークに格納および取得することができ、プレイヤーがアクセスできるすべての絵文字をサーバーレスストレージから取得することができます。UnityゲームにApp Contextを実装する方法については、ハウツーガイドを参照してください。

メッセージに反応するメッセージリアクション

いいね、ハート、サムズアップ、ステッカー、またはゲーム固有のカスタムリアクションなどのメッセージリアクションは、プレイヤーがチャットメッセージに応答するための迅速かつ簡単な方法を提供します。リアクションはチャットにインタラクティブ性を与えるだけでなく、プレイヤー同士がお互いのメッセージを認め合い、関わり合うことで、コミュニティ意識を育むことができます。

PubNubのメッセージアクションAPIを使用して、リアクションや既読受信のような機能を構築したり、メッセージにカスタムメタデータを関連付けたりすることができます。Discordのようなチャットアプリケーションでサーバごとに異なるリアクションや絵文字があるのと同様に、チャットの種類も異なります。チャットがロードされたときに、以下の呼び出しを使って、指定したチャットチャンネルで利用可能なメッセージのリアクションを取得できます：

pubnub.GetMessageActions()
  .Channel(chanChatLobby)
  .Execute(new PNGetMessageActionsResult((result, status) => 
  {
    //result is of type PNGetMessageActionsResult.
  }));

プレイヤーがメッセージに対してリアクションを返そうとする場合、公開メッセージにメッセージリアクションを追加することでリアクションを返せます：

pubnub.AddMessageAction()
  .Channel(chanChatLobby)
  .MessageTimetoken(5610547826969050)
  .Action(new PNMessageAction { Type = "reaction", Value = "smiley_face" })
  .Execute(new PNAddMessageActionResult((result, status) =>
  {
    //result is of type PNAddMessageActionResult.
  }));

PubNubはタイムトークンを使って、メッセージがいつネットワークに公開されたかを正確に追跡します。PubNubはタイムトークンを使ってメッセージがいつネットワークに公開されたかを正確に追跡します。そのため、MessageTimetoken()の引数に適切なタイムトークンの値を指定することで、メッセージに反応することができます。

リアクションをリッスンし、元のメッセージを送信したプレイヤーに通知するには、リスナーを追加し、OnPNMessageActionメソッドでリアクションを処理する必要があります：

listener.onMessageAction += OnPnMessageAction;
…
private void OnPnMessageAction(Pubnub pn, PNMessageActionEventResult result) {
   //Handle Message Reaction
}

絵文字と同様に、App Contextを使用して、これらのリアクションがゲーム内でどのように視覚的に表現されるかを取得し、保存することができます。メッセージリアクションを使用するには、管理ポータルでキーのメッセージ永続化を有効にする必要があります。

GIFとその他のマルチメディア

チャット体験を向上させるもう一つの重要な機能は、マルチメディアファイルの共有です。GIFの共有、面白い瞬間のスクリーンショット、ゲームリソースの共有など、ファイル共有はゲームに新たなレベルの交流をもたらします。

これらのタイプのマルチメディアファイルを実装するには、PubNubファイル共有APIを使用します。この機能により、プレイヤーはアクセス可能なファイルをアップロード、ダウンロード、削除することができます。ファイルを送信するには、次のように呼び出します：

PNResult<PNFileUploadResult> fileUploadResponse = await pubnub.SendFile()
  .Channel(string chanFriendChatSamantha)
  .File("cat_picture.jpg") //checks the bin folder if no path is provided
  .Message("Look at this photo!")
  .ExecuteAsync();
PNFileUploadResult fileUploadResult = fileUploadResponse.Result;
PNStatus fileUploadStatus = fileUploadResponse.Status;
if (!fileUploadStatus.Error && fileUploadResult != null)
{
  Debug.Log(pubnub.JsonPluggableLibrary.SerializeToJsonString(fileUploadResult));
}
else
{
  // Handle File Upload Error.
}

サブスクライバがファイルをリッスンするには、イベントリスナーを追加し、OnPNFileメソッドでファイルを表示する方法を処理する必要があります：

listener.onFile += OnPnFile;
…
private void OnPnFile(Pubnub pn, PNFileEventResult result) {
    //Handle how to display the file received
}

また、異なるチャットチャンネルに関連付けられたファイルを取得、リスト情報、および削除することができます。管理者ポータルでファイル共有機能を有効にし、メッセージの永続性を有効にする必要があります。この方法については、ファイルを有効にするハウツーガイドを参照してください。

チャットチャンネルの保護アクセスマネージャ

どのようなゲーム環境においても、チャットチャンネルのセキュリティを確保することは最も重要です。それが不要なメッセージからプレイヤーを保護するか、機密の戦略的な議論を保護するかどうかにかかわらず、Unityゲームのチャットシステムは、セキュリティを念頭に置いて設計する必要があります。

そこでPubNubのアクセスマネージャの出番です。これは、チャットチャンネルを保護するための堅牢で柔軟なフレームワークを提供します。Access Managerを使用すると、誰が各チャンネルを公開または購読できるかを制御し、Unityゲームのチャットシステムに追加のセキュリティレイヤーを追加することができます。

Access Managerは、ユーザーレベル、チャンネルレベル、または個々のキーのレベルでパーミッションを付与することができます。例えば、2人のプレイヤー間のプライベートチャットでは、その2人のプレイヤーだけにプライベートチャネルの読み取りと書き込み権限を与えることができます。同様に、ギルドチャットでは、すべてのギルドメンバーに読み取り権限と書き込み権限を与え、ギルドリーダーにのみ管理権限を与えることができます。

Access Managerはトークンベースの認証もサポートしており、ユーザーを安全に認証して適切なパーミッションを付与することができます。これにより、許可されたプレイヤーのみがゲームのチャットチャンネルにアクセスできるようになり、潜在的な脅威からゲームコミュニティを保護できます。

この機能を利用するには、管理者ポータルでAccess Managerを有効にする必要があります。このアドオン機能を有効にする方法については、こちらのサポートページを参照してください。

このハウツーガイドでは、Unityゲームに堅牢なリアルタイムチャットシステムを追加する方法を学びました。環境内でPubNubオブジェクトを初期化する方法から、異なるチャットタイプを表すチャットパターンの設定、そしてメッセージの送受信までを説明しました。絵文字、メッセージリアクション、ファイル共有のような高度な機能の実装方法や、メッセージの永続性、モバイルプッシュ通知、チャネルのセキュリティなど、優れたチャットシステムの重要な側面も学びました。

あなたが初めてのゲームに取り組んでいるインディーズ開発者であっても、マルチプレイヤーゲームを強化しようとしているベテラン開発者であっても、PubNubのリアルタイム機能は、あなたのゲーム内チャットをサポートするインフラストラクチャとして機能します。

以下のリソースで詳細をご覧ください：

Unityのドキュメントを読んで、ゲームにリアルタイムチャットを追加するために必要なすべての知識を学びましょう。
Unityガイドでフレンドリストの追加方法を理解する。
Unity Showcase Gameでチャットパターンを使用してチャットルームを管理する方法などをご覧ください。
Unity SDKのソースコードをご覧ください。

ご質問やご不明な点がございましたら、devrel@pubnub.comのデベロッパーリレーションズチームまでお気軽にお問い合わせください。

イルミネートの設定方法

PubNub Developer Relations — Wed, 15 May 2024 23:39:31 +0000

イルミネートとは？

PubNub Illuminateは、ゲームデータのライブ分析トラッキングに基づいた、その場での意思決定と実行可能なソリューションです。Illuminateを使用すると、ゲームにとって重要なKPIをマッピングし、ユーザーの行動に基づいて意思決定を行い、結果を即座に確認することができます。Illuminateを使用すれば、リアルタイムのインタラクションやゲームプレイが発生しているときに、データに裏打ちされたスマートな意思決定を即座に行い、ゲームの成長を促進し、効率を最適化することができます。

このチュートリアルでは、Illuminateの詳細、ゲーム（およびスタジオ）の成功にとってIlluminateが重要な理由、およびゲームのデータに基づいてアクションをトリガーするイン・ザ・モーメントの意思決定を作成するためのIlluminateのセットアップ方法について説明します。

なぜゲームにIlluminateなのか？

従来のほとんどの分析ツールでは、リアルタイムのデータに対してアクションを起こすのは、通常はリアクティブなものでした。プレイヤーのフィードバックに基づく価格変更などの調整は、データ収集、テスト、プラットフォーム間での展開を含む長いパッチサイクルによって妨げられ、さらに開発および将来のコンテンツ作成からリソースを逸らしてしまいます。イベント発生から数時間でも遅れると、実用的な洞察が効かなくなるため、迅速な戦術的決定を可能にするために、プレイヤーのエンゲージメントと収益化をリアルタイムで可視化することが非常に必要です。

Illuminateはローコードでカスタマイズ可能な製品であり、ゲームマネージャーやデータアナリストが戦略的決定の影響を即座に適用・評価できるようにします。Illuminateは、ゲーム開発者に負担をかけることなく、不正行為を検出しながら、ゲームバランスのオンザフライ調整、リアルタイムの実験によるより効果的で適切な収益化戦略、リテンションとプレイヤー体験を向上させるためのパーソナライズされたプレイヤー報酬の実行を可能にします。

Illuminateがあれば、プラットフォームを管理し、その時々のアクションをすべてリアルタイムで行うことができます：

チャンネル内でターゲットを絞った収益化実験を実行し、結果を即座に確認
プレイヤーのアクションに基づいて、パーソナライズされたレコメンデーションを即座に送信します。
ユーザーまたはコホートの行動に基づいてアクションをトリガーし、即座に結果を確認できます。
不正行為の検出を改善し、疑わしい行動をリアルタイムで特定して対処。
ゲーム内のショップアイテムの価格を調整し、試してみる。プレイヤーが同じアイテムを何個も購入している場合は価格を調整し、ゲーム内イベントをトリガーして全ショップの価格に影響を与えます。
チャレンジやアチーブメントを達成したプレイヤーに、ゲーム内アイテムの割引コードで報酬を与える。プレイヤーが最も時間を費やしていない場所を調整し、そのエリアで時間を費やすように報酬を与えるか、プレイヤーが得る報酬の種類を変更することを検討する。
エンジニアをバグらせることなく、その場で役立つアイテムを生み出したり、ゲームプレイの中核となる機能を調整する。

Illuminateがどのようにゲームをパワーアップさせるかについては、Illuminate for Gamingのビデオをご覧ください。

ゲームにIlluminateをセットアップする方法

ゲーム用のIlluminateのセットアップに入る前に、セットアップを通して使用されるいくつかの重要な用語を理解する必要があります。Illuminateは以下の3つのモジュールで構成されています：

ビジネスオブジェクト：データをIlluminateに取り込む方法。選択したアプリやキーセットからデータを取得するためのコンテナであるBusiness Objectsを定義、作成、アクティブ化できます。一連のオプション（メジャー、ディメンション、またはメトリック）を通じて、リアルタイムで追跡したい特定のデータと、それをどのように集計するかを決定できます。
決定：作成したメトリクスに対してアクションを起こす場所です。満たすべき条件を含むルールを定義し、これらのルールが満たされたときにトリガーされるアクションを定義することで実行できます。
ダッシュボード：Business Objects で作成したメトリクスや、Decisions で実行したアクションを、チャートやダッシュボード（チャートの集合体）を使って可視化します。

重要な用語を定義したところで、Illuminateをゲームに統合するには6つのステップがあります：

メッセージスキーマを理解する
データの送信元を選択します。
データを選択する
データを視覚化する
データを活用する
可視化して調整する

メッセージスキーマを理解する

ゲームのデータスキーマを理解することは非常に重要です。これは、プレイヤーのアクション、ゲーム内のトランザクション、システムイベントなど、追跡および分析したいデータのタイプを特定することを意味します。ペイロードに何が含まれているかを正確に理解し文書化することで、開発者は、アナリストや他のチームメンバーが JSONPath を使用してデータを適切なソースに効率的にマッピングできるようになります。Business Objects を作成する際にデータを選択する際に、なぜこれが重要なのかを理解できるでしょう。

データの取得元を選択する

Illuminateは、PubNubの電源の有無にかかわらず、オンラインに接続するあらゆるゲームで使用できます。PubNubがゲームのインフラを提供している場合は、管理ポータルでビジネスオブジェクトを作成する際に、ゲームに使用する適切なアプリとキーセットを選択するだけです（詳細は後ほど説明します）。

あなたのゲームがPubNubによって供給されていない場合、あなたのデータは、REST APIを介して、または私たちのSDKのいずれかを介して、Fire APIを使用して送信することができます。Fireエンドポイントを使用すると、クライアントはFunctionsイベントハンドラにメッセージを送信できます。これらのメッセージは、あなたがファイアしたチャネルに登録されているイベントハンドラに直接送られ、それらの実行をトリガします。

PubNub Fire APIを利用するには、PubNubアカウントを作成し、ゲームに必要な機能をキーセットに設定する必要があります。このキーセットにはFire APIに必要なpublishキーとsubscribeキーが含まれています。その方法はハウツーガイドをご覧ください。

データを選択します：ビジネスオブジェクト

ビジネスオブジェクトはIlluminateの基本です。これは、Illuminate内で意思決定や視覚化に使用するデータのコンテナであり、基本的にIlluminateにデータを取り込む方法です。

ビジネスオブジェクトは3つの要素で構成されます：

データの選択（メジャーとディメンション）
データ・ソース（データの出所
条件（メトリクス）

データベースとは関係ありませんが、SQLのSELECT（メジャーとディメンジョン）、FROM（データ・ソース）、WHERE（メトリクス）という観点からビジネス・オブジェクトの構造を考えると便利です。ビジネス・オブジェクトを作成する際、注意すべき特定の詳細や回避策については、必ずドキュメントに従ってください。

データの選択

ビジネス・オブジェクトで選択できる値には 2 つのタイプがあります：メジャーとディメンジョンです。

メジャーは数値で、定量的な値です。メジャーの例としては、ゲーム時間、コイン数、キル数、武器ダメージ、注文金額などがあります。

Dimensionsは定性的な値で、プレイヤーの言語、選択した化粧品、クエストの種類、選択した武器の種類、ゲームのレベルなどがあります。

追跡したいデータの種類に応じて、JSONPathを使用してデータをメジャーとディメンションにマッピングする必要があります。Illuminate は、（前のステップで設定した）データソースからこのデータのキャプチャを開始する場所を理解する必要があります。データ・ソースを定義するには、各メジャーおよびディメンションの横にあるマップ・ボタンを選択し、対応する JSON パスを指定します。

これは、メッセージ・スキーマを理解する必要があるため、Business Objects のセットアップで最も厄介な部分です。メッセージスキーマは文書化されているか、または以前から理解しているので、これを Iluminate がデータを探す方法にマッピングする必要があります。

メッセージ（特にPublish Message API）をキャプチャしている場合、Illuminateは次の構造を探しています。インフラストラクチャがPubNubによって提供されていない場合、データはPublish Message APIと同じ構造でマッピングする必要があります：

{
 "message":{ // data from the published message
   "body": JSON | message body payload defined by you
   "meta": JSON | meta query params defined by you
   "userId": string | user ID a.k.a UUID / sender ID
   "channel": string | the channel on which the message is published
 },
}

メジャーまたはディメンジョンを正しくマッピングするには、メッセージ・オブジェクトの後に別のフィールドを指定する必要があります。メジャーまたはディメンションを正しくマップするには、メッセージオブジェクトの後に別のフィールドを指定する必要があります。これは常に次の構造に従います。

どのようにデータをマッピングするかは、メッセージの構造によって決まります。以下は、メッセージのデータをマッピングする例です：

コインの追跡数 (メジャー) => $.message.meta.coins
装備している化粧品 (ディメンション) => $.message.body
チャンネル名 (dimension) => $message.channel
与えたダメージ（メジャー） => $.message.body[6］
特定のユーザー名の取得（次元） => $.message.userId
友達の数 (メジャー) => $.message.body.user.friends_count

IlluminateはPubNubのApp Contextを利用してデータを取得することもでき、PubNubネットワーク上で送信されたチャネル、チャネルメンバー、チャネルメンバー、ユーザに関するメタデータを永続化することができます。Illuminateがこのデータをキャプチャする方法を正確に追うことで、この情報にアクセスできます。

{
 "user": { // data from the sending user metadata, can be null
   "externalId": string | user’s external ID
   "type": string | user type
   "status": string | user status
   "custom": JSON | JSON user metadata defined by you
 },
 "channel":{ // data from the channel the message is sent on, can be null
   "name": string | channel name
   "type": string | channel type
   "status": string | channel status
   "custom": JSON | JSON channel metadata defined by you
 },
 "membership":{ // data from the user's membership to the channel, can be null
   "status": string | membership status
   "custom": JSON | JSON membership metadata defined by you
 }
}

メッセージと同様に、メジャーまたはディメンジョンを正しくマッピングするには、ユーザ、チャネル、またはメンバシップ・オブジェクトに続いて、JSONから少なくとも1つのキーを指定する必要があります。これは常に、$.user.{obligatory-secondary-field}.{optional-further-fields} という構造に従います。以下に、App Contextのデータをマッピングする例をいくつか示します：

ショップアイテムの詳細 (ディメンション) => $.channel.custom.details
フレンドリストのステータス (ディメンション) => $.membership.status
プレーヤーの言語 (ディメンション) => $.user.custom.language
プレーヤーの平均スコア (メジャー) => $.user.custom.team_deathmatch_score

注釈ビジネス・オブジェクトを作成するには、少なくとも 1 つのディメンジョンまたは 1 つのメジャーを追加する必要があります。

データ・ソース

メジャーおよびディメンジョンのマッピングが完了したら、データの取得元を決定する必要があります。これは、以前に決定した内容です。Illuminateが正しいソースからデータを取得していることを確認するために、先に定義した適切なアプリとキーセットを必ず選択してください。

条件（メトリクス）

データソースを選択したら、メトリクスと呼ばれる条件を追加できます。SQL の WHERE 文に似ていますが、Business Objects でデータを取得するためにメトリクスは必須ではありません。ただし、メトリックは、ディシジョンを作成したり、チャートを通じてダッシュボードで視覚化したりするために必要であることに留意してください（詳細は後述します）。

メトリクスの作成時には、フィルタにフィールドを割り当てて選択する必要があります。注意すべきフィールドがいくつかあります：

ダッシュボードでデータを視覚化するチャートも同じ名前になるため、メトリックに意味のある名前を付けます。
関数を選択する場合、メジャーは現在、SUM、AVG、MAX、およびMIN を使用して集計できます。ディメンジョンは、COUNT関数のみを使用できます。関数を選択すると、ドロップダウン・リストからメジャーまたはディメンジョンを選択できます。
Period では、Aggregation ウィンドウまたは関数の期間を選択します。
チャートやデシジョンで使用したいディメンションを必ず選択してください（後でこれらを選択しないと、チャートでセグメンテーションしたり、デシジョンでルールに適用したりできないため）。
異なるディメンションに基づいて、特定のメッセージまたはApp Contextデータをフィルタリングします。ダッシュボードで視覚化してデータを収集するには、メトリックにフィルタを適用する必要はないことに留意してください。

1つのビジネス・オブジェクトに対して、異なるデータを取得する複数のメトリックを作成できます。以下は、Measure の与えたダメージと、そのダメージを与えた武器の種類をキャプチャするメトリックの例です：

データの可視化ダッシュボードとチャート

Illuminateでは、追跡したいメトリクスだけでなく、ダッシュボードのチャートを通じて、意思決定アクションとその結果も視覚化できます。

こうすることで、製品の傾向をリアルタイムで観察し、データに基づいたビジネス上の意思決定で対応し、アプローチを改善することができます。また、先に設定したビジネスオブジェクトに基づいて、Illuminateが適切にデータを取得しているかどうかを判断するのにも最適です！

ダッシュボードを作成することができます。ダッシュボードはチャートの集合体で、すべてのメトリクスを一箇所で確認したり、ダッシュボードにチャートを追加したりできます。チャートは、特定の Business Object に対して定義されたメトリックを視覚的に表したものです。

いつでも、異なる時間範囲（30 分、1 時間、またはカスタム日付など）を表示したり、棒グラフ（デフォルト表示）や折れ線グラフなど、異なるチャート・タイプでメトリック・データを表示したりするなど、メトリック・データをチャートに表示する方法をカスタマイズできます。

1つのダッシュボードに複数のチャート（メトリクス）を追加したり、ゲームの異なる領域（収益化、ゲームプレイ、クエスト報酬など）を視覚化するために異なるダッシュボードを持つこともできます。デシジョンを設定すると、ダッシュボードのチャートでデシジョンアクションのトリガーとその結果を見ることができます。

データの活用デシジョンとアクション

メトリックが作成されたら、そのデータの評価を開始し、傾向を監視し、最も重要なことは、それに基づいて行動することです。

IlluminateにはDecisionsモジュールがあり、さまざまなタイプのアクションと、これらのアクションを実行するタイミングを定義するルールを作成することで、行動したいメトリクスを定義できます。

デシジョンを作成する場合

ビジネス・オブジェクトと、それにリンクされているメトリクスのいずれかを選択します。
実行したいアクションを定義する。
選択した条件と構成したアクションを使用して、[rules}(https://www.pubnub.com/docs/illuminate/decisions/basics#rules) 。これらのルールがアクションをトリガーします。

Decisionsは、プロダクト・マネージャーがエンゲージメントとマネタイズの戦略を、成文化して展開する前に実験することを目的としています。Illuminateを使用すると、仮定ではなく実際のデータに基づいて意思決定を行い、自動化された条件とアクションによってそのデータに基づいて行動することができる。

意思決定は2つの部分で構成される：アクションとルールだ。

アクション

アクションは、条件（次に説明する）が満たされたときに何が起こるかを定義する。

アクションを設定する際に、5つのアクションタイプから選択できます：

メッセージの送信：ユーザーまたはチャネルにメッセージを送信します。PubNub Publish APIを利用します。オプションで変数(${variableThatChanges})を追加することができ、決定ルールを設定する際に動的に変更することができます。
Webhook：サードパーティのサービス連携に接続することで、特定のURLにコールを送信します。オプションで変数 (${variableThatChanges}) を追加でき、決定ルールを設定するときに動的に制御して変更できます。
Update User: ユーザー用のPubNub App Context APIを利用して、必要な情報をキーと値のペアとして提供することで、定義済みまたはカスタムのユーザーメタデータを設定します。
チャネルの更新：チャネル用のPubNub App Context APIを利用して、必要な情報をキー/値のペアとして提供することで、定義済みまたはカスタムのチャネルメタデータを設定します。
メンバーシップの更新：メンバーシップ用のPubNub App Context APIを利用して、必要な情報をキー/値のペアとして提供することで、定義済みまたはカスタムメンバーシップのメタデータを設定します。

1つのDecisionにつき設定できるメトリックは1つだけですが、ユースケースをカバーするために複数のDecisionを作成できます。DecisionのActionを作成するときは、必ずドキュメントに従ってください。

アクションの設定が完了したら、アクションをトリガーするためのルールを設定する必要があります。

ルール

ルールは、アクションをトリガするために満たさなければならない条件である、評価する条件と、条件が満たされたときに実行されるアクションで構成されます。1つのルールは、どの条件に対してどのアクションをトリガーすべきかを記述した定義（デシジョンテーブルの行）である。

デシジョンテーブルは4つの部分で構成される：

ヒット・ポリシー：条件を満たした場合に、最初にマッチしたルール（Single）に対してのみアクションをトリガーするか、すべてのルール（Multiple）に対してアクションをトリガーするかを定義する設定。
集約ウィンドウ：ルール設定ウィンドウで編集できない唯一の値。メトリックを作成するときにFunctionに選択したPeriod値から自動入力されます。この値は、メトリックがメジャーまたはディメンジョンに対して指定の関数 (COUNT、AVG、MAX、その他) を実行する頻度を示します。
評価頻度：ルールのルックバック・ウィンドウで、Illuminate がこの Decision でルールを実行する頻度を定義します。
条件：条件：構成テーブルを使用して独自に定義する要件のセット。ここでは、どの条件（およびそれらが満たすしきい値）がどのアクションをトリガするかを定義します。

デシジョンテーブルの各行は、条件とアクションで構成される個別のデシジョンルールであることに留意してください。ルールの順序は、それらが実行される順序を決定する。既存の順序を変更したい場合は、「デシジョンのルールの編集」を選択し、各ルールの横にある「アクション」メニューの「上へ移動」または「下へ移動」オプションを使用して順序を変更する。

可視化と調整

ビジネスオブジェクト、ダッシュボード、チャート、およびディシジョンを設定したら、リアルタイムで分析し、変更を試すことができます。あなたが行った変更がゲーマーやゲームに良い影響を与えているかどうかを確認するために、バランスパッチを待つ必要はもうありません。

ゲーム内のエンゲージメントを高めるための調整を行うため、実験的な決断を下すことになります。

Illuminateは、成長と会社の収益に直接責任を持つチームの手に、リアルタイムの実験の力を与えます。ゲームにとって重要なKPIをマッピングし、それらの行動に基づいて意思決定をトリガーすることで、ゲームプレイやユーザーの行動に基づいて実験し、データに裏打ちされたスマートな意思決定を行うための貴重なプラットフォームです。

Illuminateのリソースをチェックして、Illuminateがあなたのゲームにどのように役立つかを確認し、Illuminateを自分で試す方法を学んでください。ご質問がございましたら、devrel@pubnub.com のデベロッパー・リレーション・チームまでお気軽にお問い合わせください。