自由配置キャンバス

座標を指定してテキストと画像を置く画面。キャンバスは 576x360 で、左上が原点。ファームウェア 1.2.0 以上が対象。画像も同じ。

開いて送る

sendCanvas() か sendCanvasImage() を送るだけで画面が切り替わる。先にページを開く必要はない。

commandManager.sendCanvas(
    listOf(
        CommandManager.CanvasElement(id = 0, x = 16, y = 8, width = 240, height = 40, text = "見出し"),
    ),
)
// 画像はテキストの背面に置かれる
commandManager.sendCanvasImage(id = 0, x = 16, y = 84, width = 192, height = 192, grayscale = photo)
// 他の要素を残して id 1 だけ足す
commandManager.sendCanvasElements(
    listOf(
        CommandManager.CanvasElement(id = 1, x = 16, y = 300, width = 240, height = 40, text = "キャプション"),
    ),
)
commandManager.closeCanvas()

sendCanvas() は今ある要素を全て消してから、渡した要素を並べる。今ある要素を残したまま一部だけ置き直すなら sendCanvasElements()。既にある id に送ると座標とサイズごと差し替わり、テキストを空にするとその id が消える。

はみ出した矩形は端で切られ、キャンバスの外に出た要素は描かれない。テキストは矩形内で左揃えに折り返し、あふれた分は切られる。

画像を置く

sendCanvasImage() の grayscale は画像表示ページと同じ形式で、1画素1バイト・左上から行優先。量子化と圧縮は SDK が行う。同じ id に送ると座標ごと差し替わり、removeCanvasImage() で1枚だけ消せる。画像はテキスト要素の背面に描かれるので、キャプションを重ねられる。

数百バイトずつに分けて送るため、大きい画像ほど表示までに時間がかかる。続けて呼んでも SDK が分割送信を直列化するので、送信が混ざることはない。

動画を流す

startCanvasAnimation() で寸法と再生間隔を宣言し、sendCanvasAnimationFrame() で1コマずつ送る。ファームウェア 1.2.0 以上が対象。

// 128x96 をキャンバス中央に、1コマ100msで流すと宣言する
commandManager.startCanvasAnimation(x = 224, y = 132, width = 128, height = 96, intervalMs = 100)
frames.forEach { frame ->
    // grayscale は1画素1バイト・左上から行優先。量子化と圧縮、分割はSDKが行う
    commandManager.sendCanvasAnimationFrame(width = 128, height = 96, grayscale = frame)
}
commandManager.stopCanvasAnimation()

画像バッファは1コマぶんのスロットに切り直され、リングバッファとして使い回される。コマは使い捨てなので、sendCanvasImage() のような容量の上限がなく、長さの制限なく流し続けられる。 2枚たまってから再生が始まり、送信が間に合わないときは直前のコマを出したまま待つので、黒画面にもコマ飛びにもならない。

バッファを共有しているため、流し始めると置いてある画像は消え、流している間に sendCanvasImage() を送ると再生が止まる。テキスト要素とは併用できる。

実効fpsはBLEのスループットが天井になる。128x96・intervalMs = 100 あたりから始めて、グラス側の見え方を確かめながら詰めるとよい。1コマが大きいほど分割送信が増えるので、間隔を詰めるより先に寸法を落とした方が効く。

制限

対象	上限
テキスト要素	id 0..7 の8個
画像	id 0..7 の8枚
テキストの合計	190バイト程度（分割送信できない）
画像のバッファ	置いてある画像の `width * height * 2` の合計 + 受信中の圧縮データが 380,000 バイトまで

192角なら5枚が目安。テキストが収まらないときは sendCanvasElements() で1要素ずつ送れば表示は積み上がる。

画像バッファはナビの全体ルート画像と共有しているため、ナビ表示中はキャンバスの画像は使えない。

消す・やめる

clearCanvas() はキャンバスを開いたまま全ての要素を消す。置いた画像も一緒に消える。 closeCanvas() は閉じてホームなどに戻り、表示していた要素は破棄される。リモコンの戻る操作やホームへの遷移でも閉じる。

自由配置キャンバス

開いて送る

画像を置く

動画を流す

制限

消す・やめる

関連 API