Skip to content

Commit f4cf012

Browse files
authored
[AVA] Changes to ReadMe (Azure#15442)
* small changes on readme * ran prerelease script
1 parent 4a22e11 commit f4cf012

File tree

3 files changed

+26
-21
lines changed

3 files changed

+26
-21
lines changed

sdk/videoanalyzer/video-analyzer-edge/CHANGELOG.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,8 @@
11
# Release History
22

3-
## 1.0.0-beta.2 (Unreleased)
3+
## 1.0.0-beta.2 (2021-05-28)
44

5+
Update the title and description of the package and updates to readme.
56

67
## 1.0.0-beta.1 (2021-05-20)
78

sdk/videoanalyzer/video-analyzer-edge/README.md

Lines changed: 23 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,11 @@
11
# Azure Video Analyzer Edge client library for JavaScript
22

3-
Azure Video Analyzer on IoT Edge provides a platform to build intelligent video applications that span the edge and the cloud. The platform offers the capability to capture, record, and analyze live video along with publishing the results, video and video analytics, to Azure services in the cloud or the edge. It is designed to be an extensible platform, enabling you to connect different video analysis edge modules (such as Cognitive services containers, custom edge modules built by you with open-source machine learning models or custom models trained with your own data) to it and use them to analyze live video without worrying about the complexity of building and running a live video pipeline.
3+
Azure Video Analyzer provides a platform to build intelligent video applications that span the edge and the cloud. The platform offers the capability to capture, record, and analyze live video along with publishing the results, video and video analytics, to Azure services in the cloud or the edge. It is designed to be an extensible platform, enabling you to connect different video analysis edge modules such as Cognitive services containers, custom edge modules built by you with open source machine learning models or custom models trained with your own data. You can then use them to analyze live video without worrying about the complexity of building and running a live video pipeline.
44

5-
Use the client library for Video Analyzer on IoT Edge to:
5+
Use the client library for Video Analyzer Edge to:
66

7-
- Simplify interactions with the [Microsoft Azure IoT SDKs](https://github.com/azure/azure-iot-sdks)
8-
- Programmatically construct pipeline topologies and live pipelines
7+
- Simplify interactions with the [Microsoft Azure IoT SDKs](https://github.com/azure/azure-iot-sdks)
8+
- Programmatically construct pipeline topologies and live pipelines
99

1010
[Product documentation][doc_product] | [Direct methods][doc_direct_methods] | [Source code][source]
1111

@@ -21,30 +21,32 @@ npm install @azure/video-analyzer-edge
2121

2222
### Prerequisites
2323

24-
- TypeScript v3.6.
25-
- You need an active [Azure subscription][azure_sub], and a IoT device connection string to use this package.
26-
- To interact with Azure IoT Hub you will need to run `npm install azure-iothub`
27-
- You will need to use the version of the SDK that corresponds to the version of the Video Analyzer Edge module you are using.
24+
- TypeScript v3.6.
25+
- You need an active [Azure subscription][azure_sub], and a IoT device connection string to use this package.
26+
- To interact with Azure IoT Hub you will need to run `npm install azure-iothub`
27+
- You will need to use the version of the SDK that corresponds to the version of the Video Analyzer edge module you are using.
2828

29-
| SDK | Video Analyzer Edge Module |
29+
| SDK | Video Analyzer edge module |
3030
| ------------ | -------------------------- |
31-
| 1.0.0-beta.1 | 1.0 |
31+
| 1.0.0-beta.x | 1.0 |
3232

3333
### Creating a pipeline topology and making requests
3434

3535
Please visit the [Examples](#examples) for starter code.
3636

37+
We guarantee that all client instance methods are thread-safe and independent of each other ([guideline](https://azure.github.io/azure-sdk/dotnet_introduction.html#dotnet-service-methods-thread-safety)). This ensures that the recommendation of reusing client instances is always safe, even across threads.
38+
3739
## Key concepts
3840

39-
### Pipeline Topology vs Pipeline Instance
41+
### Pipeline topology vs live pipeline
4042

4143
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][doc_pipelines].
4244

4345
## Examples
4446

4547
### Creating a pipeline topology
4648

47-
To create a pipeline topology you need to define parameters, sources, and sinks.
49+
To create a pipeline topology you need to define sources and sinks.
4850

4951
```typescript
5052
const rtspSource: RtspSource = {
@@ -75,7 +77,7 @@ const rtspSource: RtspSource = {
7577
const pipelineTopology: PipelineTopology = {
7678
name: "jsTestTopology",
7779
properties: {
78-
description: "description for jsTestTopology",
80+
description: "Continuous video recording to a Video Analyzer video",
7981
parameters: [
8082
{ name: "rtspUserName", type: "String", default: "dummyUsername" },
8183
{ name: "rtspPassword", type: "SecretString", default: "dummyPassword" },
@@ -97,16 +99,16 @@ To create a live pipeline instance, you need to have an existing pipeline topolo
9799
const livePipeline: LivePipeline = {
98100
name: pipelineTopologyName,
99101
properties: {
100-
description: "description for jsTestLivePipeline",
102+
description: "Continuous video recording to a Video Analyzer video",
101103
topologyName: "jsTestTopology",
102104
parameters: [{ name: "rtspUrl", value: "rtsp://sample.com" }]
103105
}
104106
};
105107
```
106108

107-
### Invoking a pipeline method request
109+
### Invoking a direct method
108110

109-
To create a pipeline method request you will need to get your deviceId and moduleId from your Azure IoT hub.
111+
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`.
110112

111113
```typescript
112114
import { createRequest } from "@azure/video-analyzer-edge";
@@ -125,11 +127,13 @@ const setPipelineTopResponse = await iotHubClient.invokeDeviceMethod(deviceId, m
125127

126128
## Troubleshooting
127129

130+
- When creating a method request remember to check the spelling of the name of the method
131+
128132
## Next steps
129133

130-
- [Samples][samples]
131-
- [Azure IoT Device SDK][iot-device-sdk]
132-
- [Azure IoTHub Service SDK][iot-hub-sdk]
134+
- [Samples][samples]
135+
- [Azure IoT Device SDK][iot-device-sdk]
136+
- [Azure IoTHub Service SDK][iot-hub-sdk]
133137

134138
## Contributing
135139

sdk/videoanalyzer/video-analyzer-edge/package.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
{
22
"name": "@azure/video-analyzer-edge",
33
"version": "1.0.0-beta.2",
4-
"description": "A JavaScript sdk for Azure Video Analyzer Edge",
4+
"description": "A JavaScript sdk for Azure Video Analyzer Edge",
55
"sdk-type": "client",
66
"main": "dist/index.js",
77
"module": "dist-esm/src/index.js",

0 commit comments

Comments
 (0)