DEV Community: Abdul Muqeet

Video SDK for Web JQuery - Meet Hour

Abdul Muqeet — Thu, 08 Jun 2023 15:15:01 +0000

MeetHour - JQuery Example

SDK Example Link - https://github.com/v-empower/MeetHour-Web-MobileSDKs
API Documentation Link - https://docs.v-empower.com/docs/MeetHour-API/

Steps to Use Meet Hour Web Jquery Example

Go to meethour.io and signup for Developer or Higher plan. Currently we offer 28 days free trial.
Go to the dashboard and then click on developers menu.
Copy your Client ID, Client Secret and Api Key. After copying, paste each copied text to the respective constant in the source code js/constants.js
On Home page Click on Get Access Token
Then Try Schedule a Meeting & Join Meeting.

Run Program

Go to Browser and open index.html

Library Import

   <script src="https://api.meethour.io/libs/v2.4.6/external_api.min.js?apiKey=${API_KEY}"><script>
   <script src="https://api.meethour.io/libs/v2.4.6/meethour-apis.min.js?apiKey=${API_KEY}"></script>

API End Points Supported

To Get Access Token Endpoint : => https://docs.v-empower.com/docs/MeetHour-API/a44a7d7669f91-user-login-get-access-token

       ApiServices.login({
               grant_type, client_id, client_secret, username, password
           });

=> You have to pass respective values in the argument section. Hence, to get desired response.

To schedule a meeting: => https://docs.v-empower.com/docs/MeetHour-API/2de4b757a6312-meeting-schedule-meeting

       ApiServices.scheduleMeeting(token: string, body: ScheduleMeetingType)

           type ScheduleMeetingType {
                   agenda?: string;
                   attend?:
                       | Array<number>
                       | Array<UserObjectType>
                       | Array<UserObjectType | number>;
                   default_recording_storage?: string;
                   duration_hr?: number;
                   duration_min?: number;
                   enable_pre_registration?: number;
                   endBy?: string;
                   end_date_time?: string;
                   end_times?: number;
                   groups?: Array<number | string>;
                   hostusers?:
                       | Array<number>
                       | Array<UserObjectType>
                       | Array<UserObjectType | number>;
                   instructions?: string;
                   is_recurring?: number;
                   is_show_portal?: number;
                   meeting_agenda?: string;
                   meeting_date: string;
                   meeting_meridiem: string;
                   meeting_name: string;
                   meeting_time: string;
                   meeting_topic?: string;
                   monthlyBy?: string;
                   monthlyByDay?: string;
                   monthlyByWeekday?: string;
                   monthlyByWeekdayIndex?: string;
                   options?: Array<string>;
                   passcode: string;
                   recurring_type?: string;
                   repeat_interval?: number;
                   send_calendar_invite?: number;
                   timezone: string;
                   weeklyWeekDays?: number;
               };


       type UserObjectType {
               email?: string;
               first_name?: string;
               last_name?: string;
           }

To Generate JWT Token Endpoint => https://docs.v-empower.com/docs/MeetHour-API/b7e3d0ab3906f-generate-jwt

       ApiServices.generateJwt(token: string, body: GenerateJwtType)

      type GenerateJwtType {
               config?: {
               disableDeepLinking?: string;
               dropboxappKey?: string;
               dropboxredirectURI?: string;
               enableClosePage?: string;
               enableWelcomePage?: string;
               fileRecordingsEnabled?: boolean;
               liveStreamingEnabled?: boolean;
               p2penabled?: boolean;
               requireDisplayName?: string;
               resolution?: number;
               startAudioMuted?: number;
               videoheightideal?: number;
               videoheightmax?: number;
               videoheightmin?: number;
               videowidthideal?: number;
               videowidthmax?: number;
               videowidthmin?: number;
               };
               contact_id?: number;
               meeting_id: string;
               ui_config?: {
               ANDROID_APP_PACKAGE?: string;
               APP_NAME?: string;
               APP_SCHEME?: string;
               BRAND_WATERMARK_BACKGROUND?: string;
               DEFAULT_LOGO_URL?: string;
               ENABLE_MOBILE_BROWSER?: string;
               HIDE_DEEP_LINKING_LOGO?: string;
               MEET_HOUR_WATERMARK_LINK?: string;
               MOBILE_APP_PROMO?: string;
               MOBILE_DOWNLOAD_LINK_ANDROID?: string;
               MOBILE_DOWNLOAD_LINK_IOS?: string;
               NATIVE_APP_NAME?: string;
               PROVIDER_NAME?: string;
               SHOW_MEET_HOUR_WATERMARK?: string;
               disablePrejoinFooter?: string;
               disablePrejoinHeader?: string;
               toolbar_buttons?: Array<string>;
               };
           };

To fetch User Details: => https://docs.v-empower.com/docs/MeetHour-API/ff9d0e37d9191-user-details

       ApiServices.userDetails(token: string)

To fetch access Token using Refresh Token: => https://docs.v-empower.com/docs/MeetHour-API/d851be1af9804-get-access-token-using-refresh-token

       ApiServices.getRefreshToken(token: string, body: RefreshTokenType)

       type RefreshTokenType {
               client_id: string;
               client_secret: string;
               grant_type: string;
               refresh_token: string;
       }

To add a contact in Meet Hour database: => https://docs.v-empower.com/docs/MeetHour-API/bd1e416413e8c-add-contact

       ApiServices.addContact(token: string, body: AddContactType)

       type AddContactType {
               country_code?: string;
               email: string;
               firstname: string;
               image?: string;
               is_show_portal?: boolean;
               lastname?: string;
               phone?: string;
           }

To get Timezones of various countries: => https://docs.v-empower.com/docs/MeetHour-API/c688c29bce9b9-timezone-list

       ApiServices.timezone(token: string)

To get list of all the contacts in your Meet Hour account: => https://api.meethour.io/api/{version}/customer/contacts

       ApiServices.contactsList(token: string, body: ContactsType)

       type ContactsType {
               exclude_hosts: number;
               limit: number;
               page: number;
           }

To make changes in the existing contact details: => https://docs.v-empower.com/docs/MeetHour-API/28cae9187d215-edit-contact

    ApiServices.editContact(token: string, body: EditContactType)

    type EditContactType {
            contact_id: number;
            country_code: string;
            email: string;
            firstname: string;
            image: string;
            is_show_portal: boolean;
            lastname: string;
            phone: string;
        }

    ```

To get Upcoming Meetings: => https://docs.v-empower.com/docs/MeetHour-API/31df88388416d-upcoming-meetings



    ApiServices.upcomingMeetings(token: string, body: {
        limit: number;
        page: number;
    })

To archive a meeting: => https://docs.v-empower.com/docs/MeetHour-API/1dd64523cc6bf-archive-meeting



    ApiServices.archiveMeeting(
            token: string,
            body: {
                id?: number;
        })

To get the details of a missed meeting: => https://docs.v-empower.com/docs/MeetHour-API/92998e2dda102-missed-meetings



    ApiServices.missedMeetings(
        token: string,
        body: {
            limit: number;
            page: number;
        })

To get completed meetings: => https://docs.v-empower.com/docs/MeetHour-API/aa9ef6a678250-completed-meetings



    ApiServices.completedMeetings(
        token: string,
        body: {
        limit: number;
        page: number;
        })

To edit an existing meeting: => https://docs.v-empower.com/docs/MeetHour-API/5dedde36380b4-meeting-edit-meeting



    ApiServices.editMeeting(token: string, body: EditMeetingType)

    type EditMeeting {
        agenda?: string;
        attend?:
            | Array<number>
            | Array<UserObjectType>
            | Array<number & UserObjectType>;
        duration_hr?: number;
        duration_min?: number;
        enable_pre_registration?: number;
        endBy?: string;
        end_date_time?: string;
        groups?: Array<number>;
        hostusers?:
            | Array<number>
            | Array<UserObjectType>
            | Array<number & UserObjectType>;
        instructions?: string;
        is_recurring?: number;
        is_show_portal?: number;
        meeting_agenda?: string;
        meeting_date?: string;
        meeting_id: string;
        meeting_meridiem?: string;
        meeting_name?: string;
        meeting_time?: string;
        meeting_topic?: string;
        old_attend?:
            | Array<number>
            | Array<UserObjectType>
            | Array<number & UserObjectType>;
        options?: Array<string>;
        passcode?: string;
        recurring_type?: string;
        repeat_interval?: number;
        timezone?: string;
    }

    type UserObjectType {
        email?: string;
        first_name?: string;
        last_name?: string;
    }

To view a meeting: => https://docs.v-empower.com/docs/MeetHour-API/7e9a0a1e0da7f-meeting-view-meeting



    ApiServices.viewMeeting(
        token: string,
        body: { meeting_id: string }
        )

To get all the recordings list: => https://docs.v-empower.com/docs/MeetHour-API/ce7c4fd8cae7e-recording-list



    ApiServices.recordingsList(token: string, body: RecordingsList)

    type RecordingsList {
        filter_by: string;
        limit: number;
        page: number;
    }

Join Conference API

api = new MeetHourExternalAPI(domain, options)

domain: domain used to build the conference URL, 'meethour.io' for example.
options: object with properties - the optional arguments:
- roomName: (required) name of the room to join.
- apiKey: (required). You will get API key from your Developer Page - https://portal.meethour.io/customer/developers. Make sure you are on our Developer or higher plan. - https://meethour.io/#pricing
- jwt: (required - If you to start meeting or join or moderator) - https://docs.v-empower.com/docs/MeetHour-API/b3A6MzcwODk5MTQ-generate-jwt
- pcode: (optional) Pass encrypted Meeting Password dynamically. Get this from API.
- width: (optional) width for the iframe which will be created. If a number is specified it's treated as pixel units. If a string is specified the format is number followed by 'px', 'em', 'pt' or '%'.
- height: (optional) height for the iframe which will be created. If a number is specified it's treated as pixel units. If a string is specified the format is number followed by 'px', 'em', 'pt' or '%'.
- parentNode: (optional) HTML DOM Element where the iframe will be added as a child.
- noSSL: (optional, defaults to true) Boolean indicating if the server should be contacted using HTTP or HTTPS.
- onload: (optional) handler for the iframe onload event.
- invitees: (optional) Array of objects containing information about new participants that will be invited in the call.
- devices: (optional) A map containing information about the initial devices that will be used in the call.
- userInfo: (optional) JS object containing information about the participant opening the meeting, such as email.

Example:


javascript
const domain = 'meethour.io';
const options = {
    roomName: 'TestRoom',
    width: 700,
    height: 700,
    parentNode: document.querySelector('#meet')
};
const api = new MeetHourExternalAPI(domain, options);

You can set the initial media devices for the call:


javascript
const domain = 'meethour.io';
const options = {
    ...
    devices: {
        audioInput: '<deviceLabel>',
        audioOutput: '<deviceLabel>',
        videoInput: '<deviceLabel>'
    },
    ...
};
const api = new MeetHourExternalAPI(domain, options);

You can overwrite options set in [config.js] and [interface_config.js].
For example, to enable the filmstrip-only interface mode, you can use:


javascript
const options = {
    ...
    interfaceConfigOverwrite: { filmStripOnly: true },
    ...
};
const api = new MeetHourExternalAPI(domain, options);

You can also pass a jwt token to Meet Hour:


javascript
const options = {
    ...
    jwt: '<jwt_token>',
    noSsl: false,
    ...
};
const api = new MeetHourExternalAPI(domain, options);

You can set the userInfo(email, display name) for the call:


javascript
var domain = "meethour.io";
var options = {
    ...
    userInfo: {
        email: 'email@meethourexamplemail.com',
        displayName: 'John Doe'
    }
}
var api = new MeetHourExternalAPI(domain, options);

Controlling the embedded Meet Hour Conference

Device management MeetHourExternalAPI methods:

getAvailableDevices - Retrieve a list of available devices.


javascript
api.getAvailableDevices().then(devices => {
    devices = {
        audioInput: [{
            deviceId: 'ID'
            groupId: 'grpID'
            kind: 'audioinput'
            label: 'label'
        },....],
        audioOutput: [{
            deviceId: 'ID'
            groupId: 'grpID'
            kind: 'audioOutput'
            label: 'label'
        },....],
        videoInput: [{
            deviceId: 'ID'
            groupId: 'grpID'
            kind: 'videoInput'
            label: 'label'
        },....]
    }
    ...
});

getCurrentDevices - Retrieve a list with the devices that are currently selected.


javascript
api.getCurrentDevices().then(devices => {
    devices = {
        audioInput: {
            deviceId: 'ID'
            groupId: 'grpID'
            kind: 'videoInput'
            label: 'label'
        },
        audioOutput: {
            deviceId: 'ID'
            groupId: 'grpID'
            kind: 'videoInput'
            label: 'label'
        },
        videoInput: {
            deviceId: 'ID'
            groupId: 'grpID'
            kind: 'videoInput'
            label: 'label'
        }
    }
    ...
});

isDeviceChangeAvailable - Resolves with true if the device change is available and with false if not.


javascript
// The accepted deviceType values are - 'output', 'input' or undefined.
api.isDeviceChangeAvailable(deviceType).then(isDeviceChangeAvailable => {
    ...
});

isDeviceListAvailable - Resolves with true if the device list is available and with false if not.


javascript
api.isDeviceListAvailable().then(isDeviceListAvailable => {
    ...
});

isMultipleAudioInputSupported - Resolves with true if multiple audio input is supported and with false if not.


javascript
api.isMultipleAudioInputSupported().then(isMultipleAudioInputSupported => {
    ...
});

setAudioInputDevice - Sets the audio input device to the one with the label or id that is passed.


javascript
api.setAudioInputDevice(deviceLabel, deviceId);

setAudioOutputDevice - Sets the audio output device to the one with the label or id that is passed.


javascript
api.setAudioOutputDevice(deviceLabel, deviceId);

setVideoInputDevice - Sets the video input device to the one with the label or id that is passed.


javascript
api.setVideoInputDevice(deviceLabel, deviceId);

You can control the embedded Meet Hour conference using the MeetHourExternalAPI object by using executeCommand:


javascript
api.executeCommand(command, ...arguments);

The command parameter is String object with the name of the command. The following commands are currently supported:

displayName - Sets the display name of the local participant. This command requires one argument - the new display name to be set. ``` javascript api.executeCommand('displayName', 'New Nickname');


