Houston video calls: Difference between revisions

Jump to navigation Jump to search

Houston video calls (view source)

Revision as of 07:56, 23 February 2023

7,510 bytes removed ,  23 February 2023
Replaced content with "{{Discontinued}}"
(no longer supported)
(Replaced content with "{{Discontinued}}")
Tag: Replaced
 
Line 1: Line 1:
: ''This article is about Resco platform feature. If you are looking for the stand-alone product, see '''[[Resco Houston]]'''.''
{{Discontinued}}
 
{{Note|AR calls will no longer be supported after December 2022. Should you have any questions, please contact sales@resco.net.|Warning}}
 
Resco remote assistance '''Houston''' is a video call functionality that connects a user, usually a technician on-site or in the field, with a remote expert. The receiver of the call can draw augmented-reality (AR) instructions within the video scene to speed up the repair process, reduce site or machine downtime, or share the knowledge in the field.
 
{{YT|hfeBK4TBEVA}}
 
The access to Houston is included in the [[Mobile_users#Types_of_license|Standard license and the Inspections license]]. It is available on iOS and Android devices, and also from the web app. To use augmented reality, the calling device has to support one of the following functions:
* ARKit (requires iOS 11+)
* ARCore (requires Android; see [https://developers.google.com/ar/devices list of devices])
 
Without this support, video calls can still be used, but the recipient cannot draw into the video. The recipient’s mobile device does not have to support ARKit to draw into the video. The list of devices supporting ARKit can be found [https://www.apple.com/augmented-reality/ on Apple web].
 
Houston video calls run with [[Resco Cloud]], Dynamics, and Salesforce backends.
 
== Generate Agora key ==
 
Houston uses a third-party solution from agora.io for video calls. To use Houston with Resco, you first need to register on agora.io and generate a key that you later save in Woodford.
 
# Go to [https://sso.agora.io/v2/signup www.agora.io].
# Sign up to create an account.
# Create a new project
# Copy '''App ID''' and '''App certificate'''. You will need these in the next step, in Woodford configuration.
 
== Set up Woodford ==
 
In your app project, you need to enable Houston and enter the key from Agora.
 
# Edit your [[app project]] in [[Woodford]].
# Select '''Houston''' from the '''Project''' menu and enable it.
# Enter the '''Agora Key''' and '''App Certificate''', then click '''Save'''.
# Publish the project.
 
Enabling Houston in Woodford automatically enables chat and adds the Phone Call entity to your app project. Do not disable the entity as it is mandatory for Houston to work.
 
== Set up Dynamics ==
 
If you want to initiate and receive calls directly from the Dynamics backend:
* Create an app project with the name "Houston" and enter the same Agora credentials as in your usual project.
* If you want to receive calls, you must register your browser to receive notifications. This is a one-time action. As a security measure from the browser, this cannot be automated. Log in to Dynamics, go to '''Resco Suite > Houston''', and click '''Register Houston'''.<br>[[File:Register houston in dynamics.png|600px]]
* If you want to initiate calls directly from the Dynamics web app, you can for example add a button on the Dynamics user form that would point to a special URL; see [[Houston_video_calls#Custom_call_URL|Custom call URL]].
 
== Add the command for initiating calls ==
 
You can add the command for initiating Houston video calls to multiple locations of your app:
* In questionnaires
* In entity forms
* As a custom URL
 
=== Set up your questionnaire ===
 
No configuration needed. Houston is automatically available from all questionnaires.
 
=== Set up your entity forms ===
 
You can make Houston calls available on standard entity forms as a form command.
 
# Edit the app project.
# Select the entity from the '''Project''' menu.
# Click '''Show UI''' to display the list of views, forms, and charts.
# Double-click the [[Form#Add_commands|form]] where you want to add the Houston command.
# Click '''Edit''' to display the [[command editor]].
# Add '''Houston''' to the '''Selected Commands''' pane.
# Save everything and publish the project.
 
[[File:Add houston command.png]]
 
=== Custom call URL ===
 
Alternatively, you can use a custom URL to initiate a call. Add the URL as a command, button, or home screen item of the app. On Dynamics, you can add it also to the web, for example, as a button on the Dynamics user form. The URL format depends on your backend server:
* Dynamics: <code><nowiki>https://<dynamics-organization-url>/webresources/resco_MobileCRM/WebClient/registerHouston.html?data={encodedData}</nowiki></code>
* Resco Cloud: <code><nowiki>https://<your organization>.build.rescocrm.com/WebApp/registerHouston.html?data={encodedData}</nowiki></code>
 
Encoded data must be created in the following format:
:<syntaxhighlight lang="js">
var calleeId = "<callee's id>";
var calleeName = "<callee's name>";
var encodedData = encodeURIComponent("call&calleeId=" + calleeId + "&calleeName=" + calleeName);</syntaxhighlight>
 
== Start a call ==
 
To start a video call:
# Start the app and open any questionnaire or one of the forms where Houston is enabled.
# Select the '''Houston''' command from the hamburger menu.<br>[[File:Start a video call using Houston.png|300px]]
# Select a recipient from the list of users in your organization.
 
If your device does not support augmented reality, a plain video call is used.
 
The recipient of the call must also have a device synchronized with the same organization. The app does not have to be running to receive calls.
 
Once the call ends, both users can save their notes about the call. This is saved to the Phone call entity.
 
[[File:Video call.jpg|600px]]
 
== Receive call via web ==
 
Recipients can answer the call also from the web. These are the prerequisites:
 
* Accepting calls using web app runs on Resco Cloud and Dynamics.
* The web app does not have to be running, but the recipient must have used it at least once so that the notifications can be registered.
* At least one browser window must be open and push notifications must be enabled in the browser.
* Houston runs on Chrome, Firefox, and Edge, but it does not run in incognito mode/private window.
* Popups and microphone use must be allowed for the web app.
* We recommend checking the global notifications settings in Windows (to make sure that they are not blocked). In need of troubleshooting, please visit [https://support.microsoft.com/en-nz/help/4028678/windows-10-change-notification-settings Microsoft support web].
 
This is the actual flow of the call for the recipient:
# You receive a system notification about an incoming call.<br>[[File:Houston 1 notif.png|450px]]
# Click '''Open Incoming Call'''. The call dialog opens in your browser. You can either accept or decline the call.
# Click '''Accept''' to open Houston web interface.
# Wait for the caller to map the AR scene by moving the device to the front and back and to the sides.<br>[[File:Map scene.jpg|450px]]
# After a few seconds, once the mapping is done, you can start drawing. Add 3D arrows and notes to the shared scene.<br>[[File:Draw.jpg|450px]]
# You can also make notes about the issue that was solved on the call in the Notes section. The note will be saved in the phone call record in the Phone call entity.
# When the call ends, you can complete the notes, save them, and then close the browser.<br>[[File:Houston 4 note.png|450px]]
 
== [[Localization]] ==
 
You can change the label of the Remote Assistance command using the string <code>Cmd.RemoteAssistance</code>.
 
== See also ==
 
* [https://youtu.be/L4GKZcXGqMU?t=73 Winter Update 2020] {{Badge|Webinar|YouTube}}
 
[[Category:Resco Inspections]] [[Category:Resco Mobile CRM]]
Retrieved from "https://docs.resco.net/wiki/Special:MobileDiff/8485"

Navigation menu