Merge c2fc995 into b16c7d1

README.md

@@ -50,6 +50,7 @@ const Component = () => {
 
   const {
     // connection info
+    isSessionInitialized,
     connectionId,
     isSessionConnected,
 
@@ -101,6 +102,7 @@ const [opentokProps, opentokMethods] = useOpenTok();
 
 const {
   // connection info
+  isSessionInitialized,
   connectionId,
   isSessionConnected,
 
@@ -138,6 +140,9 @@ initSessionAndConnect({
   token,
 });
 ```
+This methods will first initialize the session object, and continue connected to the session.
+
+After session initialized, the value of `isSessionInitialized` will be `true.
 
 After connect to session, you can get the `session`, `connectionId` , `isSessionConnected`, and `connections` properties from `opentokProps`:
 
@@ -160,6 +165,8 @@ const { disconnectSession } = opentokMethods;
 disconnectSession();
 ```
 
+> If you want to control the process of session initialization and connect to session on your own, check the method `initSession({ apiKey, sessionId, sessionOptions })` and `connectSession({token, sessionToConnect })`.
+
 ### Publish and unpublished stream to the session
 
 You can publish stream from camera or screen to session through the `publish` method.

src/index.js

@@ -61,7 +61,7 @@ const useOpenTok = () => {
     ({ apiKey, sessionId, sessionOptions }) =>
       new Promise(resolve => {
         const session = OT.initSession(apiKey, sessionId, sessionOptions);
-        action.update({ session });
+        action.update({ session, isSessionInitialized: true });
         resolve(session);
       }),
     [action]

src/index.test.js

@@ -14,10 +14,12 @@ describe('session initialization and connection', () => {
     let [opentokProps, opentokMethods] = result.current;
 
     expect(opentokProps.session).toBeUndefined();
+    expect(opentokProps.isSessionInitialized).toBeFalsy();
     await act(() => opentokMethods.initSession(MOCK_CREDENTIALS));
 
     [opentokProps, opentokMethods] = result.current;
     expect(opentokProps.session).toBeDefined();
+    expect(opentokProps.isSessionInitialized).toBeTruthy();
   });
 
   it('connectSession', async () => {

src/libs/use-opentok-reducer.js

@@ -2,6 +2,7 @@ import { useReducer, useMemo } from 'react';
 
 const initialState = {
   // connection info
+  isSessionInitialized: false,
   connectionId: undefined,
   isSessionConnected: false,