README.md

Overview

This tutorial demonstrates how to create a SmartThings Schema integration that enables you to add a webcam to your SmartThings account. The integration creates a single camera device that can be used to view the webcam's video stream from within the SmartThings app.

This tutorial is divided into five unique steps. Instructions for each step can be found in each step_<n> subdirectory.

⚠️ IMPORTANT: Code provided in steps 2 and later in each sample_files directory is for reference only and is not intended to be a pre-configured standalone solution. Each step builds on the previous step's sample files - when you finish following instructions for a given step, the code in your working directory should resemble the code examples and files provided in each step's sample_files directory.

Prerequisites

1. Basic familiarity with NodeJS and JavaScript
2. A Samsung account.
3. The SmartThings CLI installed and configured for your Samsung account. If you have not yet configured the CLI for use with your Samsung account, you will be prompted to do so when running the CLI for the first time.
4. A computer running MacOS, Windows, or Linux.
5. A webcam connected to your computer.
6. NodeJS version 20.

Tutorial

• Step 1: Get started with a pre-existing OAuth app
• Step 2: Create a device profile
• Step 3: Register your Schema integration
• Step 4: Implement a ring button
• Step 5: Add your camera

References

• Get Started with Cloud Connected Devices
• Get Started with SmartThings Schema
• Device Profiles
• st-schema NodeJS library