* **password** - Sets the password for the room. This command requires one argument - the password name to be set.

javascript
api.executeCommand('password', 'The Password');


* **sendTones** - Play touch tones.

javascript
api.executeCommand('sendTones', {
tones: string, // The dial pad touch tones to play. For example, '12345#'.
duration: number, // Optional. The number of milliseconds each tone should play. The default is 200.
pause: number // Optional. The number of milliseconds between each tone. The default is 200.
});


* **subject** - Sets the subject of the conference. This command requires one argument - the new subject to be set.

javascript
api.executeCommand('subject', 'New Conference Subject');


* **toggleAudio** - Mutes / unmutes the audio for the local participant. No arguments are required.

javascript
api.executeCommand('toggleAudio');


* **toggleVideo** - Mutes / unmutes the video for the local participant. No arguments are required.

javascript
api.executeCommand('toggleVideo');


* **toggleFilmStrip** - Hides / shows the filmstrip. No arguments are required.

javascript
api.executeCommand('toggleFilmStrip');


* **toggleChat** - Hides / shows the chat. No arguments are required.

javascript
api.executeCommand('toggleChat');


* **toggleShareScreen** - Starts / stops screen sharing. No arguments are required.

javascript
api.executeCommand('toggleShareScreen');


* **toggleTileView** - Enter / exit tile view layout mode. No arguments are required.

javascript
api.executeCommand('toggleTileView');


* **hangup** - Hangups the call. No arguments are required.

javascript
api.executeCommand('hangup');


* **email** - Changes the local email address. This command requires one argument - the new email address to be set.

javascript
api.executeCommand('email', 'example@example.com');


* **avatarUrl** - Changes the local avatar URL. This command requires one argument - the new avatar URL to be set.

javascript
api.executeCommand('avatarUrl', 'https://avatars0.githubusercontent.com/u/3671647');


* **sendEndpointTextMessage** - Sends a text message to another participant through the datachannels.

javascript
api.executeCommand('receiverParticipantId', 'text');

* **setVideoQuality** - Sets the send and receive video resolution. This command requires one argument - the resolution height to be set.

javascript
api.executeCommand('setVideoQuality', 720);


You can also execute multiple commands using the `executeCommands` method:

javascript
api.executeCommands(commands);

The `commands` parameter is an object with the names of the commands as keys and the arguments for the commands as values:

javascript
api.executeCommands({
displayName: [ 'nickname' ],
toggleAudio: []
});


You can add event listeners to the embedded Meet Hour using the `addEventListener` method.
**NOTE: This method still exists but it is deprecated. MeetHourExternalAPI class extends [EventEmitter]. Use [EventEmitter] methods (`addListener` or `on`).**

javascript
api.addEventListener(event, listener);


The `event` parameter is a String object with the name of the event.
The `listener` parameter is a Function object with one argument that will be notified when the event occurs with data related to the event.

The following events are currently supported:
* **cameraError** - event notifications about meethour-Meet having failed to access the camera. The listener will receive an object with the following structure:

javascript
{
type: string, // A constant representing the overall type of the error.
message: string // Additional information about the error.
}


* **avatarChanged** - event notifications about avatar
changes. The listener will receive an object with the following structure:

javascript
{
id: string, // the id of the participant that changed his avatar.
avatarURL: string // the new avatar URL.
}


* **audioAvailabilityChanged** - event notifications about audio availability status changes. The listener will receive an object with the following structure:

javascript
{
available: boolean // new available status - boolean
}


* **audioMuteStatusChanged** - event notifications about audio mute status changes. The listener will receive an object with the following structure:

javascript
{
muted: boolean // new muted status - boolean
}


* **endpointTextMessageReceived** - event notifications about a text message received through datachannels.
The listener will receive an object with the following structure:

javascript
{
senderInfo: {
jid: string, // the jid of the sender
id: string // the participant id of the sender
},
eventData: {
name: string // the name of the datachannel event: endpoint-text-message
text: string // the received text from the sender
}
}


* **micError** - event notifications about meethour-Meet having failed to access the mic. The listener will receive an object with the following structure:

javascript
{
type: string, // A constant representing the overall type of the error.
message: string // Additional information about the error.
}


* **screenSharingStatusChanged** - receives event notifications about turning on/off the local user screen sharing. The listener will receive object with the following structure:

javascript
{
on: boolean, //whether screen sharing is on
details: {

    // From where the screen sharing is capturing, if known. Values which are
    // passed include 'window', 'screen', 'proxy', 'device'. The value undefined
    // will be passed if the source type is unknown or screen share is off.
    sourceType: string|undefined
}

}


* **dominantSpeakerChanged** - receives event notifications about change in the dominant speaker. The listener will receive object with the following structure:

javascript
{
id: string //participantId of the new dominant speaker
}


* **tileViewChanged** - event notifications about tile view layout mode being entered or exited. The listener will receive object with the following structure:

javascript
{
enabled: boolean, // whether tile view is not displayed or not
}


* **incomingMessage** - Event notifications about incoming
messages. The listener will receive an object with the following structure:

javascript
{
from: string, // The id of the user that sent the message
nick: string, // the nickname of the user that sent the message
message: string // the text of the message
}


* **outgoingMessage** - Event notifications about outgoing
messages. The listener will receive an object with the following structure:

javascript
{
message: string // the text of the message
}


* **displayNameChange** - event notifications about display name
changes. The listener will receive an object with the following structure:

javascript
{
id: string, // the id of the participant that changed his display name
displayname: string // the new display name
}


* **deviceListChanged** - event notifications about device list changes. The listener will receive an object with the following structure:

javascript
{
devices: Object // the new list of available devices.
}

NOTE: The devices object has the same format as the getAvailableDevices result format.

* **emailChange** - event notifications about email
changes. The listener will receive an object with the following structure:

javascript
{
id: string, // the id of the participant that changed his email
email: string // the new email
}

* **feedbackSubmitted** - event notifications about conference feedback submission

javascript
{
error: string // The error which occurred during submission, if any.
}


* **filmstripDisplayChanged** - event notifications about the visibility of the filmstrip being updated.

javascript
{
visible: boolean // Whether or not the filmstrip is displayed or hidden.
}


* **participantJoined** - event notifications about new participants who join the room. The listener will receive an object with the following structure:

javascript
{
id: string, // the id of the participant
displayName: string // the display name of the participant
}


* **participantKickedOut** - event notifications about a participants being removed from the room. The listener will receive an object with the following structure:

javascript
{
kicked: {
id: string, // the id of the participant removed from the room
local: boolean // whether or not the participant is the local particiapnt
},
kicker: {
id: string // the id of the participant who kicked out the other participant
}
}


* **participantLeft** - event notifications about participants that leave the room. The listener will receive an object with the following structure:

javascript
{
id: string // the id of the participant
}


* **participantRoleChanged** - event notification fired when the role of the local user has changed (none, moderator, participant). The listener will receive an object with the following structure:

javascript
{
id: string // the id of the participant
role: string // the new role of the participant
}


* **passwordRequired** - event notifications fired when failing to join a room because it has a password.



* **videoConferenceJoined** - event notifications fired when the local user has joined the video conference. The listener will receive an object with the following structure:

javascript
{
roomName: string, // the room name of the conference
id: string, // the id of the local participant
displayName: string, // the display name of the local participant
avatarURL: string // the avatar URL of the local participant
}


* **videoConferenceLeft** - event notifications fired when the local user has left the video conference. The listener will receive an object with the following structure:

javascript
{
roomName: string // the room name of the conference
}


* **videoAvailabilityChanged** - event notifications about video availability status changes. The listener will receive an object with the following structure:

javascript
{
available: boolean // new available status - boolean
}


* **videoMuteStatusChanged** - event notifications about video mute status changes. The listener will receive an object with the following structure:

javascript
{
muted: boolean // new muted status - boolean
}


* **readyToClose** - event notification fired when Meet Hour is ready to be closed (hangup operations are completed).

* **subjectChange** - event notifications about subject of conference changes.
The listener will receive an object with the following structure:

javascript
{
subject: string // the new subject
}


* **suspendDetected** - event notifications about detecting suspend event in host computer.

You can also add multiple event listeners by using `addEventListeners`.
This method requires one argument of type Object. The object argument must
have the names of the events as keys and the listeners of the events as values.
**NOTE: This method still exists but it is deprecated. MeetHourExternalAPI class extends [EventEmitter]. Use [EventEmitter] methods.**

javascript
function incomingMessageListener(object)
{
// ...
}

function outgoingMessageListener(object)
{
// ...
}

api.addEventListeners({
incomingMessage: incomingMessageListener,
outgoingMessage: outgoingMessageListener
});


If you want to remove a listener you can use `removeEventListener` method with argument the name of the event.
**NOTE: This method still exists but it is deprecated. MeetHourExternalAPI class extends [EventEmitter]. Use [EventEmitter] methods( `removeListener`).**

javascript
api.removeEventListener('incomingMessage');


If you want to remove more than one event you can use `removeEventListeners` method with an Array with the names of the events as an argument.
**NOTE: This method still exists but it is deprecated. MeetHourExternalAPI class extends [EventEmitter]. Use [EventEmitter] methods.**

javascript
api.removeEventListeners([ 'incomingMessage', 'outgoingMessageListener' ]);


You can get the number of participants in the conference with the following API function:

javascript
const numberOfParticipants = api.getNumberOfParticipants();


You can get the avatar URL of a participant in the conference with the following API function:

javascript
const avatarURL = api.getAvatarURL(participantId);


You can get the display name of a participant in the conference with the following API function:

javascript
const displayName = api.getDisplayName(participantId);


You can get the email of a participant in the conference with the following API function:

javascript
const email = api.getEmail(participantId);


You can get the iframe HTML element where Meet Hour is loaded with the following API function:

javascript
const iframe = api.getIFrame();


You can check whether the audio is muted with the following API function:

javascript
api.isAudioMuted().then(muted => {
...
});


You can check whether the video is muted with the following API function:

javascript
api.isVideoMuted().then(muted => {
...
});


You can check whether the audio is available with the following API function:

javascript
api.isAudioAvailable().then(available => {
...
});


You can check whether the video is available with the following API function:

javascript
api.isVideoAvailable().then(available => {
...
});


You can invite new participants to the call with the following API function:

javascript
api.invite([ {...}, {...}, {...} ]).then(() => {
// success
}).catch(() => {
// failure
});

**NOTE: The format of the invitees in the array depends on the invite service used for the deployment.**

You can remove the embedded Meet Hour Conference with the following API function:

javascript
api.dispose();

Video SDK for Web - Generic Javascript | Meet Hour

Abdul Muqeet — Thu, 08 Jun 2023 15:13:16 +0000

[MeetHour - Generic Javascript SDK]

SDK Example Link - https://github.com/v-empower/MeetHour-Web-MobileSDKs
API Documentation Link - https://docs.v-empower.com/docs/MeetHour-API/

Steps to Integrate:

