Programmable Chat

PROGRAMMABLE CHAT

Operational

メニュー

Rate this page:

Thanks for rating this page!

We are always striving to improve our documentation quality, and your feedback is valuable to us. How could this documentation serve you better?

変更履歴: Twilio Chat JavaScript SDK

Programmable Chat JavaScript SDKの最新リリース

Programmable Chat's Javascript SDK is now at version v3.2. We recommend using the below links in your projects. As we patch bugs, these links will automatically be updated with the fixes with full backwards compatibility.

Upgrade to Programmable Chat JS SDK v2.0 or higher.

From June 1, 2019 forward, JavaScript SDKs earlier than v2.0 will be deprecated and cease to connect to the Twilio backend. If you still use Chat 0.x or 1.x, please leverage our migration guides and update to a later version at your nearest convenience.

チェンジログ

ここでは、パッチの特定のバージョンへのリンクを提供しています。リリースの特定のパッチを特に必要とする場合を除き、これらのリンクを使用しないことをお勧めします。

Programmable Chat 3.2.3 (April 15, 2019)

変更点

  • Consumed new version of Sync JS SDK version 0.10.3
  • Link to the token generation material got updated

Programmable Chat 3.2.2 (April 2, 2019)

バグ修正

  • Fixed a bug where sending messages while offline caused duplicate messages at network reconnect

Programmable Chat 3.2.1 (February 21, 2019)

バグ修正

  • Improved error handling in operations with User, Member, Channel, Message

Programmable Chat 3.2.0 (December 7, 2018)

概要

In this release we are introducing Member Attributes and the ability to change them.

変更点

  • Added dateCreated, dateUpdated, type, and attributes properties to Member class
  • Added Member.updateAttributes method to set a Member's Attributes (requires new permissions to be added to the according role: editOwnMemberAttributes or editAnyMemberAttributes)

バグ修正

  • Fixed a connectivity bug that caused unhandled promise rejections

Programmable Chat 3.1.0 (October 18, 2018)

概要

In this release we are introducing a User Notification Level to each Channel. The assigned level determines whether the currently logged-in User will receive pushes for that Channel. The assigned level be any of muted or default, where default defers to global Chat Service push configuration.

変更点

  • Added Channel.setUserNotificationLevel method to set User's Notification level
  • Added notificationLevel property to Channel class

バグ修正

  • Fixed a connectivity bug that caused reconnection recovery to fail, including when backgrounding on iOS (react native).

Programmable Chat 3.0.2 (July 23, 2018)

変更点

  • Improved startup and synchronization time in some cases

バグ修正

  • Resolved potential issue in Channel synchronization on startup
  • Fixed bug preventing building React Native apps in Release configuration

Programmable Chat 3.0.1 (June 25, 2018)

変更点

  • Improve diagnostics, start adding timestamps to log lines

バグ修正

  • @types\loglevel package is not required anymore in TypeScript projects using twilio-chat

Programmable Chat 3.0.0 (May 31, 2018)

概要

In this release we have revised all updated events. Each revised event now receives an object which contains:

  • updated object itself, i.e. channel, member, message, user
  • array of reasons the event is being triggered, i.e. object is updated because of update in attributes, friendlyName, body, etc.

Additionally, the Channel.LastMessage structure is updated to contain only last message's creation timestamp and index (effectively removing author and sid)

破壊的変更

  • updated events now include reasons for the update. Changed events are:
    • Client#event:channelUpdated
    • Channel#event:updated
    • Client#event:memberUpdated
    • Channel#event:memberUpdated
    • Member#event:updated
    • Client#event:messageUpdated
    • Channel#event:messageUpdated
    • Message#event:updated
    • Client#event:userUpdated
    • User#event:updated
  • changing channel.sendMessage() promise resolve type to Promise<number>
  • default logLevel is now set to silent, log lines now includes timestamp
  • removed sid and author properties from Channel.LastMessage type

Additive Changes

  • adjust docs for Client.shutdown(), introducing new types for various methods
  • adding new events on client: tokenAboutToExpire, tokenExpired (essentially removing need for AccessManager use)
  • added index property to Channel.LastMessage type

Programmable Chat 2.2.0 (March 13, 2018)

変更点

  • Added method Client.unsetPushRegistrationId to unregister from push notifications
  • Added lastMessage structure to Channel
  • Added helper method Client.getLocalChannels to get (sorted) locally known channels, sorting is possible by uniqueName, friendlyName, or lastMessage

バグ修正

  • Fixed re-using of ClientOptions between two clients creations in the same browser or node.js session
  • Various updates and fixes for documentation

Programmable Chat 2.1.0 (January 15, 2018)

