0.7.0

Author: sb-junhyeong

CHANGELOG.md

@@ -1,5 +1,51 @@
 # Change Log
 
+### 0.7.0 (Feb 21, 2020)
+* Selecting an audio input / output device is implemented.
+    * Below methods are added in `SendBirdCall`
+        * `getCurrentAudioInputDevice(): MediaDeviceInfo`
+        * `getAvailableAudioInputDevices(): MediaDeviceInfo[]`
+        * `selectAudioInputDevice(mediaDeviceInfo: MediaDeviceInfo): void`
+        * `getCurrentAudioOutputDevice(): MediaDeviceInfo`
+        * `getAvailableAudioOutputDevices(): MediaDeviceInfo[]`
+        * `selectAudioOutputDevice(mediaDeviceInfo: MediaDeviceInfo): void`
+    * Below implementable event listeners are added in `SendBirdCallListener`
+        * `onAudioInputDeviceChanged: ((currentAudioInputDevice: MediaDeviceInfo, availableAudioInputDevices: MediaDeviceInfo[]) => void)  | null`
+        * `onAudioOutputDeviceChanged: ((currentAudioOutputDevice: MediaDeviceInfo, availableAudioOutputDevices: MediaDeviceInfo[]) => void)  | null`
+
+
+* Setting / retrieving custom items is implemented.
+    * Below methods are added in `SendBirdCall`
+        * `updateCustomItems(callId: string, customItems: CustomItems, callback?: CustomItemsHandler): Promise<CustomItemsResult>`
+        * `deleteCustomItems(callId: string, customItemKeys: string[], callback?: CustomItemsHandler): Promise<CustomItemsResult>`
+        * `deleteAllCustomItems(callId: string, callback?: CustomItemsHandler): Promise<CustomItemsResult>`
+    * Below property is added in `DirectCall`
+        * `readonly customItems: CustomItems`
+    * Below methods are added in `DirectCall`
+        * `updateCustomItems(customItems: CustomItems, callback?: CustomItemsHandler): Promise<CustomItemsResult>`
+        * `deleteCustomItems(customItemsKeys: string[], callback?: CustomItemsHandler): Promise<CustomItemsResult>`
+        * `deleteAllCustomItems(callback?: CustomItemsHandler): Promise<CustomItemsResult>`
+    * Below implementable event listeners are added in `DirectCall`
+        * `onCustomItemsUpdated: ((call: DirectCall, updatedKeys: string[]) => void) | null`
+        * `onCustomItemsDeleted: ((call: DirectCall, deletedKeys: string[]) => void) | null`
+    * Below property is added in `DirectCallLog`
+        * `readonly customItems: CustomItems`
+
+* Reconnection is implemented in `DirectCall`
+    * Below implementable event listeners are added in `DirectCall`
+        * `onReconnected: ((call: DirectCall) => void) | null`
+        * `onReconnecting: ((call: DirectCall) => void) | null`
+
+
+* Signature of the `SendBirdCall.dial()` has been changed.
+    * `dial(userId: string, isVideoCall: boolean, callOption: DirectCallOption, callback?: DialHandler): DirectCall` is now deprecated
+    * `dial(params: DialParams, callback?: DialHandler): DirectCall` is now recommended.
+
+* Signature of the `DirectCall.accept()` has been changed.
+    * `accept(callOption: DirectCallOption): void` is now deprecated
+    * `accept(params: AcceptParams): void` is now recommended.
+
+
 ### 0.6.10 (Jan 31, 2020)
 * Added Typescript Definition.
 * Polished error description.

SendBirdCall.min.d.ts

@@ -1,4 +1,4 @@
-/** 0.6.10 */
+/** 0.7.0 */
 
 export as namespace SendBirdCall;
 
@@ -9,14 +9,35 @@ export function connectWebSocket(): Promise<void>;
 export function addListener(id: string, listener: SendBirdCallListener): void;
 export function removeListener(id: string): void;
 export function removeAllListeners(): void;
-export function dial(userId: string, isVideoCall: false, callOption: DirectCallOption, callback?: DialHandler): DirectCall;
+export function dial(userId: string, isVideoCall: boolean, callOption: DirectCallOption, callback?: DialHandler): DirectCall;
+export function dial(params: DialParams, callback?: DialHandler): DirectCall;
 export function createDirectCallLogListQuery(params?: DirectCallLogListQueryParams): DirectCallLogListQuery;
