Transcript
Modules
Creating an IR-Based Driver This solution shows how to create an IR device for K-Touch by learning the commands from an IR remote. IR learning is done with a Kramer FC-26. Note: IR learning was added to the FC-26 with firmware version 1.11.24319. Upgrade your FC-26 if necessary. 1. Download an XML Editor ■ All K-Touch commands are written in XML format. While not 100% needed, a true XML editor allows you to navigate the document more easily. ■
If you do not already have an XML editor, download a free one like Atom (www.atom.io).
2. Download the IR Template.xml ■ Attached to this knowledge base article is a file called "IR Template.xml". ■
Download the file.
3. Open the IR Template in your XML Editor ■ Open Atom (or other XML editor) and open the IR Template.xml file.
4. Enter Device Properties ■ The first tag is 'device'. It contains six properties. ■
Replace the values with ones for this IR device.
Fixed: This value is "false" Model: Enter the model of the IR device in quotes. Name: Enter the name of the device as you wish to see it in the builder in quotes. Shared: This value is "false". Type: Type of device from the following list: AUX (default), AV System, Blu Ray, Cable, CD, DTV Converter, DVD, DVD/VCR Combo, Game, Home Theater System, iPod, Laser Disc, Lighting, Media Manager, Multizone System, Projector, Receiver/Preamp, Satellite, Set Top Box, Shading, Soundbar, Subwoofer, Switcher, Tuner, Thermostat, TV, TV/DVD Combo, TV/DVD/VCR Combo, TV/VCR Combo, VCR, Video Processor, Unknown Type. Vendor: Manufacturer of device in quotes. ■ The following is an example for the Apple TV device built in this tutorial. ?
■
Now you are ready to learn and enter the codes into the device
5. Go to the FC-26 Web Page ■ Connect your PC and the FC-26 to the same network and navigate to the FC-26 Web page. ■
Click on the IR Command Learner tab.
6. Learn a Command ■ Click 'Start Learning' in the FC-26 Web page. ■
Holding the IR remote that you are using, point it at the IR In on the front of the FC-26 and press one of the buttons you wish to learn. ■ Note: Be sure that when you are learning IR commands you are in an environment without any other IR interferance (flourescent lights, other IR remotes, etc.) ■ ■
Hold the IR remote as close as possible to the IR receiver "eye". The command appears in the command received box.
7. Add Command to XML Device
■
Use the copy button in the FC-26 Web page to copy the IR command. ■
Switch back to your XML editor.
■
Follow the convention of the example codes for your new code.
■
Type the name of the command between the quotes after Code name= (in this case, the menu command).
■
Enter the command after the > and before the .
8. Repeat for All Needed Commands ■ Repeat steps 6 and 7 for all the commands you need for this one device. ■
Delete the example codes.
9. Save As ■ The XML device is finished. Save the file on your computer with a .xml extension. 10. Upload your Device to the K-Touch Builder ■ Go to the device tab and click on the menu option.
■
Choose Upload devices.
■
Choose the file and click Upload.
■
View the new device in the builder with all the commands.
11. Share your IR Device with Kramer (optional) ■ We are always trying to expand our driver database. To add your driver to our global database of devices, email the XML file to [email protected] ■
We appreciate your help.
Using the Video Player Module The video player module places a previously recorded video file directly into your K-Touch GUI.
Locate the videos either directly on the mobile device or hosted on the Web.
1. Locate the Video Player Module ■ Under the More tab, expand Modules and find the Video Player.
2. Drag the Module onto Your GUI
3. Video Player Properties ■ Click on Video Player to reveal its properties in the lower left corner.
Name: Name the video player. Row: Vertical position on the screen based on grid spaces. Column: Horizontal position on the screen based on grid spaces. Width: Horizontal size of the player based on grid spaces. Height: Vertical size of the player based on grid spaces. Corner Radius: To give the player rounded corners, increase the corner radius. The higher the radius, the larger the curve. File URL: Location or name of the file played by the video player. Show Control: If Yes, the video player controls are embedded in screen controls. The controls operate like the video player native to your mobile device. Auto Play: If Yes, the video automatically plays when entering the page containing the video player. Video Loop: If Yes, the video automatically loops without any interaction from the user. 4. Set Video Player Properties ■ Set the Properties to whatever fits your project. This example uses a video file hosted on the internet located at:
■
https://ia601406.us.archive.org/8/items/BigBugBunny_AVCHD/bigBuckBunny_avchd_720p.mp4 Copy this URL into the File URL property of the video player.
5. Finished If your mobile device is saved and synced, the video automatically plays when the page opens in the K-Touch app. Since this video is hosted on the internet, the mobile device must be connected to the internet to work.
6. Additional The ‘Show Control’ option is set to YES so the user can control the video with the controls embedded in the player. However, the video player can be controlled with a button action as well. ■ Under the More tab in the Action Folder, find Media Control.
■
Drag this action to your GUI to be part of any macro.
7. Media Control Action Properties The media control action properties are as follows:
■
Player Name: This property determines which video player module is controlled. Select the name of a specific media player or choose to control all media players located in this panel. Control Option: Determine what action to execute when this action is activated. Choose from: Play
■
Pause
■
Stop
■
Fast Forward
■
Rewind
■
Mute
■
Un-Mute
Adding a Security Camera Android can only support one camera stream per panel. If you have multiple cameras to view while using Android you must separate them amongst different panels in your project. ■ To add a security camera to your handset: 1. Open Builder. 2. Open the page to which you want to add the module.
3. Open the More tab.
4. Open the Modules section of the More tab.
5. Open the Security section of the Module section.
6. Select your camera type. 7. Drag the camera to your page.
8. Select the resolution of your camera from the properties window.
Note: You see the Channel ID within this image. This does not appear for all camera models. Cameras that require the Channel parameter are: ■ Channel Vision ■ Grandstream ■ ICRealtime ■ SnapAV ■ ACTi ?9. Save and sync. 10. Delete a camera Right-click and choose Delete camera:
10. Edit the Gateway within the application. For all cameras use HTTP Gateway with GET Method. The necessary ports are listed below: ■ ACTi, Channel Vision, Foscam SD, and SnapAV use Port 80 ■ Axis, Foscam HD, GrandStream, ICRealtime and LILIN use Port 554
Supported Cameras Below is a list of currently supported cameras using the K-Touch Security module: Note the connection URL within the camera information. If your camera model does not match the camera we tested in our offices, you can input the connection URL into the gateway setup. Make sure to remove the username, password, IP and port from the connection URL. This configures the standard gateway configuration areas for the information
We currently do not support two way audio with cameras.
ACTi ■
Tested Model Supported resolutions (320x240, 640x480 & 720p) ■ PTZ is supported ■ Connection URL http://{IP}:{HOST}/cgi-bin/encoder?USER={USER}&PWD={PWD}&CHANNEL={CHANNEL} &GET_STREAM={STREAM} ■ Note - It is recommended to set the video stream quality using the VIDEO_MJPEG_QUALITY param, 70 is the default. To set the resolution, add the VIDEO_RESOLUTION parameter after the channel parameter. Resolutions are formatted with an N before the height and width. Example: N{HEIGHT}x{WIDTH} ? ■
?
AXIS ■
Tested Model - P55 Series Supported Resolutions (720x480 to 176x120 @ 60Hz, 720x576 to 176x144 @ 50Hz, 720p & 1080P) ■ PTZ is supported on some models? ■ Connections URL's - H264(rtsp://{AUTH@}{IP}:{PORT}/axis-media/axis.amp?videocodec=h264) MJPEG(http://{AUTH@}{IP}:{PORT}/mjpg/video.mjpg) ■
Channel Vision ■
Test models - 6532? Supported Resolutions (320x240 & 640x480) ■ PTZ is supported ■ Connection URL http://{AUTH@}{IP}:{PORT}/GetData.cgi?CH={CHANNEL} &Codec=jpeg&Size={RESOLUTION} ■
Foscam ■
Tested models - FI8910W, Supported resolutions HD (720p) SD (320x240 & 640x480) ■ PTZ is supported ■ Connection URL - below ■ SD (Video Only) http://{AUTH@}{IP}:{PORT}/videostream.cgi?resolution={resolution}&rate=0 ■ SD (Audio & Video) http://{AUTH@}{IP}:{PORT}/videostream.cgi?resolution={resolution}&rate=0 ■ HD http://{IP}:{PORT}/cgi-bin/CGIStream.cgi?cmd=GetMJStream&usr={USERNAME}&pwd= {PASSWORD} Notes - The port used is different for HD (88) and SD (80). Also we do not currently support the 1080p Foscam camera ?? ■
Grandstream ■
Tested models GXV3662HD ■ Supported resolutions - below ■ 4:3 (480x368 to 1280x960) ■ 16:9 (480x272 to 1280x720) ■
PTZ is supported ■ Connection URL - rtsp://{AUTH@}{IP}:{PORT}/{CHANNEL} ? ?
ICRealtime ■
Tested models ICIPD2000AIR
■
Supported resolutions (1080p, 720p, 1280x960, 1280x1024, CIF, D1) PTZ is supported on some devices ■ Connection URL rtsp://{AUTH@}{IP}:{PORT}/cam/realmonitor?channel={CHANNEL}&subtype={SUBSTREAM#} ■
?
LILIN ■
Tested Models - IPS5184 / IPS5188
■
Supported Resolutions ( 480p & 1080p) PTZ is supported Connection URL - rtsp://{AUTH@}{IP}:{PORT}/jpeg{RESOLUTION} ?
■ ■
?
SnapAV ■
Tested Models - none. SnapAV provided a URL for us to test using our application Supported Resolutions (320x240, 640x480, 720p & 1080p) ■ NO PTZ Support ■ Connection URL http://{AUTH@}{IP}:{HOST}/GetData.cgi?CH={CHANNEL}&Codec={CODEC} ■
Adding the iTunes Module iTunes
is media management software created by Apple, Inc., for both the Macintosh and Windows operating systems. You can use it to manage and play both audio and video files on your computer. The K-Touch iTunes module is a pre-defined GUI that can be embedded into any project. The module acts like a remote control for iTunes on a computer on the same network.
1. Drag in the iTunes Module ■ In the More tab, inside Modules, you can find iTunes. Drag it onto your page and resize it if needed. This finishes using Builder for the iTunes module. The rest of the task connects the mobile device with your computer.
2. Save and Sync Your Mobile Device
At first view, the panel shows that the module is not configured:
3. Create an iTunes Gateway in the K-Touch App ■ In the App under Gateways, click Edit and add a new iTunes gateway.
4. View the 4-Digit Passcode When you create a new iTunes gateway, you receive a randomly generated 4-digit passcode.
5. Open iTunes ■ Open iTunes on the computer that contains and hosts your music (this computer must be on the same network as the connected mobile device). When you open iTunes you see a new icon that looks like the a play button:
6. Click that Icon ■ Click on that icon. You are prompted to enter a 4-digit code. ■
Enter the code received from the K-Touch app under the iTunes gateway.
7. Pairing Successful After entering the correct code, you receive confirmation that the two devices have been successfully paired on both iTunes and in the KTouch iTunes gateway. ■
Click Save in the K-Touch iTunes gateway to save the gateway.
8. Enter K-Touch Panel ■ After properly configuring iTunes, return to the K-Touch page with the iTunes module and verify it is working correctly. Your entire iTunes library has been imported and you can select songs and playlists as you choose. You can play audio from the computer and/or any AirPlay device connected to the computer.
Note: For the module to function, iTunes must be running at all times. To see the project in action, open the attached K-Touch backup file.