変更点

  • for Message with type media the body property now is null (instead of placeholder about unsupported media messaging)
  • adjusting Client#connectionStateChanged event: adding disconnected and disconnecting states

バグ修正

  • fixed race in session initialization
  • various updates and fixes for documentation

Programmable Chat 2.0.1 (December 19, 2017)

概要

This release is identical to 2.0.0. The sole purpose is to publish the new version to npmjs.com.

Programmable Chat 2.0.0 (December 1, 2017)

概要

Removed deprecated Client constructor and Client.initialize function, the correct way now is to use static function Client.create. Behavioral breaking change in adding Member and joining Channel, now if User is already in the Channel, then Channel.add and Channel.join will throw SessionError. Changed function signature in Consumption Horizon functions, after successful setting of last message consumed these functions returns unread messages count in given Channel for logged in User.

破壊的変更

  • Channel.add and Channel.join functions will throw an SessionError in case of User already exists in the Channel
  • Consumption horizon functions now returns Promise<number> with count of unread messages in the channel after the operation:
    • Channel.advanceLastConsumedMessageIndex
    • Channel.updateLastConsumedMessageIndex
    • Channel.setAllMessagesConsumed
    • Channel.setNoMessagesConsumed

Removed deprecated functions

  • Client constructor
  • Client.initialize 関数

バグ修正

  • Client.version property now correctly displays Client's version
  • fixed getting next page of Channel's User Descriptors after calling Channel.getUserDescriptors

Programmable Chat 1.2.1 (October 12, 2017)

バグ修正

  • Fixed incorrect handling of network timeouts in React Native
  • Fixed session errors handling

Programmable Chat 1.2.0 (September 18, 2017)

新機能

  • Added Multimedia Messaging (beta) API (see Media Support for more information). Note: Sending media messages on existing instances requires adding a new permission in your channel roles.
  • in Channel.sendMessage method you can provide FormData (for browsers) or SendMediaOptions (browsers and node.js apps) to send media from your client
  • Message class is extended with type attribute
  • Message class is extended with media attribute which holds Media class instance
  • role should contain Channel level sendMediaMessage permission for users to be able to send Media Messages

Programmable Chat 1.1.2 (August 22, 2017)

バグ修正

  • Fixed a big in client creation which caused the operation to fail in rare cases

Programmable Chat 1.1.1 (August 16, 2017)

変更点

  • added PushNotification interface for push notification representation
  • added Client#event:pushNotification event
  • added static method Client.parsePushNotification to handle push payload and return the PushNotification instance back to client (intended use is Firebase service worker)

バグ修正

  • Fixed unhandled promise rejections on new client creation in some rare cases
  • SDK Reference Documentation fixes and updates

Programmable Chat 1.0.4 (July 14, 2017)

バグ修正

  • Fixed additional issues related to Channel and ChannelDescriptor status updates not behaving as expected (which were not addressed in the 1.0.3 release)

Programmable Chat 1.0.3 (July 12, 2017)

バグ修正

  • Fixed issues related to Channel status and uniqueName updates not behaving as expected
  • SDK Reference Documentation fixes and updates

Programmable Chat 1.0.2 (July 4, 2017)

変更点

  • Improvements made to the reliability of retrieval of Channel and User Descriptors

バグ修正

  • Fix for clients with identities containing spaces / pluses / etc. during fetching Channel Descriptors
  • Fix for object properties accessors in User, Member, Channel, Message
  • Documentation fixes

Programmable Chat 1.0.1 (2017年5月19日)

変更点

  • SDK Chat Clientインスタンスの作成、特に作成済みではあるが完全に初期化されていないクライアントの使用における問題に対処するため新しいファクトリーメソッドが追加されました。 これまであった手動でのコンストラクターはdeprecated（廃止予定）となった点に留意してください。

バグ修正

  • クライアントがまれに正しく初期化されない不具合を修正しました。 これは入力中インジケーターの機能が正しく機能していない場合に発生します。
  • 現在 client init ではないメッセージ（つまり、client init後に追加さしていない）に対してmessageRemovedイベントが正しく発生しない不具合を修正しました。
  • JSライブラリーのReact Nativeとの親和性が向上しました。
  • さまざまなドキュメントの修正

Programmable Chat 1.0.0 (2017年5月2日)

With this release, Programmable Chat is now in GA. A number of breaking changes were introduced as part of the GA release. To see what has changed and to migrate from the latest Beta SDK to the new GA SDK, please read the GA Migration Guide for JavaScript.

概要

