@huddly/camera-proto

An npm package describing the protobuf api for huddly network cameras

Usage no npm install needed!

<script type="module">
  import huddlyCameraProto from 'https://cdn.skypack.dev/@huddly/camera-proto';
</script>

README

falcon-interface

Language and style guide for proto3

https://developers.google.com/protocol-buffers/docs/proto3 https://developers.google.com/protocol-buffers/docs/style

Important note about enums: -The default value is the first defined enum value, which must be 0. -The zero value enum should have the suffix unspecified. E.g. it should not be used under normal conditions. -The zero value needs to be the first element, for compatibility with the proto2 semantics where the first enum value is always the default.

How to build

conan create . huddly/latest -r conan -pr x86_64-linux-gcc-7

Proto markups

Below you can see the different markups that are used to ignore proto code that is specific to huddly. When generating the google proto file, all the code that has been tagged with the markup lines will not be present.

// @HuddlyOnly-NextBlock

This markup will ignore the whole block that follows after the markup line. It will also ignore any nested blocks within the ignore block.

// @HuddlyOnly-NextLine

This markup will ignore the next line that follows after the markup line.

Releasing NPM package

Making a npm release is done manually by one of the developers with publishing access to our huddly organization account on npmjs. The following procedure should be followed when wanting to make a new npm package release:

  • Make sure you know what is the current released version on artifactory (through conan) for falcon interface and use that to bump the version on package.json
    • You can either update the version manually by editting the package.json or run npm version [patch|minor|major] to bump it through npm
  • After having updated the package.json version, make sure you commit the changes to github
  • Last step is to make the actual release. You can do that by running the following command npm run publish-package. NOTE Running this command requires you to be logged in to npmjs through your terminal windows with the huddly account.

Releasing Nuget package

Making a nuget release is done manually by whomever has access to artifactory. The following procedure should be followed:

  • Go to artifactry.huddly.io and log in. Navigate to artifacts and locate huddly-nuget repository. Click on the repository and go to Set me Up
  • On the Set me up page of the nuget repository, enter you password and copy the information for setting up your nuget repository locally
  • The following command sets up a nuget repository (Note, if you enter the password on the set me up page, you can use the authentication key instead of the password on the next command):
nuget sources Add -Name Artifactory -Source https://artifactory.huddly.io/artifactory/api/nuget/nuget -username <USERNAME> -password <PASSWORD/API_KEY>
nuget sources Add -Name ArtifactoryNugetLocal -Source https://artifactory.huddly.io/artifactory/api/nuget/nuget-local -username <USERNAME> -password <PASSWORD/API_KEY>
  • After having run that command you need to make sure you authenticate yourself against that repository. The following command can be used:
nuget setapikey <USERNAME>:<PASSWORD/API_KEY> -Source Artifactory
nuget setapikey <USERNAME>:<PASSWORD/API_KEY> -Source ArtifactoryNugetLocal
  • Now you are good to publish any nuget packages to the nuget-local repository on artifactory.
  • By setting up the nuget repository locally, you can fetch nuget packages from the official nuget registry but also from our own one hosted on artifactory
    • nuget is a virtual repository
    • nuget-local is a local repository where we host our nuget packages
    • nuget-remote is a remote repository in artifactory pointing to official nuget registry (this one we dont have to set up as setting up the virtual one is sufficient)
  • Make sure your versions are matching on all packages (npm and nuget). TIP: you can use ./scripts/bump_version.sh script to bump the versions for the npm and nuget packages.
  • Pack and push your new nuget package using the following command:
nuget pack Huddly.CameraProto.nuspec
nuget push Huddly.CameraProto.nuspec -Source ArtifactoryNugetLocal
  • Locate your newly pushed nuget package on the nuget-local repository on artifactory.

NOTE: Afected projects when doing changes to this repository and/or making new releases include: