From f415145935160b3b950cd29e1d3f8b7b190204c2 Mon Sep 17 00:00:00 2001 From: yusuke-oba1 Date: Thu, 16 Jul 2026 14:05:24 +0900 Subject: [PATCH] =?UTF-8?q?=F0=9F=A4=96=20Merge=20PR=20#75181=20[safie-sdk?= =?UTF-8?q?]=20Update=20to=20v1.9=20by=20@yusuke-oba1?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Claude Opus 4.8 (1M context) --- types/safie-sdk/index.d.ts | 51 +++++++++++++++++++++++++++--- types/safie-sdk/package.json | 6 +++- types/safie-sdk/safie-sdk-tests.ts | 17 +++++++++- 3 files changed, 67 insertions(+), 7 deletions(-) diff --git a/types/safie-sdk/index.d.ts b/types/safie-sdk/index.d.ts index 109fd54923c1ef..45a0fc508e625c 100644 --- a/types/safie-sdk/index.d.ts +++ b/types/safie-sdk/index.d.ts @@ -81,6 +81,48 @@ declare namespace Safie { function removeToken(): Promise; } + /** + * SDK全体の設定に関する機能群 + */ + namespace Config { + /** + * テーマの設定に関する機能群 + */ + namespace Theme { + /** 設定可能なテーマ種別 */ + type ThemeType = "light" | "dark" | "system"; + /** + * テーマを設定します。 + * #### 概要 + * - SDK全体のテーマを設定します + * - 現在アクティブな全てのSDKコンポーネント（StreamingPlayer, Timeline等）に即時反映されます + * - "system"を指定するとOSのカラースキーム設定がリアルタイムに反映されます + * - 設定しない場合、デフォルトとして"light"が適用されます + * @param theme テーマ種別 + * @throws {@link ErrorDetail} `ThemeType`以外の値を指定した場合にスローされます + * @example + * ```js + * //ダークテーマに設定 + * Safie.Config.Theme.set('dark'); + * //OSのカラースキームに追従 + * Safie.Config.Theme.set('system'); + * ``` + */ + function set(theme: ThemeType): void; + /** + * 現在設定されているテーマ種別を返します。 + * #### 概要 + * - 現在設定されているテーマ種別を返します + * @returns 設定されているテーマ種別 + * @example + * ```js + * const theme = Safie.Config.Theme.get(); + * ``` + */ + function get(): ThemeType; + } + } + /** * デバイス情報の操作に関する機能群 */ @@ -122,10 +164,9 @@ declare namespace Safie { serverConnecting: boolean; }; /** - * @hidden - * デバイスのcapability情報 + * デバイスの機能情報のリスト */ - capabilities?: string[]; + capabilities: string[]; } /** * デバイス一覧取得の結果 @@ -305,6 +346,7 @@ declare namespace Safie { * @param options.limit 返却するリストの最大件数 (規定値: 20, 最大値: 100) * @param options.offset 返却するリストのオフセット (規定値: 0) * @param options.itemId デバイスに設定されているオプションによる絞り込み + * @param options.deviceIds デバイスIDによる絞り込み * @returns * @throws {@link ErrorDetail} * @example @@ -317,6 +359,7 @@ declare namespace Safie { limit?: number; offset?: number; itemId?: number; + deviceIds?: string[]; }): Promise; /** * サムネイル取得 @@ -725,8 +768,6 @@ declare namespace Safie { * ストリーミングプレイヤー * #### 概要 * 映像のストリーミング再生を行うプレイヤーです。 - * #### 制限: - * - ハイブリッド録画プランを利用のデバイスにおいて、通信を開始後にSafie Developersのアプリケーションの変更及びデバイスオプションの削除を行っても、視聴中は反映されません。 * #### 必要な権限: * - ライブ + 録画(VOD配信、タイムライン連携時の場合) * #### 必要なOAuth2.0 scope: diff --git a/types/safie-sdk/package.json b/types/safie-sdk/package.json index c3ffc567d0d23b..b0dd484c353362 100644 --- a/types/safie-sdk/package.json +++ b/types/safie-sdk/package.json @@ -1,7 +1,7 @@ { "private": true, "name": "@types/safie-sdk", - "version": "1.8.9999", + "version": "1.9.9999", "projects": [ "https://developers.safie.link/" ], @@ -12,6 +12,10 @@ { "name": "Safie Inc.", "githubUsername": "SafieDev" + }, + { + "name": "Yusuke Oba", + "githubUsername": "yusuke-oba1" } ], "nonNpm": true, diff --git a/types/safie-sdk/safie-sdk-tests.ts b/types/safie-sdk/safie-sdk-tests.ts index 003f63b31cc51c..79baea9a1d4016 100644 --- a/types/safie-sdk/safie-sdk-tests.ts +++ b/types/safie-sdk/safie-sdk-tests.ts @@ -11,9 +11,21 @@ async function testAuth(): Promise { await Safie.Auth.removeToken(); } +function testConfig(): void { + // SDK全体のテーマ設定（v1.9で追加） + const themeTypes: Safie.Config.Theme.ThemeType[] = ["light", "dark", "system"]; + themeTypes.forEach(theme => { + Safie.Config.Theme.set(theme); + }); + const currentTheme: Safie.Config.Theme.ThemeType = Safie.Config.Theme.get(); + console.log(currentTheme); +} + async function testDevices(): Promise { const devicesAll: Safie.Devices.QueryDevicesResult = await Safie.Devices.queryDevices(); await Safie.Devices.queryDevices({ limit: 30, offset: 10, itemId: 1 }); + // デバイスIDによる絞り込み（v1.9で追加） + await Safie.Devices.queryDevices({ deviceIds: ["device1", "device2"] }); devicesAll.list.forEach((device: Safie.Devices.Device) => { const id: string = device.deviceId; const modelName: string = device.model.description; @@ -21,7 +33,9 @@ async function testDevices(): Promise { const name: string = device.setting.name; const streaming: boolean = device.status.videoStreaming; const connected: boolean = device.status.serverConnecting; - console.log(id, modelName, serial, name, streaming, connected); + // デバイスの機能情報のリスト + const capabilities: string[] = device.capabilities; + console.log(id, modelName, serial, name, streaming, connected, capabilities); }); const thumbnail: Blob = await Safie.Devices.queryThumbnail({ deviceId: "device" }); @@ -290,6 +304,7 @@ function testErrorHandling(error: Safie.ErrorDetail): void { // 全テスト関数を参照することで未使用警告を抑止する testAuth(); +testConfig(); testDevices(); testPlayer(); testTimeline();