クライアントの初期化が、大多数のユーザーの典型的なシステムの使用方法を反映して単純化されました。 全ユーザーチャネル（現在のユーザーが参加している、あるいはオーナーであるチャネル）はクライアントの起動時から購読されますが、最初はメンバーの一覧のみが同期されます。 これにより迅速な起動を維持しつつ、クライアントに最新のアクティビティーが反映されます。

UserInfo は廃止予定となり、2つの個別のクラス、UserおよびUserDescriptorに置き換えられました。 ChannelDescriptorクラス同様、UserDescriptorは取得後に直接使用されるべきではあるが、一方で時間の経過とともにデータが更新されないため保持されない、その時点でのデータのスナップショットを表します。

サイズの大きいインスタンスでのパフォーマンスを向上させるため、ユーザーは暗黙的に購読されなくなりました。 少なくとも最近購読されていたユーザーが購読を取りやめたあと、同時に最大100までのユーザーを購読できます。

変更履歴

  • 削除
    • Client.getPublicChannels() 関数
    • Client.getUserChannels() 関数
    • Client#event:userInfoUpdated イベント
    • Member.userInfo プロパティ
    • Member#event:userInfoUpdated イベント
    • UserInfo クラス
  • 追加されました
    • Channel.getUserDescriptors() 関数
    • ChannelDescriptor.isPrivate プロパティ
    • ChannelDescriptor.lastConsumedMessageIndex プロパティ
    • ChannelDescriptor.status プロパティ
    • ChannelDescriptor.type プロパティ
    • Client.getPublicChannelDescriptors() 関数
    • Client.getSubscribedChannels() 関数
    • Client.getSubscribedUsers() 関数
    • Client.getUser(identity) 関数
    • Client.getUserChannelDescriptors() 関数
    • Client.getUserDescriptor(identity) 関数
    • Client#event:userSubscribed イベント
    • Client#event:userUnsubscribed イベント
    • Client#event:userUpdated イベント
    • Member.getUser() 関数
    • Member.getUserDescriptor() 関数
    • 新規Userクラス
    • 新規UserDescriptorクラス

Programmable Chat 0.13.0 (March 30, 2017)

変更履歴:

  • Enable optimised UserInfo retrieval

バグ修正

  • Fixed a bug whereby a Client init race condition caused issues in some browsers (EDGE and other browsers more rarely)
  • Ensure callbacks will arrive for channel left (fixed a race)
  • Fixed an issue whereby leaving and rejoining a channel caused events to not be received after the rejoin
  • Fixed an issue so that the channelAdded event for public channels being joined was correctly fired again

Programmable Chat 0.12.0 (February 23, 2017)

変更履歴:

  • The endpoint_id identifier specified in access tokens is now automatically generated and persisted in the client browser cache. The following should be observed with this change:
    • endpoint_id is no longer a required identifier in your generated access tokens, you may omit it from this build forward
    • endpoint_id がアクセストークンに指定されると無視されるようになりました
  • Added a direction parameter to channel.getMessage method. backwardsis default direction to keep api compatible with previous versions

バグ修正

  • Fixed a bug whereby the anchor parameter in channel.getMessage method was incorrectly processed.

Programmable Chat 0.11.1 (2016年12月7日)

バグ修正：

  • クライアントの開始後に、直接 getChannelBySid または getChannelByUniqueName を使用してチャネルが取得された場合、たびたび404エラーは返される事象が修正されました
  • クライアントが購読設定エラーによって時々起動に失敗する事象を修正されました
  • 特定の状況下で、クライアントのインスタンスが不正な接続状態となる事象が修正されました

Programmable Chat 0.11.0 (2016年11月21日)

変更履歴:

  • コンストラクターがAccessManagerインターフェイスを受け入れなくなりました。 トークンのみを受け入れます。 また、必要に応じてユーザーは自身に対してclient.updateTokenを呼び出さなければなりません。
  • client.identity プロパティーが削除されました。 client.userInfo.identityを使用してください。
  • client.getUserChannelsはページ分割されるようになり、アイデンティティーに関連するチャネル（ステータスが招待済み、参加済み、およびプライベートのチャネル）のみ返すようになりました
  • client.getPublicChannelsはchannelDescriptorの一覧を返し、またページ分割されるようになりました
  • channel.getMessagesPagedが削除されました
  • channel.getMessages()は配列の代わりにpagenatorを返すようになりました
  • カウンターメソッドであるchannel.getMessagesCount、channel.getUnreadMessagesCount、channel.getMembersCountが追加されました
  • userInfo#updatedイベントは更新されたキーの名前も返すようになりました
Rate this page:

ヘルプが必要ですか？

We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd browsing the Twilio tag on Stack Overflow.

Loading Code Sample...
 
        

        
Next Sample