Nimble Pixie Merchant

    @azure/video-analyzer-edge
    TypeScript icon, indicating that this package has built-in type declarations

    1.0.0-beta.4 • Public • Published

    Deprecated. Azure Video Analyzer Edge client library for JavaScript

    Deprecated. We’re retiring the Azure Video Analyzer preview service, you're advised to transition your applications off of Video Analyzer by 01 December 2022. This SDK is not longer maintained.

    Azure Video Analyzer is an [Azure Applied AI Service][applied-ai-service] that provides a platform for you to build intelligent video applications that can span both edge and cloud infrastructures. The platform offers the capability to capture, record, and analyze live video along with publishing the results, video and video analytics, to Azure services at the edge or in the cloud. It is designed to be an extensible platform, enabling you to connect different video inferencing edge modules such as Cognitive services modules, or custom inferencing modules that have been trained with your own data using either open-source machine learning or [Azure Machine Learning][machine-learning].

    Use the client library for Video Analyzer Edge to:

    • Simplify interactions with the Microsoft Azure IoT SDKs
    • Programmatically construct pipeline topologies and live pipelines

    Key links:

    Getting started

    Install the package

    Install the Video Analyzer client library for Typescript with npm:

    npm install @azure/video-analyzer-edge

    Prerequisites

    • TypeScript v3.6.
    • You need an active Azure subscription, and a IoT device connection string to use this package.
    • To interact with Azure IoT Hub you will need to run npm install azure-iothub
    • You will need to use the version of the SDK that corresponds to the version of the Video Analyzer edge module you are using.
    SDK Video Analyzer edge module
    1.0.0-beta.3 1.1
    1.0.0-beta.2 1.0
    1.0.0-beta.1 1.0

    Creating a pipeline topology and making requests

    Please visit the Examples for starter code.

    We guarantee that all client instance methods are thread-safe and independent of each other (guideline). This ensures that the recommendation of reusing client instances is always safe, even across threads.

    Key concepts

    Pipeline topology vs live pipeline

    A pipeline topology is a blueprint or template for instantiating live pipelines. It defines the parameters of the pipeline using placeholders as values for them. A live pipeline references a pipeline topology and specifies the parameters. This way you are able to have multiple live pipelines referencing the same topology but with different values for parameters. For more information please visit pipeline topologies and live pipelines.

    Examples

    Creating a pipeline topology

    To create a pipeline topology you need to define sources and sinks.

    const rtspSource: RtspSource = {
      //Create a source for your pipeline topology
      name: "rtspSource",
      endpoint: {
        url: "${rtspUrl}",
        "@type": "#Microsoft.VideoAnalyzer.UnsecuredEndpoint",
        credentials: {
          username: "${rtspUserName}",
          password: "${rtspPassword}",
          "@type": "#Microsoft.VideoAnalyzer.UsernamePasswordCredentials"
        }
      } as UnsecuredEndpoint,
      "@type": "#Microsoft.VideoAnalyzer.RtspSource"
    };
    
    const nodeInput: NodeInput = {
      //Create an input for your sink
      nodeName: "rtspSource"
    };
    
    const videoSink: VideoSink = {
      name: "videoSink",
      inputs: [nodeInput],
      videoName: "video",
      localMediaCachePath: "/var/lib/videoanalyzer/tmp/",
      localMediaCacheMaximumSizeMiB: "1024",
      "@type": "#Microsoft.VideoAnalyzer.VideoSink"
    };
    
    const pipelineTopology: PipelineTopology = {
      name: "jsTestTopology",
      properties: {
        description: "description for jsTestTopology",
        parameters: [
          { name: "rtspUserName", type: "String", default: "testUsername" },
          { name: "rtspPassword", type: "SecretString", default: "testPassword" },
          { name: "rtspUrl", type: "String" }
        ],
        sources: [rtspSource],
        sinks: [videoSink]
      }
    };

    Creating a live pipeline

    To create a live pipeline instance, you need to have an existing pipeline topology.

    const livePipeline: LivePipeline = {
      name: "jsLivePipelineTest",
      properties: {
        description: "description",
        topologyName: pipelineTopologyName,
        parameters: [{ name: "rtspUrl", value: "rtsp://sample.com" }]
      }
    };

    Invoking a direct method

    To invoke a direct method on your device you need to first define the request using the Video Analyzer Edge SDK, then send that method request using the IoT SDK's CloudToDeviceMethod.

    import { createRequest } from "@azure/video-analyzer-edge";
    import { Client } from "azure-iothub";
    
    const deviceId = process.env.iothub_deviceid;
    const moduleId = process.env.iothub_moduleid;
    const connectionString = process.env.iothub_connectionstring;
    const iotHubClient = Client.fromConnectionString(connectionString); //Connect to your IoT Hub
    
    const pipelineTopologySetRequest = createRequest("pipelineTopologySet", pipelineTopology);
    const setPipelineTopResponse = await iotHubClient.invokeDeviceMethod(deviceId, moduleId, {
      methodName: pipelineTopologySetRequest.methodName,
      payload: pipelineTopologySetRequest.payload
    });

    Troubleshooting

    • When creating a method request remember to check the spelling of the name of the method

    Next steps

    Contributing

    This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.microsoft.com.

    If you encounter any issues, please open an issue on our Github.

    When you submit a pull request, a CLA-bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., label, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA.

    This project has adopted the Microsoft Open Source Code of Conduct. For more information, see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.

    Install

    npm i @azure/video-analyzer-edge

    DownloadsWeekly Downloads

    68

    Version

    1.0.0-beta.4

    License

    MIT

    Unpacked Size

    561 kB

    Total Files

    17

    Last publish

    Collaborators

    • azure-sdk