ニコニコ動画 技術的詳細分析(更新版)

@Kongyokongyo / 更新: 2026/05/19 02:45
TEXT 29.6KB
0
  1. # ニコニコ動画 技術的詳細分析
  3. ---
  5. ## アーキテクチャ概要
  7. ニコニコ動画はモダンなマイクロサービスアーキテクチャを採用しており、以下のような技術スタックで構成されています：
  9. - **フロントエンド**: React/Remix ベースの SPA (`nvpc_next` = NicoNico Video Player Client Next)
  10. - 視聴ページ (`/watch/{id}`) は Remix ベースのコード分割バンドル
  11. - トップ系ページ (`/`, `/video_top`) は従来型のバンドル (`vendor.js` + `pages_index_*.js`)
  12. - **共通ヘッダー**: `common-header.nimg.jp/3.9.0/pc/CommonHeader.min.js` (バージョン 3.9.0)
  13. - **動画配信**: HLS (HTTP Live Streaming) + AWS CloudFront (CDN)
  14. - **API**: JSON ベースの RESTful API (フロントエンド ID `6` で識別)
  15. - **コメント**: 専用のコメントサーバー (`public.nvcomment.nicovideo.jp`)
  16. - **認証**: セッションベースの認証 + JWT トークン (`x-access-right-key`, `threadKey`)
  17. - **ヘッダー入札**: Prebid.js による多数の SSP/エクスチェンジ統合
  19. ---
  21. ## フロントエンド技術スタック
  23. ### JavaScriptバンドル構造
  25. ニコニコ動画はページの性質に応じて 2 種類のバンドルを使い分けています：
  27. ```
  28. https://resource.video.nimg.jp/web/scripts/
  29. ├── nvpc_next/assets/ # 視聴ページ用 Remix バンドル (Vite hash付き)
  30. │ ├── manifest-*.js # マニフェスト
  31. │ ├── entry.client-*.js # クライアントエントリーポイント
  32. │ ├── root-*.js # ルートコンポーネント
  33. │ ├── index-*.js # 共通コンポーネント (複数)
  34. │ ├── api-client-*.js # API クライアント
  35. │ ├── use-media-query-*.js # メディアクエリフック
  36. │ ├── useDeferredLoadable-*.js # 遅延ロードフック
  37. │ ├── useLayoutType-*.js # レイアウト判定フック
  38. │ ├── usePreviewVideoStatus-*.js # プレビュー再生フック
  39. │ ├── ab-testing-*.js # A/B テスト
  40. │ ├── enum-*.js # 列挙型定数
  41. │ ├── _web-*.js # 視聴ページ共通ルート
  42. │ ├── _web.watch._id._-*.js # 動画視聴ページ
  43. │ ├── _web.random_play._itemId._-*.js # ランダム再生ページ
  44. │ └── _web.easy_nicos._id._-*.js # 簡単ニコ動ページ
  45. └── bundle/
  46. ├── vendor.js # サードパーティライブラリ
  47. ├── pages_index_TopPage.js # サービス統合トップ (`/`)
  48. └── pages_index_VideoTop.js # 動画トップ (`/video_top`)
  49. ```
  51. ### 主要なフロントエンド機能 (視聴ページ)
  53. | コンポーネント | 説明 |
  54. |--------------|------|
  55. | `PlayerVolumeBar` | プレイヤーボリュームコントロール |
  56. | `PlayerSeekBar` | プレイヤーシークバー |
  57. | `VideoCard` / `NicoadVideoCard` | 動画カード表示 (通常版 / ニコニ広告版) |
  58. | `VideoMediaObject` | 動画メディアオブジェクト (スケルトン付き) |
  59. | `FollowButton` | ユーザーフォローボタン |
  60. | `Toast` | 通知表示 |
  61. | `WakutkoolNotice` | わくくおる通知 (ポータル横断告知) |
  62. | `TagRelatedBanner` | タグ関連バナー |
  63. | `SearchRelatedTag` | 関連タグ検索 |
  64. | `WatchLayoutLazySidebar` / `WatchLayoutLazyBottom` | 視聴ページの遅延ロード領域 |
  65. | `FloatingBottomRightPresenter` | 右下フローティング UI |
  66. | `GiftAuditionPresenter` | 動画ギフト + オーディションプレゼンター |
  67. | `AfkStopMessagePresenter` | 放置検知後の停止メッセージ |
  68. | `MutedVideoThumbnail` | ミュート扱い動画のサムネイル |
  69. | `VideoShareTimeInput` | 時刻指定シェアの入力 |
  70. | `PremiumRegisterRequired` | プレミアム登録誘導モーダル |
  71. | `CollapsiblePanel` / `Skeleton` / `Tabs` | 汎用 UI プリミティブ |
  72. | `nicoad` | ニコニ広告機能 |
  74. ### メタデータ・OGP
  76. 視聴ページ (`/watch/{id}`) は動画用 OGP に最適化されており、Open Graph Video / Twitter App Card / App Links が含まれます：
  78. ```html
  79. <meta property="og:title" content="新・豪血寺一族 -煩悩解放 - レッツゴー！陰陽師">
  80. <meta property="og:type" content="video.other">
  81. <meta property="og:site_name" content="ニコニコ動画">
  82. <meta property="og:locale" content="ja_JP">
  83. <meta property="og:video" content="https://embed.nicovideo.jp/watch/{id}?autoplay=1">
  84. <meta property="og:video:type" content="video/mp4">
  85. <meta property="og:video:width" content="640">
  86. <meta property="og:video:height" content="360">
  87. <meta property="video:duration" content="320">
  88. <meta property="video:release_date" content="2007-03-06T00:33+0900">
  89. <meta property="fb:app_id" content="378853695459932">
  90. <meta name="twitter:card" content="summary_large_image">
  91. <meta name="twitter:site" content="@nico_nico_info">
  92. <meta name="twitter:app:id:iphone" content="307764057">
  93. <meta name="twitter:app:url:iphone" content="nico://play/?vid={id}">
  94. <meta name="twitter:app:id:googleplay" content="jp.nicovideo.android">
  95. <meta name="twitter:app:url:googleplay" content="nico://watch/{id}">
  96. <meta property="al:ios:url" content="nico://play/?vid={id}&utm_source=facebook&...">
  97. <meta property="al:android:url" content="https://www.nicovideo.jp/watch/{id}?...">
  98. <meta property="al:web:url" content="https://www.nicovideo.jp/watch/{id}">
  99. ```
  101. トップページ (`/`) は `og:type="website"`、動画トップ (`/video_top`) は `og:type="article"` という具合にページ種別ごとに切り替わります。
  103. ---
  105. ## 主要APIエンドポイント
  107. ### 1. 動画アクセス権限 API (HLS)
  109. **エンドポイント**: `POST https://nvapi.nicovideo.jp/v1/watch/{videoId}/access-rights/hls?actionTrackId={actionTrackId}`
  111. 動画のストリーミング URL を取得するためのアクセス権限を要求します。`actionTrackId` クエリパラメータでセッションを識別し、再リクエスト時には `&__retry=N` が付与されます。
  113. #### リクエストヘッダー
  115. ```http
  116. x-access-right-key: {JWTトークン}
  117. x-frontend-id: 6
  118. x-frontend-version: 0
  119. x-request-with: nicovideo
  120. x-niconico-language: ja-jp
  121. Content-Type: application/json
  122. Accept: application/json;charset=utf-8
  123. ```
  125. #### リクエストボディ (初回, `?actionTrackId=...` のみ)
  127. `outputs` のみ。動画の元素材が許可する全 video×audio 組み合わせを列挙します：
  129. sm9 (古い動画) の場合：
  131. ```json
  132. {
  133. "outputs": [
  134. ["video-h264-360p", "audio-aac-128kbps"],
  135. ["video-h264-360p", "audio-aac-64kbps"],
  136. ["video-h264-360p-lowest", "audio-aac-128kbps"],
  137. ["video-h264-360p-lowest", "audio-aac-64kbps"]
  138. ]
  139. }
  140. ```
  142. sm46309015 (新しい動画) の場合：
  144. ```json
  145. {
  146. "outputs": [
  147. ["video-h264-720p", "audio-aac-192kbps"],
  148. ["video-h264-720p", "audio-aac-64kbps"],
  149. ["video-h264-480p", "audio-aac-192kbps"],
  150. ["video-h264-480p", "audio-aac-64kbps"],
  151. ["video-h264-360p", "audio-aac-192kbps"],
  152. ["video-h264-360p", "audio-aac-64kbps"],
  153. ["video-h264-144p", "audio-aac-192kbps"],
  154. ["video-h264-144p", "audio-aac-64kbps"]
  155. ]
  156. }
  157. ```
  159. #### リクエストボディ (heartbeat 付きの後続呼び出し, `?actionTrackId=...&__retry=N`)
  161. 再生開始時や状態変化時に、`outputs` に加えて `heartbeat` フィールドで視聴セッションの状態を送信します：
  163. ```json
  164. {
  165. "outputs": [["video-h264-360p", "audio-aac-128kbps"]],
  166. "heartbeat": {
  167. "method": "guest",
  168. "params": {
  169. "eventType": "start",
  170. "eventOccurredAt": "2026-05-19T02:27:29+09:00",
  171. "watchMilliseconds": 0,
  172. "endCount": 0,
  173. "additionalParameters": {
  174. "___pc_v": 1,
  175. "os": "Windows",
  176. "os_version": "15.0.0",
  177. "nicosid": "{nicosid}",
  178. "is_ad_block": false,
  179. "is_ad_block_by_as": false,
  180. "has_playlist": false,
  181. "playback_rate": "1",
  182. "loop_count": 0,
  183. "suspend_count": 0,
  184. "load_failed": false,
  185. "preview_play": false,
  186. "hot_scene_wave": true,
  187. "seekbar_seek_count": 0,
  188. "performance": {
  189. "watch_access_start": 1779125249692,
  190. "video_loading_start": 1779125249698,
  191. "end_context": {
  192. "ad_playing": false,
  193. "video_playing": false,
  194. "is_suspending": false
  195. }
  196. },
  197. "__pc_is_ai_comment_visible": true
  198. }
  199. }
  200. }
  201. }
  202. ```
  204. #### レスポンス
  206. ```json
  207. {
  208. "meta": { "status": 201 },
  209. "data": {
  210. "contentUrl": "https://delivery.domand.nicovideo.jp/hlsbid/{bid}/playlists/variants/{variantId}.m3u8?session=...&Policy=...&Signature=...&Key-Pair-Id=...",
  211. "createTime": "2026-05-19T02:27:29+09:00",
  212. "expireTime": "2026-05-20T02:27:29+09:00"
  213. }
  214. }
  215. ```
  217. 初回 POST は `201 Created` を返し、heartbeat 付きの後続 POST は `200 OK` を返します。レスポンスに加えて `Set-Cookie: domand_bid=...` (Max-Age=86400, HttpOnly, Secure) が払い出されます。
  219. ### 2. コメントサーバー API
  221. **エンドポイント**: `POST https://public.nvcomment.nicovideo.jp/v1/threads?pc=1`
  223. 動画に紐づくコメントスレッドを取得します。`x-client-os-type: others` ヘッダーと `Content-Type: text/plain;charset=UTF-8` で送信されます。
  225. #### リクエストボディ
  227. ```json
  228. {
  229. "params": {
  230. "targets": [
  231. { "id": "1173108780", "fork": "owner" },
  232. { "id": "1173108780", "fork": "main" },
  233. { "id": "1173108780", "fork": "easy" }
  234. ],
  235. "language": "ja-jp"
  236. },
  237. "threadKey": "{JWTトークン}",
  238. "additionals": {}
  239. }
  240. ```
  242. #### レスポンス構造
  244. ```json
  245. {
  246. "meta": { "status": 200 },
  247. "data": {
  248. "globalComments": [{ "id": "1173108780", "count": 5659900 }],
  249. "threads": [
  250. {
  251. "id": "1173108780",
  252. "fork": "main",
  253. "commentCount": 5581324,
  254. "comments": [
  255. {
  256. "id": "882123066398695732",
  257. "no": 4118020,
  258. "vposMs": 361140,
  259. "body": "コメント本文",
  260. "commands": ["184"],
  261. "userId": "Yg_6QWiiS_T2mq3WJuzUcp41MvQ",
  262. "isPremium": true,
  263. "score": -2200,
  264. "postedAt": "2013-02-17T21:16:30+09:00",
  265. "nicoruCount": 137,
  266. "nicoruId": null,
  267. "source": "leaf",
  268. "isMyPost": false
  269. }
  270. ]
  271. }
  272. ]
  273. }
  274. }
  275. ```
  277. 旧仕様から増えたフィールド: `nicoruId` (押下したニコるの識別子)、`isMyPost` (自分の投稿か)、`source` は `"leaf"` 以外に `"nicoru"` (ニコる経由で表示されたコメント) を取り得ます。
  279. ### 3. レコメンデーション API
  281. **エンドポイント**: `GET https://nvapi.nicovideo.jp/v1/recommend`
  283. ページ種別ごとに `recipeId` を切り替えて呼び出します：
  285. | ページ | recipeId |
  286. |------|----------|
  287. | 視聴ページ | `video_watch_recommendation` (`recipeVersion=2`) |
  288. | 動画トップ (`/video_top`) | `video_top_recommend` (`with_reason=true`) |
  290. ```
  291. ?recipeId=video_watch_recommendation
  292. &recipeVersion=2
  293. &videoId=sm9
  294. &site=nicovideo
  295. &limit=25
  296. &sensitiveContents=mask
  297. ```
  299. レスポンス `data.items[].content` には、`owner.visibility` (`visible`/`hidden`)、`requireSensitiveMasking`、`isMuted`、難読化フィールド (`9d091f87`, `acf68865` のような短いキー) が含まれます。
  301. ### 4. ニコニ広告 API
  303. 旧来の v1 系と、視聴ページで新規導入された v2 系が併存しています：
  305. | エンドポイント | 用途 |
  306. |--------------|------|
  307. | `GET https://api.nicoad.nicovideo.jp/v1/contents/video/decoration?ids={csv}` | 動画一覧 (`/video_top` 等) のニコニ広告装飾を一括取得 |
  308. | `GET https://api.nicoad.nicovideo.jp/v2/contents/video/{id}/pickup_supporters?tags=...` | 視聴ページのピックアップサポーター取得 (v2) |
  309. | `GET https://api.nicoad.nicovideo.jp/v1/nage_video/{id}/gift/effects` | 動画ギフト (投げ銭) の利用可能エフェクト一覧 |
  310. | `GET https://api.nicoad.nicovideo.jp/v1/contents/nage_video/{id}/totalGiftPoint` | 動画ギフトの累計ポイント |
  312. ### 5. その他のAPI
  314. | API | エンドポイント | 用途 |
  315. |-----|---------------|------|
  316. | 広場ウィジェット | `GET eapi.beta.hiroba.nicovideo.jp/v1/square-widget?tags=...` | タグから関連コミュニティ広場を提案 |
  317. | ユーザーフォロー | `user-follow-api.nicovideo.jp/v1/user/followees/` | フォロー情報 |
  318. | 動画マイキー実績 | `GET mjk.nicovideo.jp/api/v1/content_types/video/contents/{id}/achieved_histories?limit=1&order=honor_class` | 動画の実績バッジ履歴 |
  319. | ユーザーマイキー実績 | `GET mjk.nicovideo.jp/api/v1/users/{userId}/achieved_histories?limit=1` | ユーザーの実績バッジ履歴 |
  320. | ストーリーボード | `nvapi.nicovideo.jp/v1/watch/{id}/access-rights/storyboard` | サムネイルシート |
  321. | マーキー | `GET nvapi.nicovideo.jp/v1/marquee` | プレイヤー上部のマーキー告知 |
  322. | AI キャラクターコメント | `GET nvapi.nicovideo.jp/v1/ai-comment/characters` | AI コメントの登場キャラクター一覧 (2026 年導入機能) |
  323. | クリエイターサポート | `GET nvapi.nicovideo.jp/v1/users/{userId}/creator-support` | 投稿者へのサポート (投げ銭/応援) 情報 |
  324. | オーディション応募 | `GET audition.nicovideo.jp/capi/v1/entry_items?item_type=video&item_id={id}&voting_phase=active&limit=1` | 動画が応募中のオーディション情報 |
  325. | ニコニ・コモンズ ライセンス | `GET public-api.commons.nicovideo.jp/v1/works/{id}/license` | コモンズ License (404 になることあり) |
  326. | わくくおる | `GET wktk.nicovideo.jp/v2/wakutkool/frames.json?names=watch-portal-link&tags=...&responseType=pc` | 横断告知 (v2 API) |
  327. | プリロール広告 | `GET ads.nicovideo.jp/api/video/getAd.json.php?...` | 動画再生前の広告枠 (linearType=preroll) |
  328. | ステラ (非会員視聴) | `POST stella.nicovideo.jp/v1/watch/nonmember.json` | 動画トップ等での非ログイン視聴セッション初期化 |
  330. ---
  332. ## 動画配信システム
  334. ### Domand (動画配信プラットフォーム)
  336. ニコニコ動画は **Domand** と呼ばれる社内動画配信プラットフォームを使用しています：
  338. - **配信ドメイン**: `delivery.domand.nicovideo.jp` (プレイリスト, 暗号鍵)
  339. - **アセットドメイン**: `asset.domand.nicovideo.jp` (CMAF セグメント, ストーリーボード)
  340. - **CDN**: AWS CloudFront (`Key-Pair-Id=K11RB80NFXU134`)
  341. - **ブラウザID クッキー**: `domand_bid` (アクセス権限 API 初回 POST 時に発行)
  343. ### 配信品質 (動画別に提供される)
  345. `x-access-right-key` JWT の `v` / `a` フィールドにライセンスされた品質が列挙され、初回 POST の `outputs` で video×audio の組み合わせを全部列挙して送ります。**品質ラベルと実解像度・コーデックは動画の元素材で異なる** ため、ラベルだけでは解像度を一意に決められません。実観測例：
  347. **古い動画 (sm9, 2007 年投稿) の場合**:
  349. | ラベル | 実解像度 | フレームレート | コーデック |
  350. |-------|---------|----------------|------------|
  351. | `video-h264-360p` | 320x240 | 29.970 | `avc1.4d401e` (H.264 Main L3.0) |
  352. | `video-h264-360p-lowest` | 480x360 | 29.970 | `avc1.42c01e` (H.264 Constrained Baseline L3.0) |
  353. | `audio-aac-128kbps` | - | - | `mp4a.40.2` (AAC-LC) |
  354. | `audio-aac-64kbps` | - | - | `mp4a.40.2` (AAC-LC) |
  356. (古い動画では品質ラベル名と実解像度が一致しないことに注意。`360p-lowest` の方が解像度が高い変則ケースが存在する。)
  358. **新しい動画 (sm46309015, 2026 年投稿) の場合**:
  360. | ラベル | 実解像度 | フレームレート | コーデック |
  361. |-------|---------|----------------|------------|
  362. | `video-h264-720p` | 1280x720 | 23.976 | `avc1.4d4020` (H.264 Main L3.2) |
  363. | `video-h264-480p` | 854x480 | 23.976 | `avc1.4d4020` (H.264 Main L3.2) |
  364. | `video-h264-360p` | 640x360 | 23.976 | `avc1.4d401e` (H.264 Main L3.0) |
  365. | `video-h264-144p` | 256x144 | 23.976 | `avc1.4d401e` (H.264 Main L3.0) |
  366. | `audio-aac-192kbps` | - | - | `mp4a.40.2` (AAC-LC) |
  367. | `audio-aac-64kbps` | - | - | `mp4a.40.2` (AAC-LC) |
  369. より高品質な動画では `video-h264-1080p` / `1440p` / `2160p` などのラベルも追加されます。
  371. ### HLS マスタープレイリスト構造
  373. ```
  374. #EXTM3U
  375. #EXT-X-VERSION:6
  376. #EXT-X-INDEPENDENT-SEGMENTS
  377. #EXT-X-MEDIA:TYPE=AUDIO,GROUP-ID="audio-aac-192kbps",NAME="Main Audio",DEFAULT=YES,URI="...audio-aac-192kbps.m3u8?..."
  378. #EXT-X-MEDIA:TYPE=AUDIO,GROUP-ID="audio-aac-64kbps",NAME="Main Audio",DEFAULT=YES,URI="...audio-aac-64kbps.m3u8?..."
  379. #EXT-X-STREAM-INF:BANDWIDTH=3101972,AVERAGE-BANDWIDTH=2261618,CODECS="avc1.4d4020,mp4a.40.2",RESOLUTION=1280x720,FRAME-RATE=23.976,AUDIO="audio-aac-192kbps"
  380. ...video-h264-720p.m3u8?...
  381. #EXT-X-STREAM-INF:BANDWIDTH=2905339,AVERAGE-BANDWIDTH=2078234,CODECS="avc1.4d4020,mp4a.40.2",RESOLUTION=1280x720,FRAME-RATE=23.976,AUDIO="audio-aac-64kbps"
  382. ...video-h264-720p.m3u8?...
  383. #EXT-X-STREAM-INF:BANDWIDTH=2580733,AVERAGE-BANDWIDTH=1863833,CODECS="avc1.4d4020,mp4a.40.2",RESOLUTION=854x480,FRAME-RATE=23.976,AUDIO="audio-aac-192kbps"
  384. ...video-h264-480p.m3u8?...
  385. #EXT-X-STREAM-INF:BANDWIDTH=1100355,AVERAGE-BANDWIDTH=856250,CODECS="avc1.4d401e,mp4a.40.2",RESOLUTION=640x360,FRAME-RATE=23.976,AUDIO="audio-aac-192kbps"
  386. ...video-h264-360p.m3u8?...
  387. #EXT-X-STREAM-INF:BANDWIDTH=475614,AVERAGE-BANDWIDTH=405103,CODECS="avc1.4d401e,mp4a.40.2",RESOLUTION=256x144,FRAME-RATE=23.976,AUDIO="audio-aac-192kbps"
  388. ...video-h264-144p.m3u8?...
  389. (以下、各 video variant の 64kbps 音声バージョン)
  390. ```
  392. ポイント:
  394. - **HLS v6**, `#EXT-X-INDEPENDENT-SEGMENTS` 指定。
  395. - 音声トラックは `#EXT-X-MEDIA` (TYPE=AUDIO) として別 m3u8 に分離 (旧 `128kbps` / `64kbps` の他、新しい動画では `192kbps` / `64kbps` 等)。
  396. - 動画 variant ごとに `#EXT-X-STREAM-INF` で別 m3u8 を参照し、`AUDIO=` で音声グループを指定する **多重化なし** の構成。video × audio の全組み合わせが variant として列挙される。
  397. - フレームレートは元素材依存 (sm9 では 29.970fps, sm46309015 では 23.976fps)。
  399. ### URLディレクトリ構造
  401. ```
  402. https://delivery.domand.nicovideo.jp/hlsbid/{bid}/
  403. ├── playlists/
  404. │ ├── variants/{variantId}.m3u8 # マスタープレイリスト
  405. │ └── media/
  406. │ ├── video-h264-360p.m3u8
  407. │ ├── video-h264-360p-lowest.m3u8
  408. │ ├── audio-aac-128kbps.m3u8
  409. │ └── audio-aac-64kbps.m3u8
  410. └── keys/
  411. ├── video-h264-360p.key
  412. ├── video-h264-360p-lowest.key
  413. ├── audio-aac-128kbps.key
  414. └── audio-aac-64kbps.key
  416. https://asset.domand.nicovideo.jp/{bid}/
  417. ├── video/{track_number}/{quality}/
  418. │ ├── init01.cmfv # CMAF 初期化セグメント
  419. │ ├── 01.cmfv # CMAF メディアセグメント
  420. │ ├── 02.cmfv
  421. │ └── ...
  422. └── audio/{track_number}/{quality}/
  423. ├── init01.cmfa
  424. ├── 01.cmfa
  425. └── ...
  426. ```
  428. `{track_number}` は同一品質内のトラック番号 (動画は通常 `1` または `12` のようにオフセットあり)。
  430. ### 暗号化
  432. HLS セグメントは **AES-128** で暗号化され、鍵 URL は variant の m3u8 から `#EXT-X-KEY` で参照されます。
  434. ### URL署名 (CloudFront)
  436. すべての URL に AWS CloudFront の署名が含まれます。マスタープレイリストは Custom Policy (Policy + Signature)、media playlist と key は Canned Policy (Expires + Signature) を使い分けています：
  438. ```
  439. # variants (Custom Policy: 当該リソースに長期間有効)
  440. ?session={session_id}&Policy={base64_policy}&Signature={signature}&Key-Pair-Id=K11RB80NFXU134
  442. # media playlists / keys / segments (Canned Policy)
  443. ?session={session_id}&Expires={epoch}&Signature={signature}&Key-Pair-Id=K11RB80NFXU134
  444. ```
  446. ---
  448. ## コメントシステム
  450. ### スレッド構造
  452. ニコニコのコメントは「スレッド」と「フォーク」で構成されています：
  454. | フォーク | 説明 |
  455. |---------|------|
  456. | `owner` | 投稿者コメント |
  457. | `main` | メインコメント |
  458. | `easy` | 簡易コメント（HTML5プレイヤー用） |
  460. ### コメントコマンド
  462. コメントには「コマンド」を適用できます：
  464. - `184` - 匿名希望（ユーザー ID をハッシュ化して投稿）
  465. - `ue` / `naka` / `shita` - 表示位置 (上寄せ / 中央 / 下寄せ)
  466. - `big` / `medium` / `small` - 文字サイズ
  467. - `ender` - 描画スタイル変更 (アンチエイリアス無効化系)
  468. - `gothic` / `mincho` / `defont` - フォント
  469. - `full` - 画面いっぱい (横スクロール無効化)
  470. - `#RRGGBB` または色名 (`red`, `blue` 等) - 色指定
  472. ### threadKey JWT
  474. `threadKey` は JWT (`HS512`) で構成されています。ヘッダーは `{"typ": "JWT", "alg": "HS512"}`。実観測したペイロード (未ログイン時)：
  476. ```json
  477. {
  478. "jti": "6a0b4c010f6af",
  479. "exp": 1779125729.06307,
  480. "typ": "Thread-Key",
  481. "d": 320,
  482. "tids": ["1173108780"],
  483. "f184s": []
  484. }
  485. ```
  487. | フィールド | 説明 |
  488. |----------|------|
  489. | `jti` | JWT ID |
  490. | `exp` | 有効期限 (浮動小数 Unix エポック秒) |
  491. | `typ` | トークン種別 (`Thread-Key`) |
  492. | `d` | 動画長 (秒) |
  493. | `tids` | 対象スレッドの ID 配列 |
  494. | `f184s` | 強制 184 (匿名) 対象スレッド ID 配列 |
  496. ログイン時には `uid` フィールド (ユーザー識別子) も追加されるが、未ログインのゲスト視聴では含まれない。
  498. ---
  500. ## 認証・セッション管理
  502. ### セッションクッキー
  504. 主な認証・配信用クッキー：
  506. | クッキー名 | ドメイン | 説明 |
  507. |------------|----------|------|
  508. | `nicosid` | `.nicovideo.jp` | セッションID |
  509. | `user_session` | `.nicovideo.jp` | ユーザーセッション (ログイン時) |
  510. | `domand_bid` | `.nicovideo.jp` | Domand ブラウザ ID (アクセス権限 API 初回呼び出し時に発行, HttpOnly, Secure) |
  512. ### 広告・トラッキング系クッキー
  514. ヘッダー入札や行動計測のために多数の 3rd party クッキーが書き込まれます (主要なもの):
  516. | クッキー名 | 提供元 |
  517. |------------|--------|
  518. | `_ga`, `_ga_*` | Google Analytics 4 (複数測定ID) |
  519. | `_gcl_au`, `__gads`, `__gpi`, `__eoi` | Google Ads / Ad Manager |
  520. | `_yjsu_yjad`, `_ly_su` | LINEヤフー |
  521. | `_tt_enable_cookie`, `_ttp`, `ttcsid*` | TikTok Pixel |
  522. | `_twpid` | Twitter (X) Pixel |
  523. | `_clck` | Microsoft Clarity |
  524. | `pbjs_sharedId` | Prebid.js Shared ID |
  525. | `_pubcid` | PubCommon ID |
  526. | `panoramaId` | LiveRamp Panorama |
  527. | `cto_bidid`, `cto_bundle` | Criteo |
  528. | `mgniSession` | Magnite (Rubicon) |
  529. | `_cc_id` | Lotame |
  531. ### LocalStorage
  533. ```javascript
  534. // コメント設定 (NG ユーザー等)
  535. localStorage['@nvweb-packages/comments:userng:v2']
  537. // 動画レンダラー設定 (ラウドネス情報を含む)
  538. localStorage['@nvweb-packages/video-renderer']
  540. // 視聴ページの UI 状態 (コメントリスト展開状態など)
  541. localStorage['nvpc:watch']
  543. // 視聴セッションのタブ間共有
  544. localStorage['nvpc:watch:tab-sessions']
  546. // イベント計測テスト
  547. localStorage['@nvweb-packages/watch-events:TEST_KEY']
  549. // 共通ヘッダーの掲出順制御
  550. localStorage['common-header-wktk-premium-lead-frames']
  551. localStorage['common-header-header-top-priority-period']
  553. // Magnite/Rubicon セッション
  554. localStorage['mgniSession']
  555. ```
  557. ### x-access-right-key JWT
  559. 動画配信APIで使用される JWT (`HS512`) ペイロード。実体に基づく正確なフィールド名：
  561. ```json
  562. {
  563. "jti": "6a0b4c0112fdc",
  564. "exp": 1779125849.0374729633331298828125,
  565. "typ": "Access-Right-Key",
  566. "vid": "sm9",
  567. "rid": "nicovideo-sm9",
  568. "fid": 6,
  569. "uid": "6-e3XFe1aMwH_1779125249007",
  570. "d": 320,
  571. "v": ["video-h264-360p", "video-h264-360p-lowest"],
  572. "a": ["audio-aac-128kbps", "audio-aac-64kbps"],
  573. "s": false,
  574. "sh": false
  575. }
  576. ```
  578. | フィールド | 説明 |
  579. |----------|------|
  580. | `jti` | JWT ID |
  581. | `exp` | 有効期限 (浮動小数 Unix エポック秒) |
  582. | `typ` | トークン種別 (`Access-Right-Key`) |
  583. | `vid` | 動画 ID |
  584. | `rid` | リソース ID (`nicovideo-{vid}` 形式) |
  585. | `fid` | フロントエンド ID (PC Web は `6`) |
  586. | `uid` | ユーザー識別子 (`{fid}-{actionTrackId}` 形式、未ログインでもセッション値) |
  587. | `d` | 動画長 (秒) |
  588. | `v` | 許可された動画品質ラベル配列 |
  589. | `a` | 許可された音声品質ラベル配列 |
  590. | `s` | (用途不明、観測値は `false`) |
  591. | `sh` | (用途不明、観測値は `false`) |
  593. ---
  595. ## 動画ギフト（投げ銭）システム
  597. `api.nicoad.nicovideo.jp/v1/nage_video/{id}/gift/effects` で取得可能。エフェクトアセットは `ir.cdn.nimg.jp/res/nage/common_effect/{effect_name}/asset_{effect_name}.json` で配信されます。主なエフェクト：
  599. `videogift_nicoru`, `videogift_kansha`, `videogift_8888`, `videogift_kami`, `videogift_kusa`, `videogift_upotsu`, `videogift_beer`, `videogift_mochi`, `videogift_makaron1`, `videogift_makaron2`, `videogift_ajisai_momo`, `videogift_xmaspresent`, `videogift_snow1`, `videogift_nengajyo2026`, `videogift_halloween_pumpkin4`, `videogift_matsuri`, `videogift_sticker`, `videogift_banner`, `videogift_bouquet`, `videogift_hoshiimono`, `videogift_premium_logo`, `videogift_premium_logo2`, `videogift_15kinen_densetsu`, `videogift_15kinen_card`, `videogift_fukidashi`, `videogift_saikou`, `videogift_kotonoha_gacha_daijoubu`, `videogift_yukari_omedetou`, `viddeogift_akari_a_moyashishamo` (typo そのまま), `videogift_nyanko_boss`, `videogift_nyanko_maneki`, `videogift_shunen_17_omedeto`.
  601. ---
  603. ## 開発に役立つ情報
  605. ### フロントエンド識別子
  607. | ヘッダー | 値 | 説明 |
  608. |---------|-----|------|
  609. | `x-frontend-id` | `6` | フロントエンドID (PC Web) |
  610. | `x-frontend-version` | `0` | フロントエンドバージョン |
  611. | `x-request-with` | `nicovideo` | リクエスト元識別 |
  612. | `x-niconico-language` | `ja-jp` | 言語 |
  613. | `x-client-os-type` | `others` | OS 種別 (コメントAPI で使用) |
  615. ### アクセス権限取得フロー
  617. 1. ページロード時に埋め込みデータから初期情報を取得 (Remix の `__remixContext`)。
  618. 2. `x-access-right-key` ヘッダー付きでアクセス権限 API を呼ぶ。最初は `?actionTrackId={id}` のみで `outputs` を全候補列挙し `201` を受領、`contentUrl` (実体URL) を取得。
  619. 3. レスポンスの `contentUrl` から HLS マスタープレイリスト (`variants/*.m3u8`) を取得。
  620. 4. プレイヤーが品質ごとの media playlist と AES-128 鍵を取得し、CMAF セグメントを順次ダウンロード。
  621. 5. 再生中は同じエンドポイントを `&__retry=0` 付きで再 POST し、`heartbeat` パラメータで状態 (再生時間, パフォーマンス計測, AI コメント可視性等) を送信。レスポンスは `200`。
  623. ### ストーリーボード (サムネイルシート)
  625. ```
  626. https://asset.domand.nicovideo.jp/{storyboard_bid}/storyboard/{track}/storyboard/
  627. ├── storyboard.json # メタデータ
  628. ├── 0001.jpg # サムネイル画像
  629. ├── 0002.jpg
  630. └── ...
  631. ```
  633. ### 広告配信スタック
  635. ニコニコ動画は多数の SSP/エクスチェンジを **Prebid.js** で同時に叩くヘッダー入札構成です：
  637. - **自社広告**: `ads.nicovideo.jp` (バナー), `ads.nicovideo.jp/api/video/getAd.json.php` (プリロール動画)
  638. - **Google**: Google Ad Manager / AdSense (`pagead2.googlesyndication.com`, `googleads.g.doubleclick.net`)
  639. - **Amazon**: TAM/UAM (`web-banner.ads.aps.amazon-adsystem.com`)
  640. - **Rubicon (Magnite)**: `fastlane.rubiconproject.com`, `prebid-server.rubiconproject.com`
  641. - **Index Exchange**: `htlb.casalemedia.com`
  642. - **OpenX**: `rtb.openx.net`
  643. - **PubMatic**: `hbopenbid.pubmatic.com`
  644. - **AppNexus (Xandr)**: `ib.adnxs.com`
  645. - **Media.net**: `prebid.media.net`
  646. - **Criteo**: `cto_*` クッキー経由
  647. - **MicroAd**: `s-rtb-pb.send.microad.jp`
  648. - **AdMatrix (AMoAd)**: `ad.as.amanad.adtdp.com`
  649. - **Fluct**: `hb.adingo.jp`
  650. - **United (ad-stir)**: `ad.ad-stir.com`
  651. - **CCI sociaDM**: `d.socdm.com`
  652. - **LINE Ads Platform**: `pb.ladsp.com`
  653. - **Yahoo!/LINE Impact**: `y.one.impact-ad.jp`
  654. - **ID プロバイダ**: LiveRamp (`api.rlcdn.com`), PubCommon, Prebid Shared ID
  656. ### 計測スタック
  658. - Google Analytics 4 (`G-FS29H4ZGX2`, `G-5LM4HED1NJ` 等)
  659. - Google Tag Manager (`GTM-PN8LFCT`, `GTM-KXT7G5G`)
  660. - 多数の Google Ads コンバージョン ID (`AW-11471143586`, `AW-11060698458`, `AW-469855517`, `AW-471708133`, `AW-691017027`, `AW-561674311`, `AW-607644388`, `AW-17911115346`, `AW-663701876`)
  661. - Yahoo! コンバージョン (`apm.yahoo.co.jp`)
  662. - TikTok Pixel (`analytics.tiktok.com`)
  663. - Twitter (X) Pixel (`static.ads-twitter.com`)
  664. - LINEヤフー LytagAd (`tag.flvcdn.net`)
  665. - Microsoft Clarity (`_clck`)
  667. ---
  669. *調査日: 2026年5月19日*
  670. *調査対象: https://www.nicovideo.jp/, https://www.nicovideo.jp/video_top, https://www.nicovideo.jp/watch/sm9*

関連ノート

ニコニコ動画 技術的詳細分析
@Kongyokongyo / 2026/05/18
現状僕が運用しているclaude md
コード設計の部分はお好みで
@Kongyokongyo / 2026/05/17
流出したclaude codeのソースコード8
@Kongyokongyo / 2026/04/19
流出したclaude codeのソースコード7
@Kongyokongyo / 2026/04/19
流出したclaude codeのソースコード6
@Kongyokongyo / 2026/04/19
流出したclaude codeのソースコード5
@Kongyokongyo / 2026/04/19
流出したclaude codeのソースコード4
@Kongyokongyo / 2026/04/19
流出したclaude codeのソースコード3
@Kongyokongyo / 2026/04/19
流出したclaude codeのソースコード2
@Kongyokongyo / 2026/04/19
流出したclaude codeのソースコード1
2mbに収まるように複数分割されてるのは悪しからず
@Kongyokongyo / 2026/04/19
最近追加されたノート