Get started with Link Visual

Updated at:

This document describes how to quickly get started with the Link Visual service and learn about its features.

1. Product development

  1. Log on to the IoT Platform console.
  2. On the console homepage, click Service Center in the lower-right corner, and then click View Details under Link Visual
  3. From the Project Selection list, select a project.
    If you do not have any projects, click Create Project to create a new one. For more information, see Create a project.
  4. On the Service Content tab, select a project name from the drop-down list, and click Quick Create Product in the Service Flow
    flow1
  5. Configure the parameters for the video product.

    To quickly try the service, set Connection Method to Cellular (2G/3G/4G). For production devices, configure this parameter based on their actual specifications.

    After the product is created, the Function Definition page is automatically displayed.

  6. Define the product's features and properties.
    The IoT Platform provides default feature definitions for video products. For this quick start, use the default properties.
  7. Click Next: Device Debugging to add a test device.
    1. Select the module information.
      For this quick start, you can select any module information. For production devices, select the information that matches your module.
    2. Click Add Test Device. The Add Test Device dialog box appears.
      After you add a test device, you can use the free device certificate provided by the platform to debug the device. Each product supports up to 50 free test devices. The certificates for test devices are for debugging only and cannot be used for mass production. 测试设备
    3. Click OK. The device certificate for the test device appears in the dialog box.
      Figure 1. Device certificate for the test device 设备激活凭证
  8. Click Next: Human-Computer Interaction to select an app version and obtain the network configuration QR code.
    For this quick start, use the public app (Cloud Intelligence) to quickly try device control.
    1. Turn on the Use Public App to Control Product switch.
    2. Click Network Configuration + App Download QR Code to obtain the QR code.
      配网二维码
    3. In the text box, enter the DeviceName from the device certificate figureGenerate QR Code.
      Figure 2. QR code for network configuration and app download 生成二维码

Run the Link Visual demo

The IoT Platform provides a Link Visual demo for Linux. Follow these steps to run the demo and use a virtual camera to try the Link Visual service.

  1. Download the Link Visual demo.

    The IoT Platform provides two types of Link Visual demos. Select one based on your development environment.

    • Link Visual demo for Ubuntu

      This demo is compiled on an x86 64-bit Ubuntu 16.04 system. It has not been tested on other Linux versions. To avoid compatibility issues, we recommend that you install the same Ubuntu version. Click to download the Link Visual demo for Ubuntu

    • Link Visual demo for Docker

      The Docker image provides better cross-platform capabilities. You can install Docker on operating systems such as Windows, macOS, and Linux, and run the demo in Docker. Click to download the Link Visual demo for Docker

    Note By downloading this Link Visual demo, you agree to the Software License Agreement.
  2. Run the Link Visual demo program.
    • Link Visual demo for Ubuntu
      # The downloaded file is link_visual_ipc_ubuntu_1.2.2.tar.gz
      # Decompress the file and go to the decompressed folder
      $ tar -xf link_visual_ipc_ubuntu_1.2.2.tar.gz
      $ cd link_visual_ipc_ubuntu_1.2.2
      # Confirm the file content
      $ ls
      aac_h265_640
      aac_h265_640.index
      aac_h265_640.meta
      aac_h265_768
      aac_h265_768.index
      aac_h265_768.meta
      link_visual_demo
      # Pass the device certificate information and run the program
      $ ./link_visual_demo -p your_product_name -n your_device_name -s your_device_secret
    • Link Visual demo for Docker
      # The downloaded file is link_visual_ipc_docker_1.2.2.tar.gz
      # Import the Docker image
      $ docker load -i link_visual_ipc_docker_1.2.2.tar.gz
      Loaded image: ubuntu:lv_1.2.2
      # Run the image. You will enter the container generated from the image.
      $ docker run -it --rm ubuntu:lv_1.2.2 bash
      # Go to the link_visual folder
      $ cd /link_visual
      # Decompress the content and go to the folder
      $ tar -xf sample.tar.gz
      $ cd sample
      # Confirm the file content
      $ ls
      aac_h265_640
      aac_h265_640.index
      aac_h265_640.meta
      aac_h265_768
      aac_h265_768.index
      aac_h265_768.meta
      link_visual_demo
      # Pass the device certificate information and run the program
      $ ./link_visual_demo -p your_product_name -n your_device_name -s your_device_secret
    Note In the command, replace your_productname, your_devicename, and your_devicesecret with your device certificate information. For more information, see Test device certificate.
  3. Check the results of the Link Visual demo.
    • In the app, trigger features such as live streaming and video-on-demand to watch the playback.
    • When a feature is triggered in the app, view the real-time device logs in Docker or Ubuntu where the Link Visual demo is running.

Use the public app to try the Link Visual service

  1. Scan the generated QR code for network configuration and app download to download the public app (Cloud Intelligence). For more information about how to download the public app, see Cloud Intelligence app overview.
  2. Use the downloaded public app (Cloud Intelligence) to scan the generated QR code for network configuration and app download and attach the virtual device.
    After the virtual device is attached, you can try the features of Link Visual.

    From the device list in the public app (Cloud Intelligence), select the camera device. You will see the following interfaces: live streaming, settings, gallery, and local video playback.

    云智能摄像头界面

    The camera product in the current public app includes the following features.

    Feature Description
    Camera settings Includes settings for day/night mode, video image flip, alarm switch, motion detection sensitivity, alarm frequency, alarm period, storage card status, capacity display, and storage card formatting. The alarm switch controls device alarms. When triggered, the device uploads an alarm photo to the cloud for viewing in the gallery. Formatting the storage card deletes all files on it.
    Live stream resolution switching Switch the resolution based on the types your device supports.
    Live stream sound switch This switch only controls the volume of the live stream on your phone. It does not affect the sound captured by the camera.
    Live stream screen recording Record a segment of the current live stream. You can view the resulting file in your phone's photo album.
    Live stream screenshot Take a screenshot of the current live stream. You can view the resulting file in your phone's photo album.
    Voice intercom Use this feature to have a voice chat with people near the camera.
    Camera rotation control Use the control pad on the live stream page to rotate the camera up, down, left, and right to see the desired view.
    Gallery Displays alarm pictures generated by device alarms. The reporting switch, sensitivity, frequency, and time period are configured in the "Alarm Settings" section.
    Card recording Displays historical recordings saved on the camera's storage card for a certain period. You can view card recordings from any time period.
    Cloud recording View recordings that are generated by device alarms and uploaded to the cloud.