+export function getCurrentAudioInputDevice(): MediaDeviceInfo;
+export function getAvailableAudioInputDevices(): MediaDeviceInfo[];
+export function selectAudioInputDevice(mediaDeviceInfo: MediaDeviceInfo): void;
+export function getCurrentAudioOutputDevice(): MediaDeviceInfo;
+export function getAvailableAudioOutputDevices(): MediaDeviceInfo[];
+export function selectAudioOutputDevice(mediaDeviceInfo: MediaDeviceInfo): void;
+export function updateCustomItems(callId: string, customItems: CustomItems, callback?: CustomItemsHandler): Promise<CustomItemsResult>;
+export function deleteCustomItems(callId: string, customItemKeys: string[], callback?: CustomItemsHandler): Promise<CustomItemsResult>;
+export function deleteAllCustomItems(callId: string, callback?: CustomItemsHandler): Promise<CustomItemsResult>;
 export function setLoggerLevel(level: LoggerLevel);
 export function getCall(callId: string): DirectCall;
 export const sdkVersion: string;
 export const appId: string;
 export const currentUser: User;
 
+export interface DialParams {
+  userId: string;
+  isVideoCall: boolean;
+  callOption: DirectCallOption;
+  customItems?: CustomItems;
+}
+
+export interface AcceptParams {
+  callOption: DirectCallOption;
+}
+
 export enum LoggerLevel {
   NONE = 'NONE',
   ERROR = 'ERROR'
@@ -42,15 +63,21 @@ export enum DirectCallEndResult {
 
 export interface SendBirdCallListener {
   onRinging: ((directCall: DirectCall) => void) | null;
+  onAudioInputDeviceChanged: ((currentAudioInputDevice: MediaDeviceInfo, availableAudioInputDevices: MediaDeviceInfo[]) => void)  | null;
+  onAudioOutputDeviceChanged: ((currentAudioOutputDevice: MediaDeviceInfo, availableAudioOutputDevices: MediaDeviceInfo[]) => void)  | null;
 }
 
 export interface DirectCall {
   onEstablished: ((call: DirectCall) => void) | null;
   onConnected: ((call: DirectCall) => void) | null;
+  onReconnected: ((call: DirectCall) => void) | null;
+  onReconnecting: ((call: DirectCall) => void) | null;
 
   //deprecated
   onRemoteAudioEnabled: ((call: DirectCall) => void) | null;
   onRemoteAudioSettingsChanged: ((call: DirectCall) => void) | null;
+  onCustomItemsUpdated: ((call: DirectCall, updatedKeys: string[]) => void) | null;
+  onCustomItemsDeleted: ((call: DirectCall, deletedKeys: string[]) => void) | null;
   onEnded: ((call: DirectCall) => void) | null;
 
   readonly caller: DirectCallUser;
@@ -63,9 +90,11 @@ export interface DirectCall {
   readonly myRole: DirectCallUserRole;
   readonly endedBy: DirectCallUser;
   readonly endResult: DirectCallEndResult;
+  readonly customItems: CustomItems;
 
   getDuration(): number;
-  accept(callOptions: DirectCallOption): void;
+  accept(callOption: DirectCallOption): void;
+  accept(params: AcceptParams): void;
   end(): void;
 
   //deprecated
@@ -76,6 +105,10 @@ export interface DirectCall {
 
   muteMicrophone(): void;
   unmuteMicrophone(): void;
+
+  updateCustomItems(customItems: CustomItems, callback?: CustomItemsHandler): Promise<CustomItemsResult>;
+  deleteCustomItems(customItemsKeys: string[], callback?: CustomItemsHandler): Promise<CustomItemsResult>;
+  deleteAllCustomItems(callback?: CustomItemsHandler): Promise<CustomItemsResult>;
 }
 
 export interface DirectCallOption {
@@ -107,6 +140,7 @@ export interface DirectCallLog {
   readonly duration: number;
   readonly endResult: DirectCallEndResult;
   readonly isVideoCall: boolean;
+  readonly customItems: CustomItems;
 }
 
 export interface DirectCallUser {
@@ -126,6 +160,11 @@ export interface AuthOption {
 export type AuthHandler = (user?: User, error?: Error) => void;
 export type DialHandler = (call?: DirectCall, error?: Error) => void;
 export type CompletionHandler = (error?: Error) => void;
+export type CustomItemsHandler = (result?: CustomItemsResult, error?: Error) => void;
+export interface CustomItemsResult {
+  readonly customItems: CustomItems;
+  readonly affectedKeys: string[];
+}
 
 export interface User {
   readonly userId: string;
@@ -139,4 +178,8 @@ export interface DirectCallLogListQueryParams {
   myRole?: DirectCallUserRole;
   endResults?: DirectCallEndResult[];
   limit?: number;
-}
+}
+
+export interface CustomItems {
+  [key: string]: string;
+}

SendBirdCall.min.js

@@ -1,6 +1,6 @@
 {
   "name": "sendbird-calls",
-  "version": "0.6.10",
+  "version": "0.7.0",
   "authors": [
     "SendBird <support@sendbird.com>"
   ],

bower.json

@@ -1,6 +1,6 @@
 {
   "name": "sendbird-calls",
-  "version": "0.6.10",
+  "version": "0.7.0",
   "description": "SendBird Calls JavaScript SDK",
   "main": "SendBirdCall.min.js",
   "types": "SendBirdCall.min.d.ts",