Signup for Meet Hour (https://meethour.io) and signup for Developer or Higher plan. Currently we offer 28 days free trial.
Once you signup for developer plan, and go to our Dashboard - (https://portal.meethour.io) and tap on "Developers" menu.
Now copy and Client ID & Client Secret and keep it handy with you.
Go to our API documentation and hit Login API to get oAuth Access Token - (https://bit.ly/3E2hKU7)
Once you get an access token, you can access any our API. Now you first thing you have to do is create a contact in our system as soon as user signup in your platform using this API (https://bit.ly/3flms7q). This will give you unique contact_id of that user. You require this id when you schedule a meeting below.
Later go to Schedule Meeting API -> Pass all the parameters needed to generate a new meetings - (https://bit.ly/3h0qpis)
Once the meeting is genereate, in order to join a meeting you require to Generate JWT Token using this API (https://bit.ly/3sJaojD) and pass it to the conference URL via MT Parameter - https://meethour.io?mt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiIsImFjY2Vzc190b2tlbiI6ImV5SjBlWEFpT2lKS1YxUWlMQ0poYkdjaU9pSlNVekkxTmlKOS5leUpoZFdRaU9pSTVNemxrWmpVeE5pMDJNekEzTFRRNVkyUXRPVGMxTXkwek1XRTNNemRrT1RGaE1HWWlMQ0pxZEdraU9pSmtNMlUyT

MeetHour Embed Meeting

All the Conference UI is managed from this page - https://portal.meethour.io/customer/ui_settings

You can also try Embed Meeting via below code. Change the Meeting URL in below

<html>
    <head>
        <meta name="viewport" content="width=device-width, initial-scale=1.0,user-scalable=0">
    </head>
<body>
    <iframe allow="camera; microphone; display-capture; autoplay; clipboard-write" src="https://meethour.io/TestRoom#interfaceConfig.applyMeetingSettings=true&interfaceConfig.disablePrejoinHeader=true&interfaceConfig.ENABLE_DESKTOP_DEEPLINK=false&interfaceConfig.disablePrejoinFooter=true&interfaceConfig.SHOW_MEET_HOUR_WATERMARK=false&interfaceConfig.HIDE_DEEP_LINKING_LOGO=true&interfaceConfig.MOBILE_APP_PROMO=false&interfaceConfig.ENABLE_MOBILE_BROWSER=true&appData.localStorageContent=null" name="mhConferenceFrame0" id="mhConferenceFrame0" allowfullscreen="true" style="height: 100%; width: 600px; border: 0px;"></iframe>
</body>
</html>

Meet Hour External Javascript API - SDK (Checkout Example.html)

Installation

To add Meet Hour programmatically, please use our Javascript API library:

API Documentation - https://docs.v-empower.com/docs/MeetHour-API/

Web Javascript SDK

        <script src="https://api.meethour.io/libs/v2.4.5/external_api.min.js?apiKey=f6282h82729080282928298"></script>

`api = new MeetHourExternalAPI(domain, options)`

Config & User Interface Settings Parameters - Parameters - https://docs.v-empower.com/docs/MeetHour-API/281f2d9a6c539-generate-jwt

The next step for embedding Meet Hour is to create the Meet Hour API object.
Its constructor gets a number of options:

domain: domain used to build the conference URL, 'meethour.io' for example.
options: object with properties - the optional arguments:
- roomName: (required) name of the room to join.
- apiKey: (required). You will get API key from your Developer Page - https://portal.meethour.io/customer/developers. Make sure you are on our Developer or higher plan. - https://meethour.io/#pricing
- jwt: (required - If you to start meeting or join or moderator) - https://docs.v-empower.com/docs/MeetHour-API/b3A6MzcwODk5MTQ-generate-jwt
- pcode: (optional) Pass encrypted Meeting Password dynamically. Get this from API.
- width: (optional) width for the iframe which will be created. If a number is specified it's treated as pixel units. If a string is specified the format is number followed by 'px', 'em', 'pt' or '%'.
- height: (optional) height for the iframe which will be created. If a number is specified it's treated as pixel units. If a string is specified the format is number followed by 'px', 'em', 'pt' or '%'.
- parentNode: (optional) HTML DOM Element where the iframe will be added as a child.
- noSSL: (optional, defaults to true) Boolean indicating if the server should be contacted using HTTP or HTTPS.
- onload: (optional) handler for the iframe onload event.
- invitees: (optional) Array of objects containing information about new participants that will be invited in the call.
- devices: (optional) A map containing information about the initial devices that will be used in the call.
- userInfo: (optional) JS object containing information about the participant opening the meeting, such as email.

```Javascript Standard Example





Example:



```javascript
const domain = 'meethour.io';
const options = {
    roomName: 'MeetHourExternalAPI',
    width: 700,
    height: 700,
    parentNode: document.querySelector('#meet')
};
const api = new MeetHourExternalAPI(domain, options);

You can set the initial media devices for the call:

const domain = 'meethour.io';
const options = {
    ...
    devices: {
        audioInput: '<deviceLabel>',
        audioOutput: '<deviceLabel>',
        videoInput: '<deviceLabel>'
    },
    ...
};
const api = new MeetHourExternalAPI(domain, options);

You can overwrite options set in [config.js] and [interface_config.js].
For example, to enable the filmstrip-only interface mode, you can use:

const options = {
    ...
    interfaceConfigOverwrite: { filmStripOnly: true },
    ...
};
const api = new MeetHourExternalAPI(domain, options);

You can also pass a jwt token to Meet Hour:

const options = {
    ...
    jwt: '<jwt_token>',
    noSsl: false,
    ...
};
const api = new MeetHourExternalAPI(domain, options);

You can set the userInfo(email, display name) for the call:

var domain = "meethour.io";
var options = {
    ...
    userInfo: {
        email: 'email@meethourexamplemail.com',
        displayName: 'John Doe'
    }
}
var api = new MeetHourExternalAPI(domain, options);

Controlling the embedded Meet Hour Conference

Device management MeetHourExternalAPI methods:

getAvailableDevices - Retrieve a list of available devices.

api.getAvailableDevices().then(devices => {
    devices = {
        audioInput: [{
            deviceId: 'ID'
            groupId: 'grpID'
            kind: 'audioinput'
            label: 'label'
        },....],
        audioOutput: [{
            deviceId: 'ID'
            groupId: 'grpID'
            kind: 'audioOutput'
            label: 'label'
        },....],
        videoInput: [{
            deviceId: 'ID'
            groupId: 'grpID'
            kind: 'videoInput'
            label: 'label'
        },....]
    }
    ...
});

getCurrentDevices - Retrieve a list with the devices that are currently selected.

api.getCurrentDevices().then(devices => {
    devices = {
        audioInput: {
            deviceId: 'ID'
            groupId: 'grpID'
            kind: 'videoInput'
            label: 'label'
        },
        audioOutput: {
            deviceId: 'ID'
            groupId: 'grpID'
            kind: 'videoInput'
            label: 'label'
        },
        videoInput: {
            deviceId: 'ID'
            groupId: 'grpID'
            kind: 'videoInput'
            label: 'label'
        }
    }
    ...
});

isDeviceChangeAvailable - Resolves with true if the device change is available and with false if not.

// The accepted deviceType values are - 'output', 'input' or undefined.
api.isDeviceChangeAvailable(deviceType).then(isDeviceChangeAvailable => {
    ...
});

isDeviceListAvailable - Resolves with true if the device list is available and with false if not.

api.isDeviceListAvailable().then(isDeviceListAvailable => {
    ...
});

isMultipleAudioInputSupported - Resolves with true if multiple audio input is supported and with false if not.

api.isMultipleAudioInputSupported().then(isMultipleAudioInputSupported => {
    ...
});

setAudioInputDevice - Sets the audio input device to the one with the label or id that is passed.

api.setAudioInputDevice(deviceLabel, deviceId);

setAudioOutputDevice - Sets the audio output device to the one with the label or id that is passed.

api.setAudioOutputDevice(deviceLabel, deviceId);

setVideoInputDevice - Sets the video input device to the one with the label or id that is passed.

api.setVideoInputDevice(deviceLabel, deviceId);

You can control the embedded Meet Hour conference using the MeetHourExternalAPI object by using executeCommand:

api.executeCommand(command, ...arguments);

The command parameter is String object with the name of the command. The following commands are currently supported:

displayName - Sets the display name of the local participant. This command requires one argument - the new display name to be set.

api.executeCommand('displayName', 'New Nickname');

password - Sets the password for the room. This command requires one argument - the password name to be set.

api.executeCommand('password', 'The Password');

sendTones - Play touch tones.

api.executeCommand('sendTones', {
    tones: string, // The dial pad touch tones to play. For example, '12345#'.
    duration: number, // Optional. The number of milliseconds each tone should play. The default is 200.
    pause: number // Optional. The number of milliseconds between each tone. The default is 200.
});

subject - Sets the subject of the conference. This command requires one argument - the new subject to be set.

api.executeCommand('subject', 'New Conference Subject');

toggleAudio - Mutes / unmutes the audio for the local participant. No arguments are required.

api.executeCommand('toggleAudio');

toggleVideo - Mutes / unmutes the video for the local participant. No arguments are required.

api.executeCommand('toggleVideo');

toggleFilmStrip - Hides / shows the filmstrip. No arguments are required.

api.executeCommand('toggleFilmStrip');

toggleChat - Hides / shows the chat. No arguments are required.

api.executeCommand('toggleChat');

toggleShareScreen - Starts / stops screen sharing. No arguments are required.

api.executeCommand('toggleShareScreen');

toggleTileView - Enter / exit tile view layout mode. No arguments are required.

api.executeCommand('toggleTileView');

hangup - Hangups the call. No arguments are required.

api.executeCommand('hangup');

email - Changes the local email address. This command requires one argument - the new email address to be set.

api.executeCommand('email', 'example@example.com');

avatarUrl - Changes the local avatar URL. This command requires one argument - the new avatar URL to be set.

api.executeCommand('avatarUrl', 'https://avatars0.githubusercontent.com/u/3671647');

sendEndpointTextMessage - Sends a text message to another participant through the datachannels.

api.executeCommand('receiverParticipantId', 'text');

setVideoQuality - Sets the send and receive video resolution. This command requires one argument - the resolution height to be set.

api.executeCommand('setVideoQuality', 720);

You can also execute multiple commands using the executeCommands method:

api.executeCommands(commands);

The commands parameter is an object with the names of the commands as keys and the arguments for the commands as values:

api.executeCommands({
    displayName: [ 'nickname' ],
    toggleAudio: []
});

You can add event listeners to the embedded Meet Hour using the addEventListener method.
NOTE: This method still exists but it is deprecated. MeetHourExternalAPI class extends [EventEmitter]. Use [EventEmitter] methods (addListener or on).

api.addEventListener(event, listener);

The event parameter is a String object with the name of the event.
The listener parameter is a Function object with one argument that will be notified when the event occurs with data related to the event.

The following events are currently supported:

cameraError - event notifications about meethour-Meet having failed to access the camera. The listener will receive an object with the following structure:

{
    type: string, // A constant representing the overall type of the error.
    message: string // Additional information about the error.
}

avatarChanged - event notifications about avatar changes. The listener will receive an object with the following structure:

{
    id: string, // the id of the participant that changed his avatar.
    avatarURL: string // the new avatar URL.
}

audioAvailabilityChanged - event notifications about audio availability status changes. The listener will receive an object with the following structure:

{
    available: boolean // new available status - boolean
}

audioMuteStatusChanged - event notifications about audio mute status changes. The listener will receive an object with the following structure:

{
    muted: boolean // new muted status - boolean
}

endpointTextMessageReceived - event notifications about a text message received through datachannels. The listener will receive an object with the following structure:

{
    senderInfo: {
        jid: string, // the jid of the sender
        id: string // the participant id of the sender
    },
    eventData: {
        name: string // the name of the datachannel event: `endpoint-text-message`
        text: string // the received text from the sender
    }
}

micError - event notifications about meethour-Meet having failed to access the mic. The listener will receive an object with the following structure:

{
    type: string, // A constant representing the overall type of the error.
    message: string // Additional information about the error.
}

screenSharingStatusChanged - receives event notifications about turning on/off the local user screen sharing. The listener will receive object with the following structure:

{
    on: boolean, //whether screen sharing is on
    details: {

        // From where the screen sharing is capturing, if known. Values which are
        // passed include 'window', 'screen', 'proxy', 'device'. The value undefined
        // will be passed if the source type is unknown or screen share is off.
        sourceType: string|undefined
    }
}

dominantSpeakerChanged - receives event notifications about change in the dominant speaker. The listener will receive object with the following structure:

{
    id: string //participantId of the new dominant speaker
}

tileViewChanged - event notifications about tile view layout mode being entered or exited. The listener will receive object with the following structure:

{
    enabled: boolean, // whether tile view is not displayed or not
}

incomingMessage - Event notifications about incoming messages. The listener will receive an object with the following structure:

{
    from: string, // The id of the user that sent the message
    nick: string, // the nickname of the user that sent the message
    message: string // the text of the message
}

outgoingMessage - Event notifications about outgoing messages. The listener will receive an object with the following structure:

{
    message: string // the text of the message
}

displayNameChange - event notifications about display name changes. The listener will receive an object with the following structure:

{
    id: string, // the id of the participant that changed his display name
    displayname: string // the new display name
}

deviceListChanged - event notifications about device list changes. The listener will receive an object with the following structure:

{
    devices: Object // the new list of available devices.
}

NOTE: The devices object has the same format as the getAvailableDevices result format.

emailChange - event notifications about email changes. The listener will receive an object with the following structure:

{
    id: string, // the id of the participant that changed his email
    email: string // the new email
}

feedbackSubmitted - event notifications about conference feedback submission

{
    error: string // The error which occurred during submission, if any.
}

filmstripDisplayChanged - event notifications about the visibility of the filmstrip being updated.

{
    visible: boolean // Whether or not the filmstrip is displayed or hidden.
}

participantJoined - event notifications about new participants who join the room. The listener will receive an object with the following structure:

{
    id: string, // the id of the participant
    displayName: string // the display name of the participant
}

participantKickedOut - event notifications about a participants being removed from the room. The listener will receive an object with the following structure:

{
    kicked: {
        id: string, // the id of the participant removed from the room
        local: boolean // whether or not the participant is the local particiapnt
    },
    kicker: {
        id: string // the id of the participant who kicked out the other participant
    }
}

participantLeft - event notifications about participants that leave the room. The listener will receive an object with the following structure:

{
    id: string // the id of the participant
}

participantRoleChanged - event notification fired when the role of the local user has changed (none, moderator, participant). The listener will receive an object with the following structure:

{
    id: string // the id of the participant
    role: string // the new role of the participant
}

passwordRequired - event notifications fired when failing to join a room because it has a password.
videoConferenceJoined - event notifications fired when the local user has joined the video conference. The listener will receive an object with the following structure:

{
    roomName: string, // the room name of the conference
    id: string, // the id of the local participant
    displayName: string, // the display name of the local participant
    avatarURL: string // the avatar URL of the local participant
}

videoConferenceLeft - event notifications fired when the local user has left the video conference. The listener will receive an object with the following structure:

{
    roomName: string // the room name of the conference
}

videoAvailabilityChanged - event notifications about video availability status changes. The listener will receive an object with the following structure:

{
    available: boolean // new available status - boolean
}

videoMuteStatusChanged - event notifications about video mute status changes. The listener will receive an object with the following structure:

{
    muted: boolean // new muted status - boolean
}

readyToClose - event notification fired when Meet Hour is ready to be closed (hangup operations are completed).
subjectChange - event notifications about subject of conference changes.
The listener will receive an object with the following structure:

{
    subject: string // the new subject
}

suspendDetected - event notifications about detecting suspend event in host computer.

You can also add multiple event listeners by using addEventListeners.
This method requires one argument of type Object. The object argument must
have the names of the events as keys and the listeners of the events as values.
NOTE: This method still exists but it is deprecated. MeetHourExternalAPI class extends [EventEmitter]. Use [EventEmitter] methods.

function incomingMessageListener(object)
{
// ...
}

function outgoingMessageListener(object)
{
// ...
}

api.addEventListeners({
    incomingMessage: incomingMessageListener,
    outgoingMessage: outgoingMessageListener
});

If you want to remove a listener you can use removeEventListener method with argument the name of the event.
NOTE: This method still exists but it is deprecated. MeetHourExternalAPI class extends [EventEmitter]. Use [EventEmitter] methods( removeListener).

api.removeEventListener('incomingMessage');

If you want to remove more than one event you can use removeEventListeners method with an Array with the names of the events as an argument.
NOTE: This method still exists but it is deprecated. MeetHourExternalAPI class extends [EventEmitter]. Use [EventEmitter] methods.

api.removeEventListeners([ 'incomingMessage', 'outgoingMessageListener' ]);

You can get the number of participants in the conference with the following API function:

const numberOfParticipants = api.getNumberOfParticipants();

You can get the avatar URL of a participant in the conference with the following API function:

const avatarURL = api.getAvatarURL(participantId);

You can get the display name of a participant in the conference with the following API function:

const displayName = api.getDisplayName(participantId);

You can get the email of a participant in the conference with the following API function:

const email = api.getEmail(participantId);

You can get the iframe HTML element where Meet Hour is loaded with the following API function:

const iframe = api.getIFrame();

You can check whether the audio is muted with the following API function:

api.isAudioMuted().then(muted => {
    ...
});

You can check whether the video is muted with the following API function:

api.isVideoMuted().then(muted => {
    ...
});

You can check whether the audio is available with the following API function:

api.isAudioAvailable().then(available => {
    ...
});

You can check whether the video is available with the following API function:

api.isVideoAvailable().then(available => {
    ...
});

You can invite new participants to the call with the following API function:

api.invite([ {...}, {...}, {...} ]).then(() => {
    // success
}).catch(() => {
    // failure
});

NOTE: The format of the invitees in the array depends on the invite service used for the deployment.

You can remove the embedded Meet Hour Conference with the following API function:

api.dispose();

Video SDK for Web Laravel - Meet Hour

Abdul Muqeet — Thu, 08 Jun 2023 15:09:44 +0000

MeetHour-Laravel-PHP-Example

Meet Hour - 100% free video conference solution
Meet Hour is 100% free video conference solution with End to End Encrypted and many other features such as lobby mode, Donor box & Click&Pledge Connect for fundraising, Video call recording, Youtube Live Stream etc.

Features:

✅  Free Unlimited Time Group Video Conference
✅  Upto 100 Participants Group Meeting
✅  Free Video Conference Recording
✅  YouTube Live Stream
✅  Raise funds via Click&Pledge Connect & DonorBox
✅  Virtual Background
✅  Live Pad
✅  Screensharing on Desktop & Mobile and many other features.

Try out one free session -

1. Website - https://meethour.io
2. Android - https://bit.ly/2U239ll
3. iOS - https://apple.co/3k8Rpbn

Composer package (Packagist) (Latest version - 1.0.1)

https://packagist.org/packages/meethour/php-sdk

MeetHour SDK Implementation - Steps

SDK Example Link - https://github.com/v-empower/MeetHour-Web-MobileSDKs/tree/master/Web/PHP/CorePHP
API Documentation Link - https://docs.v-empower.com/docs/MeetHour-API/

Install

composer require meethour/php-sdk  or composer install

                OR

"require": {
        "meethour/php-sdk": "1.0.1"  // Composer Require
    }

Steps to run the Example

First create a database using phpmyadmin based on .env file.
Go to meethour.io and signup for Developer or Higher plan. Currently we offer 28 days free trial.
Go to the dashboard and then click on developers menu.
Later go to .env and enter all the credentials of database and Meet Hour credentials as well.
Now run two commands php artisan migrate && php artisan serve
On Home page Click on Get Access Token
Then Try Schedule a Meeting & Join Meeting.

Usage

 Provide your credentials in the constructor of Login object and hit the login api to get your access token. Which will further be used for making rest of the api calls.

 <?php

 use MeetHourApp\Services\MHApiService;
 use MeetHourApp\Types\Login;
 use MeetHourApp\Types\ScheduleMeeting;

 $meetHourApiService = new MHApiService();
 $login = new Login($client_id, $client_secret, $grant_type, $username, $password);
 $loginResponse = $meetHourApiService->login($login);
 $scheduleBody = new ScheduleMeeting("Quick Meeting", "123456", date('h:i'), 'PM', date('d-m-Y'), 'Asia/Kolkata');  // You can give
 $response = $meetHourApiService->scheduleMeeting($loginResponse->access_token, $scheduleBody);
 var_dump($response);
 $test = new ViewMeeting($meeting_id);
 $response = $meetHourApiService->timezone($loginResponse->access_token);
 var_dump($response);

 ?>

Meet Hour - Join Meeting

We need to follow the Javascript SDK for Join Meetin Module - https://github.com/v-empower/MeetHour-Web-MobileSDKs/tree/master/Web/Javascript/Generic-Javascript

API End Points Supported

Important points:
=> Instead of '{version}', you to pass our latest version whenever you call the given functions. Currently we are using v1.2 Same version applies to the below calls.
=> In the token section, you need to pass the received access token which is received when login api is hit, for making further api calls.
=> You can make API calls by passing required properties in the constructor. But, to meet special requirements you can set rest of the properties directly, according to your need. For more details go to https://docs.v-empower.com/docs/MeetHour-API then click on APIS section to get all the information related to each api call.

To Get Access Token Endpoint : => https://docs.v-empower.com/docs/MeetHour-API/a44a7d7669f91-user-login-get-access-token

    class Login {
        public ?string $client_id;
        public ?string $client_secret;
        public ?string $grant_type;
        public ?string $password;
        public ?string $username;
    }
    $body = new Login($client_id, $client_secret, $grant_type, $username, $password);
    MHApiServices.login($body);

=> You have to pass respective values in the argument section. Hence, to get desired response.

To schedule a meeting: => https://docs.v-empower.com/docs/MeetHour-API/2de4b757a6312-meeting-schedule-meeting

    class ScheduleMeeting {
        public ?string $agenda;
        public ?array $attend;
        public string $default_recording_storage;
        public ?int $duration_hr;
        public ?int $duration_min;
        public ?int $enable_pre_registration;
        public ?string $endBy;
        public ?string $end_date_time;
        public ?int $end_times;
        public ?array $groups;
        public ?array $hostusers;
        public ?string $instructions;
        public ?int $is_recurring;
        public ?int $is_show_portal;
        public ?string $meeting_agenda;
        public string $meeting_date;
        public string $meeting_meridiem;
        public string $meeting_name;
        public string $meeting_time;
        public ?string $meeting_topic;
        public ?string $monthlyBy;
        public ?string $monthlyByDay;
        public ?string $monthlyByWeekday;
        public ?string $monthlyByWeekdayIndex;
        public ?array $options;
        public string $passcode;
        public ?string $recurring_type;
        public ?int $repeat_interval;
        public int $send_calendar_invite;
        public string $timezone;
        public ?int $weeklyWeekDays;
    }

    $body = new ScheduleMeeting($meeting_name, $passcode, $meeting_time, $meeting_meridiem, $meeting_date, $timezone);
    MHApiServices.scheduleMeeting($token, $body);

To Generate JWT Token Endpoint => https://docs.v-empower.com/docs/MeetHour-API/b7e3d0ab3906f-generate-jwt

    class GenerateJwt {
        public string $meeting_id;
        public ?int $contact_id;
        public ?object $ui_config;
        public ?array $config;
    }

    $body = new GenerateJwt($meeting_id);
    MHApiServices.generateJwt($token, $body);

To fetch User Details: => https://docs.v-empower.com/docs/MeetHour-API/ff9d0e37d9191-user-details
```
    MHApiServices.userDetails($token);
```

To fetch access Token using Refresh Token: => https://docs.v-empower.com/docs/MeetHour-API/d851be1af9804-get-access-token-using-refresh-token

    class RefreshToken {
        private string $client_id;
        private string $client_secret;
        private ?string $grant_type;
        private string $refresh_token;
    }

    $body = new RefreshToken($client_id, $client_secret, $refresh_token);
    MHApiServices.getRefreshToken($token, $body);

To add a contact in Meet Hour database: => https://docs.v-empower.com/docs/MeetHour-API/bd1e416413e8c-add-contact

    class ContactsList {
        public ?int $limit;
        public ?int $page;
        public ?int $exclude_hosts;
    }

    $body = new ContactsList();
    MHApiServices.contactList($token, $body);

To get Timezones of various countries: => https://docs.v-empower.com/docs/MeetHour-API/c688c29bce9b9-timezone-list
```
    MHApiServices.timezone($token);
```

To get list of all the contacts in your Meet Hour account: => https://api.meethour.io/api/{version}/customer/contacts

    class ContactsList {
        public string $email;
        public string $firstname;
        public ?string $country_code;
        public ?string $image;
        public ?bool $is_show_portal;
        public ?string $lastname;
        public ?string $phone;
    }

    $body = new ContactsList($email, $first_name);
    MHApiServices.ContactsList($token, $body);

To make changes in the existing contact details: => https://docs.v-empower.com/docs/MeetHour-API/28cae9187d215-edit-contact

 class EditContact {
     public string $email;
     public string $firstname;
     public ?string $country_code;
     public ?string $image;
     public ?bool $is_show_portal;
     public ?string $lastname;
     public ?string $phone;
 }

 $body = new EditContact($contact_id, $firstname, $email);
 MHApiServices.editContact($token, $body);

 ```

````

To get Upcoming Meetings: => https://docs.v-empower.com/docs/MeetHour-API/31df88388416d-upcoming-meetings



    class UpcomingMeetings {
        public ?int $limit;
        public ?int $page;
        public ?int $show_all;
    }

    $body = new UpcomingMeetings();
    MHApiServices.upcomingMeetings($token, $body);

To archive a meeting: => https://docs.v-empower.com/docs/MeetHour-API/1dd64523cc6bf-archive-meeting



    class ArchiveMeeting {
        public string $id;
    }

    $body = new ArchiveMeeting($id);
    MHApiServices.archiveMeeting($token, $body);

To get the details of a missed meeting: => https://docs.v-empower.com/docs/MeetHour-API/92998e2dda102-missed-meetings



    class MissedMeetings {
        public ?int $limit;
        public ?int $page;
        public ?int $show_all;
    }

    $body = new MissedMeetings();
    MHApiServices.missedMeetings($token, $body);

To get completed meetings: => https://docs.v-empower.com/docs/MeetHour-API/aa9ef6a678250-completed-meetings



    class CompletedMeetings {
        public ?int $limit;
        public ?int $page;
        public ?int $show_all;
    }

    $body = new CompletedMeetings();
    MHApiServices.completedMeetings($token, $body);

To edit an existing meeting: => https://docs.v-empower.com/docs/MeetHour-API/5dedde36380b4-meeting-edit-meeting



    class EditMeeting {
        public string $meeting_id;
        public ?string $meeting_name;
        public ?string $agenda;
        public ?string $passcode;
        public ?string $meeting_date;
        public ?string $meeting_time;
        public ?string $meeting_meridiem;
        public ?int $duration_hr;
        public ?int $duration_min;
        public ?string $timezone;
        public ?int $is_recurring;
        public ?string $recurring_type;
        public ?int $repeat_interval;
        public ?int $weeklyWeekDays;
        public ?string $monthlyBy;
        public ?string $monthlyByDay;
        public ?string $monthlyByWeekdayIndex;
        public ?string $monthlyByWeekday;
        public ?string $endBy;
        public ?string $end_date_time;
        public ?string $instructions;
        public ?int $is_show_portal;
        public ?int $enable_pre_registration;
        public ?string $meeting_topic;
        public ?string $meeting_agenda;
        public ?array $options;
        public ?array $old_attend;
        public ?array $attend;
        public ?array $groups;
        public ?array $hostusers;
        public ?string $default_recording_storage;
        public ?array $live_stream_settings;
    }

    $body = new EditMeeting($meeting_id);
    MHApiServices.editMeeting($token, $body);

To view a meeting: => https://docs.v-empower.com/docs/MeetHour-API/7e9a0a1e0da7f-meeting-view-meeting



    class ViewMeeting {
        public string $meeting_id;
    }

    $body = new ViewMeeting($meeting_id);
    MHApiServices.viewMeeting($token, $body);

To get all the recordings list: => https://docs.v-empower.com/docs/MeetHour-API/ce7c4fd8cae7e-recording-list



    class RecordingsList {
        public ?string $filter_by;
        public ?int $limit;
        public ?int $page;
    }

    $body = new RecordingsList();
    MHApiServices.recordingsList($token, $body);

Video SDK for CorePHP - Meet Hour

Abdul Muqeet — Thu, 08 Jun 2023 15:08:14 +0000

MeetHour-CorePHP-Example

Features:

✅  Free Unlimited Time Group Video Conference
✅  Upto 100 Participants Group Meeting
✅  Free Video Conference Recording
✅  YouTube Live Stream
✅  Raise funds via Click&Pledge Connect & DonorBox
✅  Virtual Background
✅  Live Pad
✅  Screensharing on Desktop & Mobile and many other features.

Try out one free session -

1. Website - https://meethour.io
2. Android - https://bit.ly/2U239ll
3. iOS - https://apple.co/3k8Rpbn

Composer package (Packagist) (Latest version - 1.0.1)

https://packagist.org/packages/meethour/php-sdk

MeetHour SDK Implementation - Steps

SDK Example Link - https://github.com/v-empower/MeetHour-Web-MobileSDKs/tree/master/Web/PHP/CorePHP
API Documentation Link - https://docs.v-empower.com/docs/MeetHour-API/

Install

composer require meethour/php-sdk

                OR

"require": {
        "meethour/php-sdk": "1.0.1"  // Composer Require
    }

require('./vendor/autoload.php');

require('./vendor/meethour/php-sdk/src/autoload.php');

Steps to run the Example

First create a database in mysql -> meethour-php-example.sql
Go to meethour.io and signup for Developer or Higher plan. Currently we offer 28 days free trial.
Go to the dashboard and then click on developers menu.
Later go to constants.php and enter all the credentials of database and Meet Hour credentials as well.
On Home page Click on Get Access Token
Then Try Schedule a Meeting & Join Meeting.

Usage

 Provide your credentials in the constructor of Login object and hit the login api to get your access token. Which will further be used for making rest of the api calls.

 <?php

 require('./vendor/autoload.php');
 require('./vendor/meethour/php-sdk/src/autoload.php');

 use MeetHourApp\Services\MHApiService;
 use MeetHourApp\Types\Login;
 use MeetHourApp\Types\ScheduleMeeting;

 $meetHourApiService = new MHApiService();
 $login = new Login($client_id, $client_secret, $grant_type, $username, $password);
 $loginResponse = $meetHourApiService->login($login);
 $scheduleBody = new ScheduleMeeting("Quick Meeting", "123456", date('h:i'), 'PM', date('d-m-Y'), 'Asia/Kolkata');  // You can give
 $response = $meetHourApiService->scheduleMeeting($loginResponse->access_token, $scheduleBody);
 var_dump($response);
 $test = new ViewMeeting($meeting_id);
 $response = $meetHourApiService->timezone($loginResponse->access_token);
 var_dump($response);

 ?>

Meet Hour - Join Meeting

We need to follow the Javascript SDK for Join Meetin Module - https://github.com/v-empower/MeetHour-Web-MobileSDKs/tree/master/Web/Javascript/Generic-Javascript

API End Points Supported

To Get Access Token Endpoint : => https://docs.v-empower.com/docs/MeetHour-API/a44a7d7669f91-user-login-get-access-token

       class Login {
           public ?string $client_id;
           public ?string $client_secret;
           public ?string $grant_type;
           public ?string $password;
           public ?string $username;
       }
       $body = new Login($client_id, $client_secret, $grant_type, $username, $password);
       MHApiServices.login($body);

=> You have to pass respective values in the argument section. Hence, to get desired response.

To schedule a meeting: => https://docs.v-empower.com/docs/MeetHour-API/2de4b757a6312-meeting-schedule-meeting

       class ScheduleMeeting {
           public ?string $agenda;
           public ?array $attend;
           public string $default_recording_storage;
           public ?int $duration_hr;
           public ?int $duration_min;
           public ?int $enable_pre_registration;
           public ?string $endBy;
           public ?string $end_date_time;
           public ?int $end_times;
           public ?array $groups;
           public ?array $hostusers;
           public ?string $instructions;
           public ?int $is_recurring;
           public ?int $is_show_portal;
           public ?string $meeting_agenda;
           public string $meeting_date;
           public string $meeting_meridiem;
           public string $meeting_name;
           public string $meeting_time;
           public ?string $meeting_topic;
           public ?string $monthlyBy;
           public ?string $monthlyByDay;
           public ?string $monthlyByWeekday;
           public ?string $monthlyByWeekdayIndex;
           public ?array $options;
           public string $passcode;
           public ?string $recurring_type;
           public ?int $repeat_interval;
           public int $send_calendar_invite;
           public string $timezone;
           public ?int $weeklyWeekDays;
       }

       $body = new ScheduleMeeting($meeting_name, $passcode, $meeting_time, $meeting_meridiem, $meeting_date, $timezone);
       MHApiServices.scheduleMeeting($token, $body);

To Generate JWT Token Endpoint => https://docs.v-empower.com/docs/MeetHour-API/b7e3d0ab3906f-generate-jwt

       class GenerateJwt {
           public string $meeting_id;
           public ?int $contact_id;
           public ?object $ui_config;
           public ?array $config;
       }

       $body = new GenerateJwt($meeting_id);
       MHApiServices.generateJwt($token, $body);

To fetch User Details: => https://docs.v-empower.com/docs/MeetHour-API/ff9d0e37d9191-user-details

       MHApiServices.userDetails($token);

To fetch access Token using Refresh Token: => https://docs.v-empower.com/docs/MeetHour-API/d851be1af9804-get-access-token-using-refresh-token

       class RefreshToken {
           private string $client_id;
           private string $client_secret;
           private ?string $grant_type;
           private string $refresh_token;
       }

       $body = new RefreshToken($client_id, $client_secret, $refresh_token);
       MHApiServices.getRefreshToken($token, $body);

To add a contact in Meet Hour database: => https://docs.v-empower.com/docs/MeetHour-API/bd1e416413e8c-add-contact

       class ContactsList {
           public ?int $limit;
           public ?int $page;
           public ?int $exclude_hosts;
       }

       $body = new ContactsList();
       MHApiServices.contactList($token, $body);

To get Timezones of various countries: => https://docs.v-empower.com/docs/MeetHour-API/c688c29bce9b9-timezone-list

       MHApiServices.timezone($token);

To get list of all the contacts in your Meet Hour account: => https://api.meethour.io/api/{version}/customer/contacts

       class ContactsList {
           public string $email;
           public string $firstname;
           public ?string $country_code;
           public ?string $image;
           public ?bool $is_show_portal;
           public ?string $lastname;
           public ?string $phone;
       }

       $body = new ContactsList($email, $first_name);
       MHApiServices.ContactsList($token, $body);

To make changes in the existing contact details: => https://docs.v-empower.com/docs/MeetHour-API/28cae9187d215-edit-contact

    class EditContact {
        public string $email;
        public string $firstname;
        public ?string $country_code;
        public ?string $image;
        public ?bool $is_show_portal;
        public ?string $lastname;
        public ?string $phone;
    }

    $body = new EditContact($contact_id, $firstname, $email);
    MHApiServices.editContact($token, $body);

    ```

To get Upcoming Meetings: => https://docs.v-empower.com/docs/MeetHour-API/31df88388416d-upcoming-meetings



    class UpcomingMeetings {
        public ?int $limit;
        public ?int $page;
        public ?int $show_all;
    }

    $body = new UpcomingMeetings();
    MHApiServices.upcomingMeetings($token, $body);

To archive a meeting: => https://docs.v-empower.com/docs/MeetHour-API/1dd64523cc6bf-archive-meeting



    class ArchiveMeeting {
        public string $id;
    }

    $body = new ArchiveMeeting($id);
    MHApiServices.archiveMeeting($token, $body);

To get the details of a missed meeting: => https://docs.v-empower.com/docs/MeetHour-API/92998e2dda102-missed-meetings



    class MissedMeetings {
        public ?int $limit;
        public ?int $page;
        public ?int $show_all;
    }

    $body = new MissedMeetings();
    MHApiServices.missedMeetings($token, $body);

To get completed meetings: => https://docs.v-empower.com/docs/MeetHour-API/aa9ef6a678250-completed-meetings



    class CompletedMeetings {
        public ?int $limit;
        public ?int $page;
        public ?int $show_all;
    }

    $body = new CompletedMeetings();
    MHApiServices.completedMeetings($token, $body);

To edit an existing meeting: => https://docs.v-empower.com/docs/MeetHour-API/5dedde36380b4-meeting-edit-meeting



    class EditMeeting {
        public string $meeting_id;
        public ?string $meeting_name;
        public ?string $agenda;
        public ?string $passcode;
        public ?string $meeting_date;
        public ?string $meeting_time;
        public ?string $meeting_meridiem;
        public ?int $duration_hr;
        public ?int $duration_min;
        public ?string $timezone;
        public ?int $is_recurring;
        public ?string $recurring_type;
        public ?int $repeat_interval;
        public ?int $weeklyWeekDays;
        public ?string $monthlyBy;
        public ?string $monthlyByDay;
        public ?string $monthlyByWeekdayIndex;
        public ?string $monthlyByWeekday;
        public ?string $endBy;
        public ?string $end_date_time;
        public ?string $instructions;
        public ?int $is_show_portal;
        public ?int $enable_pre_registration;
        public ?string $meeting_topic;
        public ?string $meeting_agenda;
        public ?array $options;
        public ?array $old_attend;
        public ?array $attend;
        public ?array $groups;
        public ?array $hostusers;
        public ?string $default_recording_storage;
        public ?array $live_stream_settings;
    }

    $body = new EditMeeting($meeting_id);
    MHApiServices.editMeeting($token, $body);

To view a meeting: => https://docs.v-empower.com/docs/MeetHour-API/7e9a0a1e0da7f-meeting-view-meeting



    class ViewMeeting {
        public string $meeting_id;
    }

    $body = new ViewMeeting($meeting_id);
    MHApiServices.viewMeeting($token, $body);

To get all the recordings list: => https://docs.v-empower.com/docs/MeetHour-API/ce7c4fd8cae7e-recording-list



    class RecordingsList {
        public ?string $filter_by;
        public ?int $limit;
        public ?int $page;
    }

    $body = new RecordingsList();
    MHApiServices.recordingsList($token, $body);

Video SDK for IOS - Swift & Objc - Meet Hour

Abdul Muqeet — Thu, 08 Jun 2023 14:59:16 +0000

Reference & for Files you can check this: https://github.com/v-empower/MeetHour-Web-MobileSDKs/tree/master/Mobile/Native/ios

Meet Hour iOS SDK releases

MeetHour SDK Implementation - Steps

SDK Example Link - https://github.com/v-empower/MeetHour-Web-MobileSDKs
API Documentation Link - https://docs.v-empower.com/docs/MeetHour-API/

Steps to Integrate:

Signup for Meet Hour (https://meethour.io) and signup for Developer or Higher plan. Currently we offer 28 days free trial.
Once you signup for developer plan, and go to our Dashboard - (https://portal.meethour.io) and tap on "Developers" menu.
Now copy and Client ID & Client Secret and keep it handy with you.
Go to our API documentation and hit Login API to get oAuth Access Token - (https://bit.ly/3E2hKU7)
Once you get an access token, you can access any our API. Now you first thing you have to do is create a contact in our system as soon as user signup in your platform using this API (https://bit.ly/3LRehug). This will give you unique contact_id of that user. You require this id when you schedule a meeting below.
Later go to Schedule Meeting API -> Pass all the parameters needed to generate a new meetings - (https://bit.ly/3riFLkx)
Once the meeting is genereate, in order to join a meeting you require to Generate JWT Token using this API (https://bit.ly/3ur5pFR) and pass it to the conference URL via MT Parameter - https://meethour.io?mt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiIsImFjY2Vzc190b2tlbiI6ImV5SjBlWEFpT2lKS1YxUWlMQ0poYkdjaU9pSlNVekkxTmlKOS5leUpoZFdRaU9pSTVNemxrWmpVeE5pMDJNekEzTFRRNVkyUXRPVGMxTXkwek1XRTNNemRrT1RGaE1HWWlMQ0pxZEdraU9pSmtNMlUyT

id: dev-guide-ios-sdk

title: "Meet Hour iOS SDK"

For iOS - Pod Update

Always run below command if you want to get latest MeetHourSDK Pod file.

pod update MeetHourSDK
pod update MeetHourSDK or pod install --repo-update

For Apple M1 Silicon Chip
arch -x86_64 pod update MeetHourSDK or arch -x86_64 pod install --repo-update

Latest Verion - 4.1.4

This repository contains the binaries for the Meet Hour iOS SDK. Each
release is tagged in this repository and is composed of 2 frameworks:

MeetHourSDK.xcframework
WebRTC.xcframework

It is strongly advised to use the provided WebRTC framework and not
replace it with any other build, since the provided one is known to work
with the SDK.

Screenshot

Using the SDK

The recommended way for using the SDK is by using CocoaPods. In order to
do so, add the MeetHourSDK dependency to your existing Podfile or create
a new one following this example:

platform :ios, '12.1'

target 'MeetHourSDKTest' do
    pod 'MeetHourSDK', '~> 4.2.4'

    post_install do |installer|
        installer.pods_project.targets.each do |target|
            target.build_configurations.each do |config|
                config.build_settings['ENABLE_BITCODE'] = 'NO'
            end
        end
    end
end

Replace MeetHourSDKTest with your project and target names.

Bitcode is not supported, so turn it off for your project.

The SDK uses Swift code, so make sure you select Always Embed Swift Standard Libraries
in your project.

Since the SDK requests camera and microphone access, make sure to include the
required entries for NSCameraUsageDescription and NSMicrophoneUsageDescription
in your Info.plist file.

In order for app to properly work in the background, select the "audio" and "voip"
background modes.

Last, since the SDK shows and hides the status bar based on the conference state,
you may want to set UIViewControllerBasedStatusBarAppearance to NO in your
Info.plist file.

POD INSTALL

pod install

API

The API is documented here.

Issues

Please report all issues related to this SDK to the Meet Hour repository.

Video SDK for Android Native - Java & Kotlin

Abdul Muqeet — Thu, 08 Jun 2023 14:57:57 +0000

Reference you can check here: https://github.com/v-empower/MeetHour-Web-MobileSDKs/tree/master/Mobile/Native/android

MeetHour SDK Implementation - Steps

SDK Example Link - https://github.com/v-empower/MeetHour-Web-MobileSDKs
API Documentation Link - https://docs.v-empower.com/docs/MeetHour-API/

Steps to Integrate:

Signup for Meet Hour (https://meethour.io) and signup for Developer or Higher plan. Currently we offer 28 days free trial.
Once you signup for developer plan, and go to our Dashboard - (https://portal.meethour.io) and tap on "Developers" menu.
Now copy and Client ID & Client Secret and keep it handy with you.
Go to our API documentation and hit Login API to get oAuth Access Token - (https://bit.ly/3E2hKU7)
Once you get an access token, you can access any our API. Now you first thing you have to do is create a contact in our system as soon as user signup in your platform using this API (https://bit.ly/3LRehug). This will give you unique contact_id of that user. You require this id when you schedule a meeting below.
Later go to Schedule Meeting API -> Pass all the parameters needed to generate a new meetings - (https://bit.ly/3riFLkx)
Once the meeting is genereate, in order to join a meeting you require to Generate JWT Token using this API (https://bit.ly/3ur5pFR) and pass it to the conference URL via MT Parameter - https://meethour.io?mt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiIsImFjY2Vzc190b2tlbiI6ImV5SjBlWEFpT2lKS1YxUWlMQ0poYkdjaU9pSlNVekkxTmlKOS5leUpoZFdRaU9pSTVNemxrWmpVeE5pMDJNekEzTFRRNVkyUXRPVGMxTXkwek1XRTNNemRrT1RGaE1HWWlMQ0pxZEdraU9pSmtNMlUyT

id: dev-guide-android-sdk

title: "Meet Hour Android SDK"

Latest Verion - 4.2.4

The Meet Hour Android SDK provides the same user experience as the Meet Hour app,
in a customizable way which you can embed in your apps.

Build your own, or use a pre-build SDK artifacts/binaries

MeetHour conveniently provides a pre-build SDK artifacts/binaries in its Maven repository. When you do not require any
modification to the SDK itself or any of its dependencies, it's suggested to use the pre-build SDK. This avoids the
complexity of building and installing your own SDK artifacts/binaries.

Use pre-build SDK artifacts/binaries

In your project, add the Maven repository
https://repo.meethour.io/maven/releases and the
dependency go.meethour.io.react:meet-hour-sdk:4.0.1 into your build.gradle files.

The repository typically goes into the build.gradle file in the root of your project:

allprojects {
    repositories {
        google()
        jcenter()
        maven {
            url "https://repo.meethour.io/maven/releases"
        }
    }
}

Dependency definitions belong in the individual module build.gradle files:

dependencies {
    // (other dependencies)
    implementation ('go.meethour.io.react:meet-hour-sdk:4.2.4') { transitive = true }
}

React Native Video SDK - Meet Hour

Abdul Muqeet — Thu, 08 Jun 2023 14:41:47 +0000

Reference: https://github.com/v-empower/MeetHour-Web-MobileSDKs/tree/master/Mobile/ReactNative

Meet Hour Example project for React Native with APIs

NPM package (Latest version - 3.0.20)

https://www.npmjs.com/package/react-native-meet-hour-sdk

Example Project is here - https://github.com/v-empower/MeetHour-Web-MobileSDKs/tree/master/Mobile/ReactNative

Steps to Use Meet Hour React Native SDK Example

Go to meethour.io and signup for Developer or Higher plan. Currently we offer 28 days free trial.
Go to the dashboard and then click on developers menu.
Copy your Client ID, Client Secret and Api Key. After copying, paste each copied text to the respective constant in the source code src/constants/index.js
On Home page Click on Get Access Token
Then Try Schedule a Meeting & Join Meeting.

Run Program

cd Mobile/ReactNative/MeetHourSDKTest

npm install

npm start

npm run android

npm run ios

API End Points Supported

To Get Access Token Endpoint : => https://docs.v-empower.com/docs/MeetHour-API/a44a7d7669f91-user-login-get-access-token

       ApiServices.login({
               grant_type, client_id, client_secret, username, password
           });

=> You have to pass respective values in the argument section. Hence, to get desired response.

To schedule a meeting: => https://docs.v-empower.com/docs/MeetHour-API/2de4b757a6312-meeting-schedule-meeting

       ApiServices. scheduleMeeting(token: string, body: ScheduleMeetingType)

           type ScheduleMeetingType {
                   agenda?: string;
                   attend?:
                       | Array<number>
                       | Array<UserObjectType>
                       | Array<UserObjectType | number>;
                   default_recording_storage?: string;
                   duration_hr?: number;
                   duration_min?: number;
                   enable_pre_registration?: number;
                   endBy?: string;
                   end_date_time?: string;
                   end_times?: number;
                   groups?: Array<number | string>;
                   hostusers?:
                       | Array<number>
                       | Array<UserObjectType>
                       | Array<UserObjectType | number>;
                   instructions?: string;
                   is_recurring?: number;
                   is_show_portal?: number;
                   meeting_agenda?: string;
                   meeting_date: string;
                   meeting_meridiem: string;
                   meeting_name: string;
                   meeting_time: string;
                   meeting_topic?: string;
                   monthlyBy?: string;
                   monthlyByDay?: string;
                   monthlyByWeekday?: string;
                   monthlyByWeekdayIndex?: string;
                   options?: Array<string>;
                   passcode: string;
                   recurring_type?: string;
                   repeat_interval?: number;
                   send_calendar_invite?: number;
                   timezone: string;
                   weeklyWeekDays?: number;
               };


       type UserObjectType {
               email?: string;
               first_name?: string;
               last_name?: string;
           }

To Generate JWT Token Endpoint => https://docs.v-empower.com/docs/MeetHour-API/b7e3d0ab3906f-generate-jwt

       ApiServices.generateJwt(token: string, body: GenerateJwtType)

      type GenerateJwtType {
               config?: {
               disableDeepLinking?: string;
               dropboxappKey?: string;
               dropboxredirectURI?: string;
               enableClosePage?: string;
               enableWelcomePage?: string;
               fileRecordingsEnabled?: boolean;
               liveStreamingEnabled?: boolean;
               p2penabled?: boolean;
               requireDisplayName?: string;
               resolution?: number;
               startAudioMuted?: number;
               videoheightideal?: number;
               videoheightmax?: number;
               videoheightmin?: number;
               videowidthideal?: number;
               videowidthmax?: number;
               videowidthmin?: number;
               };
               contact_id?: number;
               meeting_id: string;
               ui_config?: {
               ANDROID_APP_PACKAGE?: string;
               APP_NAME?: string;
               APP_SCHEME?: string;
               BRAND_WATERMARK_BACKGROUND?: string;
               DEFAULT_LOGO_URL?: string;
               ENABLE_MOBILE_BROWSER?: string;
               HIDE_DEEP_LINKING_LOGO?: string;
               MEET_HOUR_WATERMARK_LINK?: string;
               MOBILE_APP_PROMO?: string;
               MOBILE_DOWNLOAD_LINK_ANDROID?: string;
               MOBILE_DOWNLOAD_LINK_IOS?: string;
               NATIVE_APP_NAME?: string;
               PROVIDER_NAME?: string;
               SHOW_MEET_HOUR_WATERMARK?: string;
               disablePrejoinFooter?: string;
               disablePrejoinHeader?: string;
               toolbar_buttons?: Array<string>;
               };
           };

To fetch User Details: => https://docs.v-empower.com/docs/MeetHour-API/ff9d0e37d9191-user-details

       ApiServices.userDetails(token: string)

To fetch access Token using Refresh Token: => https://docs.v-empower.com/docs/MeetHour-API/d851be1af9804-get-access-token-using-refresh-token

       ApiServices.getRefreshToken(token: string, body: RefreshTokenType)

       type RefreshTokenType {
               client_id: string;
               client_secret: string;
               grant_type: string;
               refresh_token: string;
       }

To add a contact in Meet Hour database: => https://docs.v-empower.com/docs/MeetHour-API/bd1e416413e8c-add-contact

       ApiServices.addContact(token: string, body: AddContactType)

       type AddContactType {
               country_code?: string;
               email: string;
               firstname: string;
               image?: string;
               is_show_portal?: boolean;
               lastname?: string;
               phone?: string;
           }

To get Timezones of various countries: => https://docs.v-empower.com/docs/MeetHour-API/c688c29bce9b9-timezone-list

       ApiServices.timezone(token: string)

To get list of all the contacts in your Meet Hour account: => https://api.meethour.io/api/{version}/customer/contacts

       ApiServices.contactsList(token: string, body: ContactsType)

       type ContactsType {
               exclude_hosts: number;
               limit: number;
               page: number;
           }

To make changes in the existing contact details: => https://docs.v-empower.com/docs/MeetHour-API/28cae9187d215-edit-contact

    ApiServices.editContact(token: string, body: EditContactType)

    type EditContactType {
            contact_id: number;
            country_code: string;
            email: string;
            firstname: string;
            image: string;
            is_show_portal: boolean;
            lastname: string;
            phone: string;
        }

    ```

To get Upcoming Meetings: => https://docs.v-empower.com/docs/MeetHour-API/31df88388416d-upcoming-meetings



    ApiServices.upcomingMeetings(token: string, body: {
        limit: number;
        page: number;
    })

To archive a meeting: => https://docs.v-empower.com/docs/MeetHour-API/1dd64523cc6bf-archive-meeting



    ApiServices.archiveMeeting(
            token: string,
            body: {
                id?: number;
        })

To get the details of a missed meeting: => https://docs.v-empower.com/docs/MeetHour-API/92998e2dda102-missed-meetings



    ApiServices.missedMeetings(
        token: string,
        body: {
            limit: number;
            page: number;
        })

To get completed meetings: => https://docs.v-empower.com/docs/MeetHour-API/aa9ef6a678250-completed-meetings



    ApiServices.completedMeetings(
        token: string,
        body: {
        limit: number;
        page: number;
        })

To edit an existing meeting: => https://docs.v-empower.com/docs/MeetHour-API/5dedde36380b4-meeting-edit-meeting



    ApiServices.editMeeting(token: string, body: EditMeetingType)

    type EditMeeting {
        agenda?: string;
        attend?:
            | Array<number>
            | Array<UserObjectType>
            | Array<number & UserObjectType>;
        duration_hr?: number;
        duration_min?: number;
        enable_pre_registration?: number;
        endBy?: string;
        end_date_time?: string;
        groups?: Array<number>;
        hostusers?:
            | Array<number>
            | Array<UserObjectType>
            | Array<number & UserObjectType>;
        instructions?: string;
        is_recurring?: number;
        is_show_portal?: number;
        meeting_agenda?: string;
        meeting_date?: string;
        meeting_id: string;
        meeting_meridiem?: string;
        meeting_name?: string;
        meeting_time?: string;
        meeting_topic?: string;
        old_attend?:
            | Array<number>
            | Array<UserObjectType>
            | Array<number & UserObjectType>;
        options?: Array<string>;
        passcode?: string;
        recurring_type?: string;
        repeat_interval?: number;
        timezone?: string;
    }

    type UserObjectType {
        email?: string;
        first_name?: string;
        last_name?: string;
    }

To view a meeting: => https://docs.v-empower.com/docs/MeetHour-API/7e9a0a1e0da7f-meeting-view-meeting



    ApiServices.viewMeeting(
        token: string,
        body: { meeting_id: string }
        )

To get all the recordings list: => https://docs.v-empower.com/docs/MeetHour-API/ce7c4fd8cae7e-recording-list



    ApiServices.recordingsList(token: string, body: RecordingsList)

    type RecordingsList {
        filter_by: string;
        limit: number;
        page: number;
    }

Usage

In this SDK, you can make APIs calls and allow join the conference in Native View or React Native View.



import MeetHour, {MeetHourView, ApiServices} from 'react-native-meet-hour-sdk';
import React, {useState, useEffect} from 'react';
import {
  StyleSheet,
  View,
  Pressable,
  Text,
  Platform,
  Alert
} from 'react-native';

const loginBody = {
  client_id: '',
  client_secret: '',
  username: '',
  password: '',
};

const ScheduleBody = {
  meeting_name: 'Quick Meeting',
  agenda: '',
  passcode: '123456',
  meeting_date: '23-02-2025', // Make sure you give a future date for this parameter
  meeting_time: '11:30',
  meeting_meridiem: 'AM',
  timezone: 'Asia/Kolkata',
  instructions: 'Team call',
  is_show_portal: 0,
  options: ['ALLOW_GUEST', 'JOIN_ANYTIME'],
  // attend: [] // Pass the values as per documentation.
  // hostusers: []
};

let getJWTBody = {
  meeting_id: '',
};

const conferenceOptions = {
  room: '',
  token: '', // JWT Token
  pcode: '', //Dynamic Password of Conference. Will get from Schedule API & ViewMeeting APIs
  audioMuted: false,
  videoMuted: false,
  prejoinPageEnabled: true, // Make it false to Skip PrejoinPage
  disableInviteFunctions: true, // To disable invite functions in Mobile SDK.
};

function App() {
  const [showMeetHourView, setShowMeetHourView] = useState(false);

  useEffect(() => {
    if (conferenceOptions.room !== '') {
      if (Platform.OS === 'android') {
        startMeetHourAsNativeController(); // Recommeneded to use for Android if you require Screen Sharing functionality.
      } else {
        setShowMeetHourView(true);
      }
    }
  }, [conferenceOptions.token]);

  const Apicalls = async () => {
    try {
      let loginResponse = await ApiServices.login(loginBody);
      let scheduleResponse = await ApiServices.scheduleMeeting(
        loginResponse.access_token,
        ScheduleBody,
      );

      conferenceOptions.room = scheduleResponse.data?.meeting_id;

      getJWTBody.meeting_id = scheduleResponse.data?.meeting_id;

      conferenceOptions.pcode = scheduleResponse.data?.pcode;

      let generateJWTResponse = await ApiServices.generateJwt(
        loginResponse.access_token,
        getJWTBody,
      );

      conferenceOptions.token = generateJWTResponse.jwt;
    } catch (error) {
      console.log(error);
      Alert.alert("Credentials Error", "API calls failing. Please add Client ID and Client Secret"+error);
    }
  };

  Apicalls();

  const startMeetHourAsNativeController = async () => {
    /* 
      Mode 1 - Use this mode for Android when you require screen sharing functionality.
    */

    await MeetHour.launchMeetHourView(conferenceOptions);

    /*
      Note:
        MeetHour.launchMeetHourView will return a promise, which is resolved once the conference is terminated and the MeetHourView is dismissed.
    */
  };

  /*
    The localParticipant leaves the current conference.
  */
  const hangUp = () => {
    MeetHour.hangUp();
  };

  if (showMeetHourView) {
    /* Mode 2 - Starts MeetHour as a React Native View */

    return (
      <MeetHourView
        style={styles.mHView}
        options={conferenceOptions}
        onConferenceTerminated={(_) => setShowMeetHourView(false)}
        onConferenceJoined={(e) => console.log(e.nativeEvent)}
        onConferenceWillJoin={(e) => console.log(e.nativeEvent)}
      />
    );
  }

  return (
    <View style={styles.container}>
      <Pressable
        onPress={startMeetHourAsNativeController}
        style={({pressed}) => [styles.pressable, {opacity: pressed ? 0.5 : 1}]}>
        <Text style={styles.pressableText}>
          Start MeetHour on top of RN Application
        </Text>
      </Pressable>
      <Pressable
        onPress={() => setShowMeetHourView(true)}
        style={({pressed}) => [styles.pressable, {opacity: pressed ? 0.5 : 1}]}>
        <Text style={styles.pressableText}>Start MeetHour as a React Native View</Text>
      </Pressable>
    </View>
  );
}

const styles = StyleSheet.create({
  container: {
    flex: 1,
    alignItems: 'center',
    justifyContent: 'center',
  },
  pressable: {
    width: '80%',
    borderRadius: 15,
    height: 50,
    marginVertical: 10,
    justifyContent: 'center',
    alignItems: 'center',
    backgroundColor: '#4f6790',
  },
  pressableText: {
    fontSize: 17,
    fontWeight: 'bold',
    textAlign: 'center',
    color: '#fff',
  },
  mHView: {
    flex: 1,
  },
});

export default App;

See Options for further information.

iOS install

1.) This library uses Swift code, so make sure that you have created the Objective-C bridging header file.

If not, open your project in Xcode and create an empty Swift file.

Xcode will ask if you wish to create the bridging header file, please choose yes.

For more information check Create Objective-C bridging header file.

2.) Replace the following code in AppDelegate.m (ONLY required for mode 1. If you're using mode 2, skip this step):


objective-c
UIViewController *rootViewController = [UIViewController new];
rootViewController.view = rootView;
self.window.rootViewController = rootViewController;

with this one


objective-c
UIViewController *rootViewController = [UIViewController new];
UINavigationController *navigationController = [[UINavigationController alloc]initWithRootViewController:rootViewController];
navigationController.navigationBarHidden = YES;
rootViewController.view = rootView;
self.window.rootViewController = navigationController;

This will create a navigation controller to be able to navigate between the MeetHour component and your react native screens.

3.) Add the following lines to your Info.plist


xml
<key>NSCameraUsageDescription</key>
<string>Camera Permission</string>
<key>NSMicrophoneUsageDescription</key>
<string>Microphone Permission</string>
<key>NSCalendarUsageDescription</key>
<string>Calendar Permission</string>

4.) Modify your platform version in Podfile and Xcode to have platform version 12.0 or above.

5.) In Xcode, under Build settings set Enable Bitcode to No and Always Embed Swift Standard Libraries to Yes.

6.) In Xcode, under Signing & Capabilities add the capability Background Modes and check Voice over IP. Otherwise, it won't work well in background.

7.) Clean your project and run npx pod-install.

Android install

1.) In android/app/build.gradle, add/replace the following lines:


groovy
project.ext.react = [
    entryFile: "index.js",
    bundleAssetName: "app.bundle",
    ...
]

2.) In android/app/src/main/java/com/xxx/MainApplication.java add/replace the following methods:


java
  import androidx.annotation.Nullable; // <--- Add this line if not already existing
  ...
    @Override
    protected String getJSMainModuleName() {
      return "index";
    }

    @Override
    protected @Nullable String getBundleAssetName() {
      return "app.bundle";
    }

3.) In android/build.gradle, add the following code


groovy
allprojects {
    repositories {
        jcenter()
        maven {
            // All of React Native (JS, Obj-C sources, Android binaries) is installed from npm
            url "$rootDir/../node_modules/react-native/android"
        }
        maven {
            url "https://maven.google.com"
        }
        maven { // <---- Add this block
            url "https://repo.meethour.io/maven/releases/"
        }
    }
}

4.) In the <application> section of android/app/src/main/AndroidManifest.xml, add (ONLY required for mode 1. If you're using mode 2, skip this step)


xml
<activity
    android:configChanges="keyboard|keyboardHidden|orientation|screenLayout|screenSize|smallestScreenSize"
    android:launchMode="singleTask"
    android:resizeableActivity="true"
    android:supportsPictureInPicture="true"
    android:windowSoftInputMode="adjustResize"
    android:name="go.meethour.io.react.sdk.MeetHourActivityExtended">
</activity>

5.) And set your minSdkVersion to be at least 24.


groovy
buildscript {
    ext {
        buildToolsVersion = "33.0.1"
        minSdkVersion = 24 // <-- this line
        compileSdkVersion = 33
        targetSdkVersion = 33
        ndkVersion = "20.1.5948944"
    }
    ...
}

6.) Remove allow back up from Androidmanifest.xml


xml
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
  package="com.sdktest">

    <uses-permission android:name="android.permission.INTERNET" />

    <application
      android:name=".MainApplication"
      android:label="@string/app_name"
      android:icon="@mipmap/ic_launcher"
      android:roundIcon="@mipmap/ic_launcher_round"
      android:allowBackup="false" <-- this line
      android:theme="@style/AppTheme">
      <activity
        android:name=".MainActivity"
        android:label="@string/app_name"
        android:configChanges="keyboard|keyboardHidden|orientation|screenSize|uiMode"
        android:launchMode="singleTask"
        android:windowSoftInputMode="adjustResize">
        <intent-filter>
            <action android:name="android.intent.action.MAIN" />
            <category android:name="android.intent.category.LAUNCHER" />
        </intent-filter>
      </activity>
    </application>
</manifest>

Options

key	Data type	Default	Description
room	string	required	Room name for Meet Hour
serverUrl	string	https://meethour.io	Valid server URL
token	string	""	JWT token
pcode	string	""	Password of meeting to be passed dynamically
subject	string	""	Conference subject (will change the global subject for all participants)
audioOnly	boolean	false	Controls whether the participant will join the conference in audio-only mode (no video is sent or recieved)
audioMuted	boolean	false	Controls whether the participant will join the conference with the microphone muted
videoMuted	boolean	false	Controls whether the participant will join the conference with the camera muted
prejoinPageEnabled	boolean	true	Make it true to Skip PrejoinPage
disableInviteFunctions	boolean	true	To disable invite functions in Mobile SDK
userInfo	object	{}	Object that contains information about the participant starting the meeting. See UserInfo
featureFlags	object	{}	Object that contains information about which feature flags should be set. See below for more info.

Troubleshooting

If your having problems with duplicate_classes errors, try exclude them from the react-native-meet-hour-sdk project implementation with the following code:


groovy
implementation(project(':react-native-meet-hour-sdk')) {

      // Un-comment below if using hermes
//    exclude group: 'com.facebook',module:'hermes'

      // Un-comment any packages below that you have added to your project to prevent `duplicate_classes` errors
//     exclude group: 'com.facebook.react',module:'react-native-locale-detector'
//     exclude group: 'com.facebook.react',module:'react-native-vector-icons'
//     exclude group: 'com.facebook.react',module:'react-native-async-storage'
//     exclude group: 'com.facebook.react',module:'react-native-community_netinfo'
//     exclude group: 'com.facebook.react',module:'react-native-svg'
//     exclude group: 'com.facebook.react', module:'react-native-gesture-handler'
//     exclude group: 'com.facebook.react',module:'react-native-fetch-blob'
//     exclude group: 'com.facebook.react',module:'react-native-webview'
//     exclude group: 'com.facebook.react',module:'react-native-linear-gradient'
//     exclude group: 'com.facebook.react',module:'react-native-sound'
//     exclude group: 'com.facebook.react',module:'react-native-add-calendar-event'
}

If you are having problems -> Suggestion: add 'tools:replace="android:exported"' to element at AndroidManifest.xml to override.

Please add the below code in manifest.xml



    <provider
        android:name="com.reactnativecommunity.webview.RNCWebViewFileProvider"
        android:authorities="${applicationId}.fileprovider"
        android:enabled="false"
        android:exported="true"
        tools:replace="android:authorities,android:exported">
    </provider>

Video Flutter SDK - Meet Hour

Abdul Muqeet — Thu, 08 Jun 2023 13:47:57 +0000

Meet Hour Plugin for Flutter. Supports Android and iOS platforms.

"Meet Hour is 100% free video conference solution with End to End Encrypted and many other features such as lobby mode, Video call recording, Live Streaming, Whiteboard, Control Mute Audio & video of participants etc."

Example Project is here - https://github.com/v-empower/MeetHour-Web-MobileSDKs/tree/master/Mobile/Flutter/MeetHourSDKTest
Pub dev - https://pub.dev/packages/meet_hour
meet_hour: '>=5.0.17'

MeetHour SDK Implementation - Steps

SDK Examples Link - https://github.com/v-empower/MeetHour-Web-MobileSDKs
API Documentation Link - https://docs.v-empower.com/docs/MeetHour-API/

   LoginType LoginObject = LoginType(
     client_id: '',
     client_secret: '',
     grant_type: 'password',
     password: '',
     username: ''
     );

    Map<String, dynamic> response - await ApiServices.login(LoginObject);

Steps to Use Meet Hour React Flutter SDK Example

Go to meethour.io and signup for Developer or Higher plan. Currently we offer 28 days free trial.
Go to the dashboard and then click on developers menu.
Copy your Client ID, Client Secret and Api Key. After copying, paste each copied text to the respective constant in the source code lib/constants/index.dart
On Home page Click on Get Access Token
Then Try Schedule a Meeting & Join Meeting.

API End Points Supported

To Get Access Token Endpoint : => https://docs.v-empower.com/docs/MeetHour-API/a44a7d7669f91-user-login-get-access-token

   LoginType LoginObject = LoginType(
     client_id: '',
     client_secret: '',
     grant_type: 'password',
     password: '',
     username: ''
     );

    Map<String, dynamic> response - await ApiServices.login(LoginObject);

=> You have to pass respective values in the argument section. Hence, to get desired response.

To schedule a meeting: => https://docs.v-empower.com/docs/MeetHour-API/2de4b757a6312-meeting-schedule-meeting

 ScheduleMeetingType ScheduleObject = ScheduleMeetingType(
   meetingName : 'Test',
   agenda: '',
   passcode: '',
   meetingDate: '',
   meetingTime: '',
   meetingMeridiem: '',
   durationhr: '',
   durationmin: '',
   timezone: '',
   isrecurring: '',
   recurringtype: '',
   repeat_interval: '',
   endBy: '',
   enddatetime: '',
   instructions: '',
   is_show_portal: '',
   enablepreregistration: '',
   meetingtopic: '',
   meetingagenda: '',
   options: '',
   attend: '',
   groups: '',
   hostusers: ''
 );

 Map<String, dynamic> response = await ApiServices.scheduleMeeting(token, ScheduleObject);

To Generate JWT Token Endpoint => https://docs.v-empower.com/docs/MeetHour-API/b7e3d0ab3906f-generate-jwt

   GenerateJwtType JWTObject = GenerateJwtType(
     config: '',
     contactid,
     meetingid,
     uiconfig

   Map<String, dynamic> response =  await ApiServices.generateJwt(token, JWTObject);

   );

To fetch User Details: => https://docs.v-empower.com/docs/MeetHour-API/ff9d0e37d9191-user-details

    Map<String, dynamic> response =  await ApiServices.userDetails(token);

To fetch access Token using Refresh Token: => https://docs.v-empower.com/docs/MeetHour-API/d851be1af9804-get-access-token-using-refresh-token

   RefreshTokenType RefreshTokenObject = RefreshTokenType(
            client_id: '';
            client_secret: '';
            grant_type: '';
            refresh_token: '';
   )
   Map<String, dynamic> response =  await ApiServices.getRefreshToken(token, RefreshTokenObject);

To add a contact in Meet Hour database: => https://docs.v-empower.com/docs/MeetHour-API/bd1e416413e8c-add-contact

    AddContactType AddContactObject = AddContactType(
         countrycode: '',
         email: '',
         firstname: '',
         image: '',
         is_show_portal: '',
         lastname: '',
         phone: ''
    );
   Map<String, dynamic> response =  await ApiServices.addContact(token AddContactObject);

To get Timezones of various countries: => https://docs.v-empower.com/docs/MeetHour-API/c688c29bce9b9-timezone-list

    Map<String, dynamic> response =  await ApiServices.timezone(token)

To get list of all the contacts in your Meet Hour account: => https://api.meethour.io/api/{version}/customer/contacts

   ContactsType AddContactObject = ContactsType(
     exclude_hosts: 1100,
     limit: 10,
     page: 1
   );

   Map<String, dynamic> response =  await ApiServices.contactsList(token, AddContactObject);

To make changes in the existing contact details: => https://docs.v-empower.com/docs/MeetHour-API/28cae9187d215-edit-contact


 EditContactType EditContactObject =  EditContactType(
   contactid: 1150;
   countrycode: '',
   email: '',
   firstname: '',
   image: '',
   is_show_portal: '',
   lastname: '',
   phone: ''
 );

Map<String, dynamic> response = ApiServices.editContact(token, EditContactObject);

To get Upcoming Meetings: => https://docs.v-empower.com/docs/MeetHour-API/31df88388416d-upcoming-meetings

UpcomingMeetingType UpcomingMeetingObject =  UpcomingMeetingType(
   page: 10,
   limit: 10,
   show_all: 1
 );

  Map<String, dynamic> response = ApiServices.upcomingMeetings(token, UpcomingMeetingObject

To archive a meeting: => https://docs.v-empower.com/docs/MeetHour-API/1dd64523cc6bf-archive-meeting

ArchiveMeetingType ArchiveMeetingObject =  ArchiveMeetingType(
   id: 10
 );

  Map<String, dynamic> response = ApiServices.archiveMeeting(token, ArchiveMeetingObject);

To get the details of a missed meeting: => https://docs.v-empower.com/docs/MeetHour-API/92998e2dda102-missed-meetings

MissedMeetingType MissedMeetingObject =  MissedMeetingType(
   limit: 10,
   page: number,
   show_all: 1
 );

  Map<String, dynamic> response = ApiServices.missedMeetings(token, MissedMeetingObject);

To get completed meetings: => https://docs.v-empower.com/docs/MeetHour-API/aa9ef6a678250-completed-meetings

 CompletedMeetingType CompletedMeetingObject =  CompletedMeetingType(
   limit: 10,
   page: number,
   show_all: 1
 );

  Map<String, dynamic> response = ApiServices.completedMeetings(token, CompletedMeetingObject);

To edit an existing meeting: => https://docs.v-empower.com/docs/MeetHour-API/5dedde36380b4-meeting-edit-meeting


 EditMeetingType EdiMeetingObject = EditMeetingType(
   meeting_id: ''
   meetingName : 'Test',
   agenda: '',
   passcode: '',
   meetingDate: '',
   meetingTime: '',
   meetingMeridiem: '',
   durationhr: '',
   durationmin: '',
   timezone: '',
   isrecurring: '',
   recurringtype: '',
   repeat_interval: '',
   endBy: '',
   enddatetime: '',
   instructions: '',
   is_show_portal: '',
   enablepreregistration: '',
   meetingtopic: '',
   meetingagenda: '',
   old_attend: []
   options: '',
   attend: '',
   groups: '',
   hostusers: ''
 );
 Map<String, dynamic> response = await ApiServices.editMeeting(token, EdiMeetingObject);

To view a meeting: => https://docs.v-empower.com/docs/MeetHour-API/7e9a0a1e0da7f-meeting-view-meeting


 ViewMeetingType ViewMeetingObject =  ViewMeetingType(
   meeting_id: ''
 );

  Map<String, dynamic> response = ApiServices.viewMeeting(token, ViewMeetingObject);

To get all the recordings list: => https://docs.v-empower.com/docs/MeetHour-API/ce7c4fd8cae7e-recording-list

 RecordingsListType RecordingMeetingObject =  RecordingsListType(
   filter_by: '';
   limit: '';
   page: '';
 );

  Map<String, dynamic> response = ApiServices.recordingsList(token, RecordingMeetingObject);

Configuration

IOS

Note: Example compilable with XCode 12.2 & Flutter 1.22.4. Podfile Ensure in your Podfile you have an entry like below declaring platform of 11.0 or above and disable BITCODE.

platform :ios, '12.1'

...

post_install do |installer|
  installer.pods_project.targets.each do |target|
  flutter_additional_ios_build_settings(target)
      target.build_configurations.each do |config|
        config.build_settings['ENABLE_BITCODE'] = 'NO'
        config.build_settings["EXCLUDED_ARCHS[sdk=iphonesimulator*]"] = "arm64"
         end
     end
   end

Info.plist
Add NSCameraUsageDescription and NSMicrophoneUsageDescription to your Info.plist.

<key>NSCameraUsageDescription</key>
<string>$(PRODUCT_NAME) MyApp needs access to your camera for meetings.</string>
<key>NSMicrophoneUsageDescription</key>
<string>$(PRODUCT_NAME) MyApp needs access to your microphone for meetings.</string>

Android

Gradle
Set dependencies of build tools gradle to minimum 3.6.3:

dependencies {
    classpath 'com.android.tools.build:gradle:7.1.0' <!-- Upgrade this -->
    classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
}

Set distribution gradle wrapper to minimum 5.6.4.

distributionBase=GRADLE_USER_HOME
distributionPath=wrapper/dists
zipStoreBase=GRADLE_USER_HOME
zipStorePath=wrapper/dists
distributionUrl=https\://services.gradle.org/distributions/gradle-7.2-bin.zip <!-- Upgrade this -->

AndroidManifest.xml
Meet Hour's SDK AndroidManifest.xml will conflict with your project, namely the application:label field. To counter that, go into android/app/src/main/AndroidManifest.xml and add the tools library and tools:replace="android:label" to the application tag.

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="yourpackage.com"
    xmlns:tools="http://schemas.android.com/tools"> <!-- Add this -->
    <application 
        tools:replace="android:label"  
        android:name="your.application.name"
        android:label="My Application"
        android:icon="@mipmap/ic_launcher">
        ...
    </application>
...
</manifest>

Minimum SDK Version 23
Update your minimum sdk version to 23 in android/app/build.gradle

defaultConfig {
    applicationId "go.meethour.io.flutter.sdk_example"
    minSdkVersion 23 //Required for MeetHour
    targetSdkVersion 33
    versionCode flutterVersionCode.toInteger()
    versionName flutterVersionName
}

Proguard
MeetHour's SDK enables proguard, but without a proguard-rules.pro file, your release apk build will be missing the Flutter Wrapper as well as react-native code. In your Flutter project's android/app/build.gradle file, add proguard support

buildTypes {
    release {
        // TODO: Add your own signing config for the release build.
        // Signing with the debug keys for now, so `flutter run --release` works.
        signingConfig signingConfigs.debug

        // Add below 3 lines for proguard
        minifyEnabled false
        useProguard true
        proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
    }
}

Then add a file in the same directory called proguard-rules.pro. See the example app's proguard-rules.pro file to know what to paste in.

Note
If you do not create the proguard-rules.pro file, then your app will crash when you try to join a meeting or the meeting screen tries to open but closes immediately. You will see one of the below errors in logcat.

Join A Meeting

_joinMeeting() async {
    try {
      FeatureFlag featureFlag = FeatureFlag();
      featureFlag.welcomePageEnabled = false;
      featureFlag.resolution = FeatureFlagVideoResolution.MD_RESOLUTION; // Limit video resolution to 360p

      var options = MeetHourMeetingOptions()
        ..room = "TestRoom" // Required, spaces will be trimmed
        ..serverURL = "https://meethour.io"
        ..subject = "Meeting with John"
        ..userDisplayName = "John Delise"
        ..token = "" // JWT Token for User authentication as Moderator.
        ..pcode = "" // To Pass meeting password dynamically.
        ..userEmail = "john@gmail.com"
        ..userAvatarURL = "https://someimageurl.com/image.jpg" // or .png
        ..audioOnly = true
        ..audioMuted = true
        ..videoMuted = true
        ..prejoinPageEnabled = true // Make it false to Skip PrejoinPage
        ..disableInviteFunctions = true // To disable invite functions in Mobile SDK.
        ..featureFlag = featureFlag;

      await MeetHour.joinMeeting(options);
    } catch (error) {
      debugPrint("error: $error");
    }
  }

MeetHourMeetingOptions

Field	Required	Default	Description
room	Yes	N/A	Unique room name that will be appended to serverURL. Valid characters: alphanumeric, dashes, and underscores.
subject	No	$room	Meeting name displayed at the top of the meeting. If null, defaults to room name where dashes and underscores are replaced with spaces and first characters are capitalized.
userDisplayName	No	"Guest"	User's display name.
userEmail	No	none	User's email address.
audioOnly	No	false	Start meeting without video. Can be turned on in meeting.
audioMuted	No	false	Start meeting with audio muted. Can be turned on in meeting.
videoMuted	No	false	Start meeting with video muted. Can be turned on in meeting.
serverURL	No	meethour.io	Specify your own hosted server. Must be a valid absolute URL of the format `<scheme>://<host>[/path]`, i.e. https://someHost.com. Defaults to Meet Hour's servers.
userAvatarURL	N/A	none	User's avatar URL.
token	N/A	none	JWT token used for authentication.
pcode	N/A	none	pcode used for passing meeting password dynamically.
prejoinPageEnabled	N/A	false	Make it false to Skip PrejoinPage.
disableInviteFunctions	N/A	false	To disable invite functions in Mobile SDK.
featureFlag	No	see below	Object of FeatureFlag class used to enable/disable features and set video resolution of Meet Hour SDK.

FeatureFlag

Feature flag allows you to limit video resolution and enable/disable few features of Meet Hour SDK mentioned in the list below.

If you don't provide any flag to MeetHourMeetingOptions, default values will be used.

Flag	Default (Android)	Default (iOS)	Description
`addPeopleEnabled`	true	true	Enable the blue button "Add people", show up when you are alone in a call. Required for flag `inviteEnabled` to work.
`calendarEnabled`	true	auto	Enable calendar integration.
`callIntegrationEnabled`	true	true	Enable call integration (CallKit on iOS, ConnectionService on Android). SEE REMARK BELOW
`closeCaptionsEnabled`	true	true	Enable close captions (subtitles) option in menu.
`conferenceTimerEnabled`	true	true	Enable conference timer.
`chatEnabled`	true	true	Enable chat (button and feature).
`inviteEnabled`	true	true	Enable invite option in menu.
`iOSRecordingEnabled`	N/A	false	Enable recording in iOS.
`kickOutEnabled`	true	true	Enable kick-out option in video thumb of participants.
`liveStreamingEnabled`	auto	auto	Enable live-streaming option in menu.
`meetingNameEnabled`	true	true	Display meeting name.
`meetingPasswordEnabled`	true	true	Display meeting password option in menu (if a meeting has a password set, the dialog will still show up).
`pipEnabled`	auto	auto	Enable Picture-in-Picture mode.
`raiseHandEnabled`	true	true	Enable raise hand option in menu.
`recordingEnabled`	auto	N/A	Enable recording option in menu.
`resoulution`	N/A	N/A	Set local and (maximum) remote video resolution. Overrides server configuration. Accepted values are: LD_RESOLUTION for 180p, MD_RESOLUTION for 360p, SD_RESOLUTION for 480p(SD), HD_RESOLUTION for 720p(HD) .
`serverURLChangeEnabled`	true	true	Enable server URL change.
`tileViewEnabled`	true	true	Enable tile view option in menu.
`toolboxAlwaysVisible`	true	true	Toolbox (buttons and menus) always visible during call (if not, a single tap displays it).
`videoShareButtonEnabled`	true	true	Enable video share button.
`welcomePageEnabled`	false	false	Enable welcome page. "The welcome page lists recent meetings and calendar appointments and it's meant to be used by standalone applications."

MeetHourMeetingResponse

Field	Type	Description
isSuccess	bool	Success indicator.
message	String	Success message or error as a String.
error	dynamic	Optional, only exists if isSuccess is false. The error object.

Listening to Meeting Events

Events supported

Name	Description
onConferenceWillJoin	Meeting is loading.
onConferenceJoined	User has joined meeting.
onConferenceTerminated	User has exited the conference.
onPictureInPictureWillEnter	User entered PIP mode.
onPictureInPictureTerminated	User exited PIP mode.
onError	Error has occurred with listening to meeting events.

Per Meeting Events

To listen to meeting events per meeting, pass in a MeetHourMeetingListener
in joinMeeting. The listener will automatically be removed when an

onConferenceTerminated event is fired.

await MeetHour.joinMeeting(options,
  listener: MeetHourMeetingListener(onConferenceWillJoin: ({message}) {
    debugPrint("${options.room} will join with message: $message");
  }, onConferenceJoined: ({message}) {
    debugPrint("${options.room} joined with message: $message");
  }, onConferenceTerminated: ({message}) {
    debugPrint("${options.room} terminated with message: $message");
  }, onPictureInPictureWillEnter: ({message}) {
    debugPrint("${options.room} entered PIP mode with message: $message");
  }, onPictureInPictureTerminated: ({message}) {
    debugPrint("${options.room} exited PIP mode with message: $message");
  }));

Global Meeting Events

To listen to global meeting events, simply add a MeetHourListener with

MeetHour.addListener(myListener). You can remove listeners using

MeetHour.removeListener(listener) or MeetHour.removeAllListeners().

@override
void initState() {
  super.initState();
  MeetHour.addListener(MeetHourMeetingListener(
    onConferenceWillJoin: _onConferenceWillJoin,
    onConferenceJoined: _onConferenceJoined,
    onConferenceTerminated: _onConferenceTerminated,
    onPictureInPictureWillEnter: _onPictureInPictureWillEnter,
    onPictureInPictureTerminated: _onPictureInPictureTerminated,
    onError: _onError));
}

@override
void dispose() {
  super.dispose();
  MeetHour.removeAllListeners();
}

_onConferenceWillJoin({message}) {
  debugPrint("_onConferenceWillJoin broadcasted");
}

_onConferenceJoined({message}) {
  debugPrint("_onConferenceJoined broadcasted");
}

_onConferenceTerminated({message}) {
  debugPrint("_onConferenceTerminated broadcasted");
}

_onPictureInPictureWillEnter({message}) {
debugPrint("_onPictureInPictureWillEnter broadcasted with message: $message");
}

_onPictureInPictureTerminated({message}) {
debugPrint("_onPictureInPictureTerminated broadcasted with message: $message");
}

_onError(error) {
  debugPrint("_onError broadcasted");
}

Closing a Meeting Programmatically

MeetHour.closeMeeting();

Contributing

Send a pull request with as much information as possible clearly
describing the issue or feature. Keep changes small and for one issue at
a time.

DEV Community: Abdul Muqeet

Video SDK for Web JQuery - Meet Hour

MeetHour - JQuery Example

Steps to Use Meet Hour Web Jquery Example

Run Program

Library Import

API End Points Supported

Join Conference API

Controlling the embedded Meet Hour Conference

Video SDK for Web - Generic Javascript | Meet Hour

[MeetHour - Generic Javascript SDK]

Steps to Integrate:

MeetHour Embed Meeting

Meet Hour External Javascript API - SDK (Checkout Example.html)

Installation

API Documentation - https://docs.v-empower.com/docs/MeetHour-API/

Web Javascript SDK

api = new MeetHourExternalAPI(domain, options)

Controlling the embedded Meet Hour Conference

Video SDK for Web Laravel - Meet Hour

MeetHour-Laravel-PHP-Example

Features:

Try out one free session -

Composer package (Packagist) (Latest version - 1.0.1)

MeetHour SDK Implementation - Steps

Install

Steps to run the Example

Usage

Meet Hour - Join Meeting

API End Points Supported

Video SDK for CorePHP - Meet Hour

MeetHour-CorePHP-Example

Features:

Try out one free session -

Composer package (Packagist) (Latest version - 1.0.1)

MeetHour SDK Implementation - Steps

Install

Steps to run the Example

Usage

Meet Hour - Join Meeting

API End Points Supported

Video SDK for IOS - Swift & Objc - Meet Hour

Meet Hour iOS SDK releases

MeetHour SDK Implementation - Steps

Steps to Integrate:

title: "Meet Hour iOS SDK"

For iOS - Pod Update

Latest Verion - 4.1.4

Screenshot

Using the SDK

POD INSTALL

API

Issues

Video SDK for Android Native - Java & Kotlin

MeetHour SDK Implementation - Steps

Steps to Integrate:

title: "Meet Hour Android SDK"

Latest Verion - 4.2.4

Build your own, or use a pre-build SDK artifacts/binaries

Use pre-build SDK artifacts/binaries

React Native Video SDK - Meet Hour

NPM package (Latest version - 3.0.20)

Steps to Use Meet Hour React Native SDK Example

Run Program

API End Points Supported

Usage

iOS install

Android install

Options

Troubleshooting

Video Flutter SDK - Meet Hour

MeetHour SDK Implementation - Steps

Steps to Use Meet Hour React Flutter SDK Example

Table of Contents

Configuration

Android

Join A Meeting

MeetHourMeetingOptions

FeatureFlag

MeetHourMeetingResponse

`api = new MeetHourExternalAPI(domain, options)`