Piece開発ガイドライン

目次

Pieceの説明文について

PieceJSONの説明文には、作成されたPieceがどんなもので、どのように使用するPieceなのか説明文を記載していただきます。Piece説明文の体裁を揃えるため、雛型をご利用ください。(PieceJSON Generatorではテンプレートが用意されています。ぜひご利用ください。)
説明文がガイドラインに則っていない場合、Piece登録の審査時に、Riiiver運営チームから修正や追記を依頼することがあります。


descriptionの記載例
{
  "title": {
    "en": "iiidea name",
    "ja": "iiideaの名前"
  },
  "description": {
    "en": "
    ~~What is this Piece?~~\n
    Summary regarding your Piece is here.\n
    \n
    ~~How do I use it?~~\n
    Describe how to use.\n
    ~~Notes~~\n
    Precautions for use. This part is optional.\n
    \n
    ~~Compatible with~~\n
    Clarify the compatible products if your Piece cannot be used among all Riiiver devices without causing trouble\n
    \n
    About Trademarks ( https://riiiver.com/en/trademark/ )",
    "ja": "
    【どんなPiece?】\n
    Pieceの概要を記載します。\n
    \n
    【どうやって使うの?】\n
    Preferenceの設定項目など、Pieceの使い方を説明します。\n
    \n
    【ご注意!】\n
    エラー時の処理など、ユーザーに知らせておきたい使用上の注意を記載します。特にない場合は記載不要です。\n
    \n
    【対象製品】\n
    使用できるデバイスが限られている場合、ここに記載してください。全てのRiiiverデバイスで利用可能な場合は記載不要です。\n
    \n
    商標について ( https://riiiver.com/trademark/ )"
  },
・
・
・
}
JSONファイルでの改行について
ここでは、見易さのために改行して記載しています。

上記の雛形について注意すべきポイントを解説します。

見出しを追加する

説明文が長くなるとどこに何が書いてあるのかが分かりにくくなるため、内容ごとに見出しをつけていただくようご協力をお願いいたします。

見出し必須内容
【どんなPiece?】Pieceの概要を記載してください。
【どうやって使うの?】Pieceの使い方を記載してください。
【ご注意!】-ユーザーに知らせておきたい使用上の注意を記載します。特にない場合は記載不要です。
【対象製品】-Pieceを使用できるデバイスが限られている場合、ここに記載してください。全てのRiiiverデバイスで利用可能な場合は記載不要です。
使用非推奨ワードとその置き換え

Riiiverを利用するユーザーは様々な方が利用しますので、使用非推奨の単語を制定し、その置き換えをご協力いただける範囲でお願いしております。

非推奨ワード置き換えワード
iiideaの実行、動作iiideaを開始する、動かす、動き出す
アクティブ使用可能なとき、準備ができている状態
フォアグランドアプリの画面が表示されて操作可能なとき(フォアグランド)
バックグラウンドアプリが起動されているが画面に表示されていないとき(バックグラウンド)
トグル交互に切り替える
コントロール操作する、動かす
制御操作する、動かす
アウトプット、出力次のPieceに渡す
インプット、入力前のPieceから受け取った~
文字列、テキスト文字、文章
デバイス機器/商品/製品
商標について

外部サービスを利用したPieceをつくる場合に、商標権に関する法務的な事項に対し、商標に関する説明をまとめたページを用意しております。説明文の末尾に下記の定型文・リンクを追加してくださいますようお願いいたします。

英語日本語
About Trademarks ( https://riiiver.com/en/trademark/ )商標について ( https://riiiver.com/trademark/ )

この記事は役に立ちましたか?